diff --git a/nova/conf/api.py b/nova/conf/api.py index 61760b47b7..8e6b9a0b30 100644 --- a/nova/conf/api.py +++ b/nova/conf/api.py @@ -64,6 +64,7 @@ Possible values: cfg.StrOpt("vendordata_driver", default="nova.api.metadata.vendordata_json.JsonFileVendorData", deprecated_for_removal=True, + deprecated_since="13.0.0", help=""" When returning instance metadata, this is the class that is used for getting vendor metadata when that class isn't specified in the individual @@ -278,6 +279,7 @@ fping_path_opts = [ os_network_opts = [ cfg.BoolOpt("enable_network_quota", deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason=""" CRUD operations on tenant networks are only available when using nova-network and nova-network is itself deprecated.""", @@ -311,6 +313,7 @@ Related options: """), cfg.IntOpt("quota_networks", deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason=""" CRUD operations on tenant networks are only available when using nova-network and nova-network is itself deprecated.""", diff --git a/nova/conf/cells.py b/nova/conf/cells.py index 62928a0f82..1602bf5e47 100644 --- a/nova/conf/cells.py +++ b/nova/conf/cells.py @@ -237,6 +237,7 @@ cell_manager_opts = [ cfg.StrOpt('driver', default='nova.cells.rpc_driver.CellsRPCDriver', deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason='The only available driver ' 'is the RPC driver.', help="""Cells communication driver diff --git a/nova/conf/cert.py b/nova/conf/cert.py index 9bc6cbc37b..3d8e010598 100644 --- a/nova/conf/cert.py +++ b/nova/conf/cert.py @@ -19,6 +19,7 @@ from oslo_config import cfg cert_opts = [ cfg.StrOpt("cert_topic", deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason=""" Since the nova-cert service is marked for deprecation, the feature to change RPC topic that cert nodes listen may be removed as early as the 15.0.0 diff --git a/nova/conf/compute.py b/nova/conf/compute.py index 8e9e64dee4..ef761224da 100644 --- a/nova/conf/compute.py +++ b/nova/conf/compute.py @@ -114,6 +114,7 @@ Possible values: """), 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.', @@ -174,6 +175,7 @@ Possible values: 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 @@ -700,8 +702,8 @@ Related options: cfg.StrOpt('snapshot_name_template', default='snapshot-%s', deprecated_for_removal=True, - deprecated_reason='This is not used anymore and will be ' - 'removed in the O release.', + deprecated_since='14.0.0', + deprecated_reason='This is not used anymore.', help='Template string to be used to generate snapshot names') ] diff --git a/nova/conf/conductor.py b/nova/conf/conductor.py index c2a1740d1e..83d075cf60 100644 --- a/nova/conf/conductor.py +++ b/nova/conf/conductor.py @@ -33,6 +33,7 @@ ALL_OPTS = [ 'use_local', default=False, deprecated_for_removal=True, + deprecated_since='13.0.0', help=""" Perform nova-conductor operations locally. This legacy mode was introduced to bridge a gap during the transition to the conductor service. @@ -51,6 +52,7 @@ Topic exchange name on which conductor nodes listen. 'manager', default='nova.conductor.manager.ConductorManager', deprecated_for_removal=True, + deprecated_since='13.0.0', help=""" Full class name for the Manager for conductor. diff --git a/nova/conf/database.py b/nova/conf/database.py index e839717da1..0f65ff4f66 100644 --- a/nova/conf/database.py +++ b/nova/conf/database.py @@ -28,8 +28,9 @@ _DEFAULT_SQL_CONNECTION = 'sqlite:///' + paths.state_path_def('nova.sqlite') db_driver_opt = cfg.StrOpt( 'db_driver', default='nova.db', - help='DEPRECATED: The driver to use for database access', - deprecated_for_removal=True) + deprecated_for_removal=True, + deprecated_since='13.0.0', + help='The driver to use for database access') # NOTE(markus_z): We cannot simply do: diff --git a/nova/conf/exceptions.py b/nova/conf/exceptions.py index 2f51672923..a5384a247d 100644 --- a/nova/conf/exceptions.py +++ b/nova/conf/exceptions.py @@ -19,6 +19,7 @@ exc_log_opts = [ cfg.BoolOpt('fatal_exception_format_errors', default=False, deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason="This is only used for internal testing.", help=""" When set to true, this option enables validation of exception diff --git a/nova/conf/flavors.py b/nova/conf/flavors.py index cb6627a4fe..be07399ec7 100644 --- a/nova/conf/flavors.py +++ b/nova/conf/flavors.py @@ -21,7 +21,8 @@ flavor_opts = [ "default_flavor", default="m1.small", deprecated_for_removal=True, - deprecated_reason="The EC2 API is deprecated", + deprecated_since="14.0.0", + deprecated_reason="The EC2 API is deprecated.", help=""" Default flavor to use for the EC2 API only. The Nova API does not support a default flavor. diff --git a/nova/conf/glance.py b/nova/conf/glance.py index e6586fd2d6..59a8a5effb 100644 --- a/nova/conf/glance.py +++ b/nova/conf/glance.py @@ -50,6 +50,10 @@ should be fully qualified urls of the form '[file].'), cfg.BoolOpt('use_glance_v1', default=False, + deprecated_for_removal=True, + deprecated_since="14.0.0", + deprecated_reason='Glance v1 support will be removed in ' + 'Ocata', help=""" This flag allows reverting to glance v1 if for some reason glance v2 doesn't work in your environment. This will only exist in Newton, and a fully working @@ -68,10 +72,7 @@ Glance v2 will be a hard requirement in Ocata. * Related options: None -""", - deprecated_for_removal=True, - deprecated_reason='Glance v1 support will be removed in ' - 'Ocata'), +"""), cfg.BoolOpt('verify_glance_signatures', default=False, help='Require Nova to perform signature verification on ' diff --git a/nova/conf/image_file_url.py b/nova/conf/image_file_url.py index cc1e2c8b72..caea34aee9 100644 --- a/nova/conf/image_file_url.py +++ b/nova/conf/image_file_url.py @@ -24,6 +24,7 @@ filesystems = cfg.ListOpt( name='filesystems', default=[], deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason=""" The feature to download images from glance via filesystem is not used and will be removed in the future. @@ -39,6 +40,7 @@ image_file_url: sections filesystem_opts = [ cfg.StrOpt('id', deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason=""" The feature to download images from glance via filesystem is not used and will be removed in the future. @@ -50,6 +52,7 @@ file system. """), cfg.StrOpt('mountpoint', deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason=""" The feature to download images from glance via filesystem is not used and will be removed in the future. diff --git a/nova/conf/ironic.py b/nova/conf/ironic.py index 5c4c0a14af..a790106bec 100644 --- a/nova/conf/ironic.py +++ b/nova/conf/ironic.py @@ -46,12 +46,14 @@ ironic_options = [ cfg.StrOpt( 'admin_username', deprecated_for_removal=True, + deprecated_since='14.0.0', help='Ironic keystone admin name. ' 'Use ``username`` instead.'), cfg.StrOpt( 'admin_password', secret=True, deprecated_for_removal=True, + deprecated_since='14.0.0', help='Ironic keystone admin password. ' 'Use ``password`` instead.'), cfg.StrOpt( diff --git a/nova/conf/key_manager.py b/nova/conf/key_manager.py index 9de5fa3c90..f5082727fc 100644 --- a/nova/conf/key_manager.py +++ b/nova/conf/key_manager.py @@ -42,6 +42,7 @@ barbican_opts = [ cfg.StrOpt("catalog_info", default="key-manager:barbican:public", deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason="This option have been moved to the " "Castellan library", help=""" @@ -51,6 +52,7 @@ catalog. Format is: separated values of the form: """), cfg.StrOpt("endpoint_template", deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason="This option have been moved to the " "Castellan library", help=""" @@ -60,6 +62,7 @@ http://localhost:9311/v1/%(project_id)s """), cfg.StrOpt("os_region_name", deprecated_for_removal=True, + deprecated_since="14.0.0", deprecated_reason="This option have been moved to the " "Castellan library", help='Region name of this node'), diff --git a/nova/conf/libvirt.py b/nova/conf/libvirt.py index 722f55069b..cb26732ad7 100644 --- a/nova/conf/libvirt.py +++ b/nova/conf/libvirt.py @@ -223,6 +223,7 @@ Related options: deprecated_for_removal=True, deprecated_reason="This option is being replaced by the " "'pointer_model' option.", + deprecated_since='14.0.0', help=""" Enable a mouse cursor within a graphical VNC or SPICE sessions. @@ -503,31 +504,34 @@ libvirt_imagecache_opts = [ cfg.StrOpt('image_info_filename_pattern', default='$instances_path/$image_cache_subdirectory_name/' '%(image)s.info', - help='Allows image information files to be stored in ' - 'non-standard locations', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='Image info files are no longer used by the ' - 'image cache'), + 'image cache', + help='Allows image information files to be stored in ' + 'non-standard locations'), cfg.IntOpt('remove_unused_resized_minimum_age_seconds', default=3600, help='Unused resized base images younger than this will not be ' 'removed'), cfg.BoolOpt('checksum_base_images', default=False, - help='Write a checksum for files in _base to disk', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='The image cache no longer periodically ' 'calculates checksums of stored images. ' 'Data integrity can be checked at the block ' - 'or filesystem level.'), + 'or filesystem level.', + help='Write a checksum for files in _base to disk'), cfg.IntOpt('checksum_interval_seconds', default=3600, - help='How frequently to checksum base images', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='The image cache no longer periodically ' 'calculates checksums of stored images. ' 'Data integrity can be checked at the block ' - 'or filesystem level.'), + 'or filesystem level.', + help='How frequently to checksum base images'), ] libvirt_lvm_opts = [ @@ -560,8 +564,8 @@ libvirt_volume_opts = [ 'from QEMU. Currently supported protocols: [gluster]'), cfg.BoolOpt('volume_use_multipath', default=False, - help='Use multipath connection of the iSCSI or FC volume', - deprecated_name='iscsi_use_multipath'), + deprecated_name='iscsi_use_multipath', + help='Use multipath connection of the iSCSI or FC volume') ] libvirt_volume_aoe_opts = [ diff --git a/nova/conf/network.py b/nova/conf/network.py index 60abeffcd9..d77f933188 100644 --- a/nova/conf/network.py +++ b/nova/conf/network.py @@ -370,6 +370,7 @@ Related options: cfg.BoolOpt("share_dhcp_address", default=False, deprecated_for_removal=True, + deprecated_since='2014.2', help=""" THIS VALUE SHOULD BE SET WHEN CREATING THE NETWORK. diff --git a/nova/conf/osapi_v21.py b/nova/conf/osapi_v21.py index f8d1521474..a54372429a 100644 --- a/nova/conf/osapi_v21.py +++ b/nova/conf/osapi_v21.py @@ -23,7 +23,7 @@ api_opts = [ cfg.ListOpt("extensions_blacklist", default=[], deprecated_for_removal=True, - deprecated_group="osapi_v21", + deprecated_since="12.0.0", help=""" This option is a list of all of the v2.1 API extensions to never load. However, it will be removed in the near future, after which all the functionality @@ -43,7 +43,7 @@ Related options: cfg.ListOpt("extensions_whitelist", default=[], deprecated_for_removal=True, - deprecated_group="osapi_v21", + deprecated_since="12.0.0", help=""" This is a list of extensions. If it is empty, then *all* extensions except those specified in the extensions_blacklist option will be loaded. If it is not @@ -64,7 +64,7 @@ Related options: """), cfg.StrOpt("project_id_regex", deprecated_for_removal=True, - deprecated_group="osapi_v21", + deprecated_since="13.0.0", help=""" This option is a string representing a regular expression (regex) that matches the project_id as contained in URLs. If not set, it will match normal UUIDs diff --git a/nova/conf/quota.py b/nova/conf/quota.py index 7c45faf5ff..2aa893af21 100644 --- a/nova/conf/quota.py +++ b/nova/conf/quota.py @@ -230,6 +230,7 @@ Possible values: cfg.StrOpt('quota_driver', default='nova.quota.DbQuotaDriver', deprecated_for_removal=True, + deprecated_since='14.0.0', help=""" Provides abstraction for quota checks. Users can configure a specific driver to use for quota checks. diff --git a/nova/conf/s3.py b/nova/conf/s3.py index 80a058d8fd..2be2246539 100644 --- a/nova/conf/s3.py +++ b/nova/conf/s3.py @@ -20,6 +20,7 @@ from oslo_config import cfg s3_opts = [ cfg.StrOpt('image_decryption_dir', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default='/tmp', help=""" @@ -27,6 +28,7 @@ Parent directory for tempdir used for image decryption """), cfg.StrOpt('s3_host', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default='$my_ip', help=""" @@ -34,6 +36,7 @@ Hostname or IP for OpenStack to use when accessing the S3 API """), cfg.PortOpt('s3_port', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default=3333, help=""" @@ -42,21 +45,25 @@ Port used when accessing the S3 API. It should be in the range of """), cfg.StrOpt('s3_access_key', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default='notchecked', help='Access key to use S3 server for images'), cfg.StrOpt('s3_secret_key', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default='notchecked', help='Secret key to use for S3 server for images'), cfg.BoolOpt('s3_use_ssl', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default=False, help='Whether to use SSL when talking to S3'), cfg.BoolOpt('s3_affix_tenant', deprecated_for_removal=True, + deprecated_since='14.0.0', deprecated_reason='EC2 API related options are not supported.', default=False, help=""" diff --git a/nova/conf/service.py b/nova/conf/service.py index 8880993ea4..06c2841279 100644 --- a/nova/conf/service.py +++ b/nova/conf/service.py @@ -126,6 +126,7 @@ Possible Values: cfg.StrOpt('metadata_manager', default='nova.api.manager.MetadataManager', deprecated_for_removal=True, + deprecated_since='13.0.0', help="Full class name for the service metadata manager."), cfg.StrOpt('metadata_listen', default="0.0.0.0", @@ -164,19 +165,23 @@ Possible Values: cfg.StrOpt('compute_manager', default='nova.compute.manager.ComputeManager', deprecated_for_removal=True, - help="Full class name for the Manager for compute"), + deprecated_since='13.0.0', + help='Full class name for the Manager for compute'), cfg.StrOpt('console_manager', default='nova.console.manager.ConsoleProxyManager', deprecated_for_removal=True, - help="Full class name for the Manager for console proxy"), + deprecated_since='13.0.0', + help='Full class name for the Manager for console proxy'), cfg.StrOpt('consoleauth_manager', default='nova.consoleauth.manager.ConsoleAuthManager', deprecated_for_removal=True, - help="Full clase name for the Manager for console auth"), + deprecated_since='13.0.0', + help='Full class name for the Manager for console auth'), cfg.StrOpt('cert_manager', default='nova.cert.manager.CertManager', deprecated_for_removal=True, - help="Full class name for the Manager for cert"), + deprecated_since='13.0.0', + help='Full class name for the Manager for cert'), # NOTE(sdague): the network_manager has a bunch of different in # tree classes that are still legit options. In Newton we should # turn this into a selector. @@ -187,12 +192,13 @@ Possible Values: 'nova.network.manager.VlanManager', ], default='nova.network.manager.VlanManager', - help="Full class name for the Manager for network"), + help='Full class name for the Manager for network'), cfg.StrOpt('scheduler_manager', default='nova.scheduler.manager.SchedulerManager', deprecated_for_removal=True, - help="Full class name for the Manager for scheduler"), -] + deprecated_since='13.0.0', + help='Full class name for the Manager for scheduler'), + ] def register_opts(conf):