Package ganeti :: Package config

Package config

Configuration management for Ganeti

This module provides the interface to the Ganeti cluster configuration.

The configuration data is stored on every node but is updated on the master only. After each update, the master distributes the data to the other nodes.

Currently, the data storage format is JSON. YAML was slow and consuming too much memory.

Submodules

[hide private]

ganeti.config.temporary_reservations: Reserve resources, so that jobs can't take them.
ganeti.config.utils: Utilities used by the config module.
ganeti.config.verify: Verification helpers for the configuration object.

Classes

[hide private]

ConfigWriter
The interface to the cluster configuration.

DetachedConfig
Read-only snapshot of the config.

Functions

[hide private]

GetWConfdContext(ec_id, livelock)
Prepare a context for communication with WConfd.

source code

ConfigWriter

GetConfig(ec_id, livelock, **kwargs)
A utility function for constructing instances of ConfigWriter.

source code

_MatchNameComponentIgnoreCase(short_name, names)
Wrapper around utils.text.MatchNameComponent.

source code

list of tuples; (int, string, string)

_CheckInstanceDiskIvNames(disks)
Checks if instance's disks' iv_name attributes are in order. source code

_UpdateIvNames(base_idx, disks)
Update the iv_name attribute of disks. source code

Variables

[hide private]

_UPGRADE_CONFIG_JID = "jid-cfg-upgrade"

Imports: copy, os, random, logging, time, threading, itertools, TemporaryReservationManager, ConfigSync, ConfigManager, VerifyType, VerifyNic, VerifyIpolicy, ValidateConfig, errors, utils, constants, wc, objects, serializer, uidpool, netutils, runtime, pathutils, network

Function Details

[hide private]

GetWConfdContext(ec_id, livelock)

source code

Prepare a context for communication with WConfd.

WConfd needs to know the identity of each caller to properly manage locks and detect job death. This helper function prepares the identity object given a job ID (optional) and a livelock file.

Parameters:

ec_id (int, or None) - the job ID or None, if the caller isn't a job
livelock (ganeti.utils.livelock.LiveLock) - a livelock object holding the lockfile needed for WConfd

Returns:

the WConfd context

GetConfig(ec_id, livelock, **kwargs)

source code

A utility function for constructing instances of ConfigWriter.

It prepares a WConfd context and uses it to create a ConfigWriter instance.

Parameters:

ec_id (int, or None) - the job ID or None, if the caller isn't a job
livelock (ganeti.utils.livelock.LiveLock) - a livelock object holding the lockfile needed for WConfd
kwargs (dict) - Any additional arguments for the ConfigWriter constructor

Returns: ConfigWriter

the ConfigWriter context

_CheckInstanceDiskIvNames(disks)

source code

Checks if instance's disks' iv_name attributes are in order.

Parameters:

disks (list of objects.Disk) - List of disks

Returns: list of tuples; (int, string, string)

List of wrongly named disks, each tuple contains disk index, expected and actual name

_UpdateIvNames(base_idx, disks)

source code

Update the iv_name attribute of disks.

Parameters:

disks (list of objects.Disk)