721 lines
25 KiB
Python
721 lines
25 KiB
Python
# needs:fix_opt_description
|
|
# needs:check_deprecation_status
|
|
# needs:check_opt_group_and_type
|
|
# needs:fix_opt_description_indentation
|
|
|
|
|
|
# Copyright 2015 Huawei Technology corp.
|
|
# Copyright 2015 OpenStack Foundation
|
|
# All Rights Reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
import socket
|
|
|
|
from oslo_config import cfg
|
|
|
|
from nova.conf import paths
|
|
|
|
compute_opts = [
|
|
cfg.BoolOpt('allow_resize_to_same_host',
|
|
default=False,
|
|
help="""
|
|
Allow destination machine to match source for resize. Useful when
|
|
testing in single-host environments. By default it is not allowed
|
|
to resize to the same host. Setting this option to true will add
|
|
the same host to the destination options.
|
|
"""),
|
|
cfg.StrOpt('default_schedule_zone',
|
|
help="""
|
|
Availability zone to use when user doesn't specify one.
|
|
|
|
This option is used by the scheduler to determine which availability
|
|
zone to place a new VM instance into if the user did not specify one
|
|
at the time of VM boot request.
|
|
|
|
Possible values:
|
|
|
|
* Any string representing an availability zone name
|
|
* Default value is None.
|
|
"""),
|
|
cfg.ListOpt('non_inheritable_image_properties',
|
|
default=['cache_in_nova', 'bittorrent'],
|
|
help="""
|
|
Image properties that should not be inherited from the instance
|
|
when taking a snapshot.
|
|
|
|
This option gives an opportunity to select which image-properties
|
|
should not be inherited by newly created snapshots.
|
|
|
|
Possible values:
|
|
|
|
* A list whose item is an image property. Usually only the image
|
|
properties that are only needed by base images can be included
|
|
here, since the snapshots that are created from the base images
|
|
doesn't need them.
|
|
* Default list: ['cache_in_nova', 'bittorrent']
|
|
"""),
|
|
# TODO(aunnam): This option needs to be deprecated
|
|
cfg.StrOpt('null_kernel',
|
|
default='nokernel',
|
|
help="""
|
|
This option is used to decide when an image should have no external
|
|
ramdisk or kernel. By default this is set to 'nokernel', so when an
|
|
image is booted with the property 'kernel_id' with the value
|
|
'nokernel', Nova assumes the image doesn't require an external kernel
|
|
and ramdisk.
|
|
"""),
|
|
# TODO(aunnam): This option needs to be deprecated
|
|
cfg.StrOpt('multi_instance_display_name_template',
|
|
default='%(name)s-%(count)d',
|
|
help="""
|
|
When creating multiple instances with a single request using the
|
|
os-multiple-create API extension, this template will be used to build
|
|
the display name for each instance. The benefit is that the instances
|
|
end up with different hostnames. Example display names when creating
|
|
two VM's: name-1, name-2.
|
|
|
|
Possible values:
|
|
|
|
* Valid keys for the template are: name, uuid, count.
|
|
"""),
|
|
cfg.IntOpt('max_local_block_devices',
|
|
default=3,
|
|
help="""
|
|
Maximum number of devices that will result in a local image being
|
|
created on the hypervisor node.
|
|
|
|
A negative number means unlimited. Setting max_local_block_devices
|
|
to 0 means that any request that attempts to create a local disk
|
|
will fail. This option is meant to limit the number of local discs
|
|
(so root local disc that is the result of --image being used, and
|
|
any other ephemeral and swap disks). 0 does not mean that images
|
|
will be automatically converted to volumes and boot instances from
|
|
volumes - it just means that all requests that attempt to create a
|
|
local disk will fail.
|
|
|
|
Possible values:
|
|
|
|
* 0: Creating a local disk is not allowed.
|
|
* Negative number: Allows unlimited number of local discs.
|
|
* Positive number: Allows only these many number of local discs.
|
|
(Default value is 3).
|
|
"""),
|
|
cfg.MultiStrOpt('compute_available_monitors',
|
|
deprecated_for_removal=True,
|
|
deprecated_since='12.0.0',
|
|
deprecated_reason="""
|
|
stevedore and setuptools entry points now allow a set of plugins to be
|
|
specified without this config option.""",
|
|
help="""
|
|
Monitor classes available to the compute which may be specified more than once.
|
|
This option is DEPRECATED and no longer used. Use setuptools entry points to
|
|
list available monitor plugins.
|
|
"""),
|
|
cfg.ListOpt('compute_monitors',
|
|
default=[],
|
|
help="""
|
|
A list of monitors that can be used for getting compute metrics.
|
|
You can use the alias/name from the setuptools entry points for
|
|
nova.compute.monitors.* namespaces. If no namespace is supplied,
|
|
the "cpu." namespace is assumed for backwards-compatibility.
|
|
|
|
Possible values:
|
|
|
|
* An empty list will disable the feature(Default).
|
|
* An example value that would enable both the CPU and NUMA memory
|
|
bandwidth monitors that used the virt driver variant:
|
|
["cpu.virt_driver", "numa_mem_bw.virt_driver"]
|
|
""")
|
|
]
|
|
|
|
resource_tracker_opts = [
|
|
cfg.IntOpt('reserved_host_disk_mb',
|
|
min=0,
|
|
default=0,
|
|
help="""
|
|
Amount of disk resources in MB to make them always available to host. The
|
|
disk usage gets reported back to the scheduler from nova-compute running
|
|
on the compute nodes. To prevent the disk resources from being considered
|
|
as available, this option can be used to reserve disk space for that host.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer representing amount of disk in MB to reserve
|
|
for the host.
|
|
"""),
|
|
cfg.IntOpt('reserved_host_memory_mb',
|
|
default=512,
|
|
min=0,
|
|
help="""
|
|
Amount of memory in MB to reserve for the host so that it is always available
|
|
to host processes. The host resources usage is reported back to the scheduler
|
|
continuously from nova-compute running on the compute node. To prevent the host
|
|
memory from being considered as available, this option is used to reserve
|
|
memory for the host.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer representing amount of memory in MB to reserve
|
|
for the host.
|
|
"""),
|
|
cfg.StrOpt('compute_stats_class',
|
|
default='nova.compute.stats.Stats',
|
|
deprecated_for_removal=True,
|
|
deprecated_since='13.0.0',
|
|
help="""
|
|
Abstracts out managing compute host stats to pluggable class. This class
|
|
manages and updates stats for the local compute host after an instance
|
|
is changed. These configurable compute stats may be useful for a
|
|
particular scheduler implementation.
|
|
|
|
Possible values
|
|
|
|
* A string representing fully qualified class name.
|
|
"""),
|
|
]
|
|
|
|
allocation_ratio_opts = [
|
|
# TODO(sfinucan): Add min parameter
|
|
cfg.FloatOpt('cpu_allocation_ratio',
|
|
default=0.0,
|
|
help="""
|
|
This option helps you specify virtual CPU to physical CPU allocation
|
|
ratio which affects all CPU filters.
|
|
|
|
This configuration specifies ratio for CoreFilter which can be set
|
|
per compute node. For AggregateCoreFilter, it will fall back to this
|
|
configuration value if no per-aggregate setting is found.
|
|
|
|
NOTE: This can be set per-compute, or if set to 0.0, the value
|
|
set on the scheduler node(s) or compute node(s) will be used
|
|
and defaulted to 16.0'.
|
|
|
|
Possible values:
|
|
|
|
* Any valid positive integer or float value
|
|
"""),
|
|
# TODO(sfinucan): Add min parameter
|
|
cfg.FloatOpt('ram_allocation_ratio',
|
|
default=0.0,
|
|
help="""
|
|
This option helps you specify virtual RAM to physical RAM
|
|
allocation ratio which affects all RAM filters.
|
|
|
|
This configuration specifies ratio for RamFilter which can be set
|
|
per compute node. For AggregateRamFilter, it will fall back to this
|
|
configuration value if no per-aggregate setting found.
|
|
|
|
NOTE: This can be set per-compute, or if set to 0.0, the value
|
|
set on the scheduler node(s) or compute node(s) will be used and
|
|
defaulted to 1.5.
|
|
|
|
Possible values:
|
|
|
|
* Any valid positive integer or float value
|
|
"""),
|
|
# TODO(sfinucan): Add min parameter
|
|
cfg.FloatOpt('disk_allocation_ratio',
|
|
default=0.0,
|
|
help="""
|
|
This option helps you specify virtual disk to physical disk
|
|
allocation ratio used by the disk_filter.py script to determine if
|
|
a host has sufficient disk space to fit a requested instance.
|
|
|
|
A ratio greater than 1.0 will result in over-subscription of the
|
|
available physical disk, which can be useful for more
|
|
efficiently packing instances created with images that do not
|
|
use the entire virtual disk, such as sparse or compressed
|
|
images. It can be set to a value between 0.0 and 1.0 in order
|
|
to preserve a percentage of the disk for uses other than
|
|
instances.
|
|
|
|
NOTE: This can be set per-compute, or if set to 0.0, the value
|
|
set on the scheduler node(s) or compute node(s) will be used and
|
|
defaulted to 1.0'.
|
|
|
|
Possible values:
|
|
|
|
* Any valid positive integer or float value
|
|
""")
|
|
]
|
|
|
|
compute_manager_opts = [
|
|
cfg.StrOpt('console_host',
|
|
default=socket.gethostname(),
|
|
sample_default="socket.gethostname()",
|
|
help="""
|
|
Console proxy host to be used to connect to instances on this host. It is the
|
|
publicly visible name for the console host.
|
|
|
|
Possible values:
|
|
|
|
* Current hostname (default) or any string representing hostname.
|
|
"""),
|
|
cfg.StrOpt('default_access_ip_network_name',
|
|
help="""
|
|
Name of the network to be used to set access IPs for instances. If there are
|
|
multiple IPs to choose from, an arbitrary one will be chosen.
|
|
|
|
Possible values:
|
|
|
|
* None (default)
|
|
* Any string representing network name.
|
|
"""),
|
|
cfg.BoolOpt('defer_iptables_apply',
|
|
default=False,
|
|
help="""
|
|
Whether to batch up the application of IPTables rules during a host restart
|
|
and apply all at the end of the init phase.
|
|
"""),
|
|
cfg.StrOpt('instances_path',
|
|
default=paths.state_path_def('instances'),
|
|
sample_default="$state_path/instances",
|
|
help="""
|
|
Specifies where instances are stored on the hypervisor's disk.
|
|
It can point to locally attached storage or a directory on NFS.
|
|
|
|
Possible values:
|
|
|
|
* $state_path/instances where state_path is a config option that specifies
|
|
the top-level directory for maintaining nova's state. (default) or
|
|
Any string representing directory path.
|
|
"""),
|
|
cfg.BoolOpt('instance_usage_audit',
|
|
default=False,
|
|
help="""
|
|
This option enables periodic compute.instance.exists notifications. Each
|
|
compute node must be configured to generate system usage data. These
|
|
notifications are consumed by OpenStack Telemetry service.
|
|
"""),
|
|
cfg.IntOpt('live_migration_retry_count',
|
|
default=30,
|
|
min=0,
|
|
help="""
|
|
Maximum number of 1 second retries in live_migration. It specifies number
|
|
of retries to iptables when it complains. It happens when an user continously
|
|
sends live-migration request to same host leading to concurrent request
|
|
to iptables.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer representing retry count.
|
|
"""),
|
|
cfg.BoolOpt('resume_guests_state_on_host_boot',
|
|
default=False,
|
|
help="""
|
|
This option specifies whether to start guests that were running before the
|
|
host rebooted. It ensures that all of the instances on a Nova compute node
|
|
resume their state each time the compute node boots or restarts.
|
|
"""),
|
|
cfg.IntOpt('network_allocate_retries',
|
|
default=0,
|
|
min=0,
|
|
help="""
|
|
Number of times to retry network allocation. It is required to attempt network
|
|
allocation retries if the virtual interface plug fails.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer representing retry count.
|
|
"""),
|
|
cfg.IntOpt('max_concurrent_builds',
|
|
default=10,
|
|
min=0,
|
|
help="""
|
|
Limits the maximum number of instance builds to run concurrently by
|
|
nova-compute. Compute service can attempt to build an infinite number of
|
|
instances, if asked to do so. This limit is enforced to avoid building
|
|
unlimited instance concurrently on a compute node. This value can be set
|
|
per compute node.
|
|
|
|
Possible Values:
|
|
|
|
* 0 : treated as unlimited.
|
|
* Any positive integer representing maximum concurrent builds.
|
|
"""),
|
|
# TODO(sfinucan): Add min parameter
|
|
cfg.IntOpt('max_concurrent_live_migrations',
|
|
default=1,
|
|
help="""
|
|
Maximum number of live migrations to run concurrently. This limit is enforced
|
|
to avoid outbound live migrations overwhelming the host/network and causing
|
|
failures. It is not recommended that you change this unless you are very sure
|
|
that doing so is safe and stable in your environment.
|
|
|
|
Possible values:
|
|
|
|
* 0 : treated as unlimited.
|
|
* Negative value defaults to 0.
|
|
* Any positive integer representing maximum number of live migrations
|
|
to run concurrently.
|
|
"""),
|
|
cfg.IntOpt('block_device_allocate_retries',
|
|
default=60,
|
|
help="""
|
|
Number of times to retry block device allocation on failures. Starting with
|
|
Liberty, Cinder can use image volume cache. This may help with block device
|
|
allocation performance. Look at the cinder image_volume_cache_enabled
|
|
configuration option.
|
|
|
|
Possible values:
|
|
|
|
* 60 (default)
|
|
* If value is 0, then one attempt is made.
|
|
* Any negative value is treated as 0.
|
|
* For any value > 0, total attempts are (value + 1)
|
|
"""),
|
|
cfg.IntOpt('sync_power_state_pool_size',
|
|
default=1000,
|
|
help="""
|
|
Number of greenthreads available for use to sync power states.
|
|
|
|
This option can be used to reduce the number of concurrent requests
|
|
made to the hypervisor or system with real instance power states
|
|
for performance reasons, for example, with Ironic.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer representing greenthreads count.
|
|
""")
|
|
]
|
|
|
|
interval_opts = [
|
|
cfg.IntOpt('bandwidth_poll_interval',
|
|
default=600,
|
|
help='Interval to pull network bandwidth usage info. Not '
|
|
'supported on all hypervisors. Set to -1 to disable. '
|
|
'Setting this to 0 will run at the default rate.'),
|
|
cfg.IntOpt('sync_power_state_interval',
|
|
default=600,
|
|
help='Interval to sync power states between the database and '
|
|
'the hypervisor. Set to -1 to disable. '
|
|
'Setting this to 0 will run at the default rate.'),
|
|
cfg.IntOpt("heal_instance_info_cache_interval",
|
|
default=60,
|
|
help="Number of seconds between instance network information "
|
|
"cache updates"),
|
|
cfg.IntOpt('reclaim_instance_interval',
|
|
min=0,
|
|
default=0,
|
|
help='Interval in seconds for reclaiming deleted instances. '
|
|
'It takes effect only when value is greater than 0.'),
|
|
cfg.IntOpt('volume_usage_poll_interval',
|
|
default=0,
|
|
help='Interval in seconds for gathering volume usages'),
|
|
cfg.IntOpt('shelved_poll_interval',
|
|
default=3600,
|
|
help='Interval in seconds for polling shelved instances to '
|
|
'offload. Set to -1 to disable.'
|
|
'Setting this to 0 will run at the default rate.'),
|
|
cfg.IntOpt('shelved_offload_time',
|
|
default=0,
|
|
help='Time in seconds before a shelved instance is eligible '
|
|
'for removing from a host. -1 never offload, 0 offload '
|
|
'immediately when shelved'),
|
|
cfg.IntOpt('instance_delete_interval',
|
|
default=300,
|
|
help='Interval in seconds for retrying failed instance file '
|
|
'deletes. Set to -1 to disable. '
|
|
'Setting this to 0 will run at the default rate.'),
|
|
cfg.IntOpt('block_device_allocate_retries_interval',
|
|
default=3,
|
|
help='Waiting time interval (seconds) between block'
|
|
' device allocation retries on failures'),
|
|
cfg.IntOpt('scheduler_instance_sync_interval',
|
|
default=120,
|
|
help='Waiting time interval (seconds) between sending the '
|
|
'scheduler a list of current instance UUIDs to verify '
|
|
'that its view of instances is in sync with nova. If the '
|
|
'CONF option `filter_scheduler.track_instance_changes` is '
|
|
'False, changing this option will have no effect.'),
|
|
cfg.IntOpt('update_resources_interval',
|
|
default=0,
|
|
help='Interval in seconds for updating compute resources. A '
|
|
'number less than 0 means to disable the task completely. '
|
|
'Leaving this at the default of 0 will cause this to run '
|
|
'at the default periodic interval. Setting it to any '
|
|
'positive value will cause it to run at approximately '
|
|
'that number of seconds.'),
|
|
]
|
|
|
|
timeout_opts = [
|
|
cfg.IntOpt("reboot_timeout",
|
|
default=0,
|
|
min=0,
|
|
help="""
|
|
Time interval after which an instance is hard rebooted automatically.
|
|
|
|
When doing a soft reboot, it is possible that a guest kernel is
|
|
completely hung in a way that causes the soft reboot task
|
|
to not ever finish. Setting this option to a time period in seconds
|
|
will automatically hard reboot an instance if it has been stuck
|
|
in a rebooting state longer than N seconds.
|
|
|
|
Possible values:
|
|
|
|
* 0: Disables the option (default).
|
|
* Any positive integer in seconds: Enables the option.
|
|
"""),
|
|
cfg.IntOpt("instance_build_timeout",
|
|
default=0,
|
|
min=0,
|
|
help="""
|
|
Maximum time in seconds that an instance can take to build.
|
|
|
|
If this timer expires, instance status will be changed to ERROR.
|
|
Enabling this option will make sure an instance will not be stuck
|
|
in BUILD state for a longer period.
|
|
|
|
Possible values:
|
|
|
|
* 0: Disables the option (default)
|
|
* Any positive integer in seconds: Enables the option.
|
|
"""),
|
|
cfg.IntOpt("rescue_timeout",
|
|
default=0,
|
|
min=0,
|
|
help="""
|
|
Interval to wait before un-rescuing an instance stuck in RESCUE.
|
|
|
|
Possible values:
|
|
|
|
* 0: Disables the option (default)
|
|
* Any positive integer in seconds: Enables the option.
|
|
"""),
|
|
cfg.IntOpt("resize_confirm_window",
|
|
default=0,
|
|
min=0,
|
|
help="""
|
|
Automatically confirm resizes after N seconds.
|
|
|
|
Resize functionality will save the existing server before resizing.
|
|
After the resize completes, user is requested to confirm the resize.
|
|
The user has the opportunity to either confirm or revert all
|
|
changes. Confirm resize removes the original server and changes
|
|
server status from resized to active. Setting this option to a time
|
|
period (in seconds) will automatically confirm the resize if the
|
|
server is in resized state longer than that time.
|
|
|
|
Possible values:
|
|
|
|
* 0: Disables the option (default)
|
|
* Any positive integer in seconds: Enables the option.
|
|
"""),
|
|
cfg.IntOpt("shutdown_timeout",
|
|
default=60,
|
|
min=1,
|
|
help="""
|
|
Total time to wait in seconds for an instance toperform a clean
|
|
shutdown.
|
|
|
|
It determines the overall period (in seconds) a VM is allowed to
|
|
perform a clean shutdown. While performing stop, rescue and shelve,
|
|
rebuild operations, configuring this option gives the VM a chance
|
|
to perform a controlled shutdown before the instance is powered off.
|
|
The default timeout is 60 seconds.
|
|
|
|
The timeout value can be overridden on a per image basis by means
|
|
of os_shutdown_timeout that is an image metadata setting allowing
|
|
different types of operating systems to specify how much time they
|
|
need to shut down cleanly.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer in seconds (default value is 60).
|
|
""")
|
|
]
|
|
|
|
running_deleted_opts = [
|
|
cfg.StrOpt("running_deleted_instance_action",
|
|
default="reap",
|
|
choices=('noop', 'log', 'shutdown', 'reap'),
|
|
help="""
|
|
The compute service periodically checks for instances that have been
|
|
deleted in the database but remain running on the compute node. The
|
|
above option enables action to be taken when such instances are
|
|
identified.
|
|
|
|
Possible values:
|
|
|
|
* reap: Powers down the instances and deletes them(default)
|
|
* log: Logs warning message about deletion of the resource
|
|
* shutdown: Powers down instances and marks them as non-
|
|
bootable which can be later used for debugging/analysis
|
|
* noop: Takes no action
|
|
|
|
Related options:
|
|
|
|
* running_deleted_instance_poll
|
|
* running_deleted_instance_timeout
|
|
"""),
|
|
cfg.IntOpt("running_deleted_instance_poll_interval",
|
|
default=1800,
|
|
help="""
|
|
Time interval in seconds to wait between runs for the clean up action.
|
|
If set to 0, above check will be disabled. If "running_deleted_instance
|
|
_action" is set to "log" or "reap", a value greater than 0 must be set.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer in seconds enables the option.
|
|
* 0: Disables the option.
|
|
* 1800: Default value.
|
|
|
|
Related options:
|
|
|
|
* running_deleted_instance_action
|
|
"""),
|
|
cfg.IntOpt("running_deleted_instance_timeout",
|
|
default=0,
|
|
help="""
|
|
Time interval in seconds to wait for the instances that have
|
|
been marked as deleted in database to be eligible for cleanup.
|
|
|
|
Possible values:
|
|
|
|
* Any positive integer in seconds(default is 0).
|
|
|
|
Related options:
|
|
|
|
* "running_deleted_instance_action"
|
|
"""),
|
|
]
|
|
|
|
instance_cleaning_opts = [
|
|
cfg.IntOpt('maximum_instance_delete_attempts',
|
|
default=5,
|
|
help='The number of times to attempt to reap an instance\'s '
|
|
'files.'),
|
|
]
|
|
|
|
rpcapi_opts = [
|
|
cfg.StrOpt("compute_topic",
|
|
default="compute",
|
|
deprecated_for_removal=True,
|
|
deprecated_since="15.0.0",
|
|
deprecated_reason="""
|
|
There is no need to let users choose the RPC topic for all services - there
|
|
is little gain from this. Furthermore, it makes it really easy to break Nova
|
|
by using this option.
|
|
""",
|
|
help="""
|
|
This is the message queue topic that the compute service 'listens' on. It is
|
|
used when the compute service is started up to configure the queue, and
|
|
whenever an RPC call to the compute service is made.
|
|
|
|
Possible values:
|
|
|
|
* Any string, but there is almost never any reason to ever change this value
|
|
from its default of 'compute'.
|
|
"""),
|
|
]
|
|
|
|
db_opts = [
|
|
cfg.StrOpt('osapi_compute_unique_server_name_scope',
|
|
default='',
|
|
choices=['', 'project', 'global'],
|
|
help="""
|
|
Sets the scope of the check for unique instance names.
|
|
|
|
The default doesn't check for unique names. If a scope for the name check is
|
|
set, a launch of a new instance or an update of an existing instance with a
|
|
duplicate name will result in an ''InstanceExists'' error. The uniqueness is
|
|
case-insensitive. Setting this option can increase the usability for end
|
|
users as they don't have to distinguish among instances with the same name
|
|
by their IDs.
|
|
|
|
Possible values:
|
|
|
|
* '': An empty value means that no uniqueness check is done and duplicate
|
|
names are possible.
|
|
* "project": The instance name check is done only for instances within the
|
|
same project.
|
|
* "global": The instance name check is done for all instances regardless of
|
|
the project.
|
|
"""),
|
|
cfg.BoolOpt('enable_new_services',
|
|
default=True,
|
|
help="""
|
|
Enable new services on this host automatically.
|
|
|
|
When a new service (for example "nova-compute") starts up, it gets
|
|
registered in the database as an enabled service. Sometimes it can be useful
|
|
to register new services in disabled state and then enabled them at a later
|
|
point in time. This option can set this behavior for all services per host.
|
|
|
|
Possible values:
|
|
|
|
* ``True``: Each new service is enabled as soon as it registers itself.
|
|
* ``False``: Services must be enabled via a REST API call or with the CLI
|
|
with ``nova service-enable <hostname> <binary>``, otherwise they are not
|
|
ready to use.
|
|
"""),
|
|
cfg.StrOpt('instance_name_template',
|
|
default='instance-%08x',
|
|
help="""
|
|
Template string to be used to generate instance names.
|
|
|
|
This template controls the creation of the database name of an instance. This
|
|
is *not* the display name you enter when creating an instance (via Horizon
|
|
or CLI). For a new deployment it is advisable to change the default value
|
|
(which uses the database autoincrement) to another value which makes use
|
|
of the attributes of an instance, like ``instance-%(uuid)s``. If you
|
|
already have instances in your deployment when you change this, your
|
|
deployment will break.
|
|
|
|
Possible values:
|
|
|
|
* A string which either uses the instance database ID (like the
|
|
default)
|
|
* A string with a list of named database columns, for example ``%(id)d``
|
|
or ``%(uuid)s`` or ``%(hostname)s``.
|
|
|
|
Related options:
|
|
|
|
* not to be confused with: ``multi_instance_display_name_template``
|
|
"""),
|
|
# TODO(markus_z): 2016-04-04: This is not used anymore. The class
|
|
# "models.Snapshot" uses it but this class is not used anymore.
|
|
# This class got introduced with commit 0ba0859 but all calls
|
|
# to it got removed with commit 5d197cb. This cleanup must
|
|
# have missed the class "models.Snapshot" and a new change
|
|
# should remove it completely.
|
|
cfg.StrOpt('snapshot_name_template',
|
|
default='snapshot-%s',
|
|
deprecated_for_removal=True,
|
|
deprecated_since='14.0.0',
|
|
deprecated_reason='This is not used anymore.',
|
|
help='Template string to be used to generate snapshot names')
|
|
]
|
|
|
|
|
|
ALL_OPTS = (compute_opts +
|
|
resource_tracker_opts +
|
|
allocation_ratio_opts +
|
|
compute_manager_opts +
|
|
interval_opts +
|
|
timeout_opts +
|
|
running_deleted_opts +
|
|
instance_cleaning_opts +
|
|
rpcapi_opts +
|
|
db_opts)
|
|
|
|
|
|
def register_opts(conf):
|
|
conf.register_opts(ALL_OPTS)
|
|
|
|
|
|
def list_opts():
|
|
return {'DEFAULT': ALL_OPTS}
|