Advertisement
Guest User

Untitled

a guest
Sep 11th, 2024
35
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 208.86 KB | None | 0 0
  1. [DEFAULT]
  2.  
  3. #
  4. # From glance.api
  5. #
  6.  
  7. #
  8. # Allow limited access to unauthenticated users.
  9. #
  10. # Assign a boolean to determine API access for unauthenticated
  11. # users. When set to False, the API cannot be accessed by
  12. # unauthenticated users. When set to True, unauthenticated users can
  13. # access the API with read-only privileges. This however only applies
  14. # when using ContextMiddleware.
  15. #
  16. # Possible values:
  17. # * True
  18. # * False
  19. #
  20. # Related options:
  21. # * None
  22. #
  23. # (boolean value)
  24. #allow_anonymous_access = false
  25.  
  26. #
  27. # Limit the request ID length.
  28. #
  29. # Provide an integer value to limit the length of the request ID to
  30. # the specified length. The default value is 64. Users can change this
  31. # to any ineteger value between 0 and 16384 however keeping in mind that
  32. # a larger value may flood the logs.
  33. #
  34. # Possible values:
  35. # * Integer value between 0 and 16384
  36. #
  37. # Related options:
  38. # * None
  39. #
  40. # (integer value)
  41. # Minimum value: 0
  42. #max_request_id_length = 64
  43.  
  44. #
  45. # Public url endpoint to use for Glance versions response.
  46. #
  47. # This is the public url endpoint that will appear in the Glance
  48. # "versions" response. If no value is specified, the endpoint that is
  49. # displayed in the version's response is that of the host running the
  50. # API service. Change the endpoint to represent the proxy URL if the
  51. # API service is running behind a proxy. If the service is running
  52. # behind a load balancer, add the load balancer's URL for this value.
  53. #
  54. # Possible values:
  55. # * None
  56. # * Proxy URL
  57. # * Load balancer URL
  58. #
  59. # Related options:
  60. # * None
  61. #
  62. # (string value)
  63. #public_endpoint = <None>
  64.  
  65. # DEPRECATED:
  66. # Allow users to add additional/custom properties to images.
  67. #
  68. # Glance defines a standard set of properties (in its schema) that
  69. # appear on every image. These properties are also known as
  70. # ``base properties``. In addition to these properties, Glance
  71. # allows users to add custom properties to images. These are known
  72. # as ``additional properties``.
  73. #
  74. # By default, this configuration option is set to ``True`` and users
  75. # are allowed to add additional properties. The number of additional
  76. # properties that can be added to an image can be controlled via
  77. # ``image_property_quota`` configuration option.
  78. #
  79. # Possible values:
  80. # * True
  81. # * False
  82. #
  83. # Related options:
  84. # * image_property_quota
  85. #
  86. # (boolean value)
  87. # This option is deprecated for removal since Ussuri.
  88. # Its value may be silently ignored in the future.
  89. # Reason:
  90. # This option is redundant. Control custom image property usage via the
  91. # 'image_property_quota' configuration option. This option is scheduled
  92. # to be removed during the Victoria development cycle.
  93. #allow_additional_image_properties = true
  94.  
  95. #
  96. # Secure hashing algorithm used for computing the 'os_hash_value' property.
  97. #
  98. # This option configures the Glance "multihash", which consists of two
  99. # image properties: the 'os_hash_algo' and the 'os_hash_value'. The
  100. # 'os_hash_algo' will be populated by the value of this configuration
  101. # option, and the 'os_hash_value' will be populated by the hexdigest computed
  102. # when the algorithm is applied to the uploaded or imported image data.
  103. #
  104. # The value must be a valid secure hash algorithm name recognized by the
  105. # python 'hashlib' library. You can determine what these are by examining
  106. # the 'hashlib.algorithms_available' data member of the version of the
  107. # library being used in your Glance installation. For interoperability
  108. # purposes, however, we recommend that you use the set of secure hash
  109. # names supplied by the 'hashlib.algorithms_guaranteed' data member because
  110. # those algorithms are guaranteed to be supported by the 'hashlib' library
  111. # on all platforms. Thus, any image consumer using 'hashlib' locally should
  112. # be able to verify the 'os_hash_value' of the image.
  113. #
  114. # The default value of 'sha512' is a performant secure hash algorithm.
  115. #
  116. # If this option is misconfigured, any attempts to store image data will fail.
  117. # For that reason, we recommend using the default value.
  118. #
  119. # Possible values:
  120. # * Any secure hash algorithm name recognized by the Python 'hashlib'
  121. # library
  122. #
  123. # Related options:
  124. # * None
  125. #
  126. # (string value)
  127. #hashing_algorithm = sha512
  128.  
  129. #
  130. # Maximum number of image members per image.
  131. #
  132. # This limits the maximum of users an image can be shared with. Any negative
  133. # value is interpreted as unlimited.
  134. #
  135. # Related options:
  136. # * None
  137. #
  138. # (integer value)
  139. #image_member_quota = 128
  140.  
  141. #
  142. # Maximum number of properties allowed on an image.
  143. #
  144. # This enforces an upper limit on the number of additional properties an image
  145. # can have. Any negative value is interpreted as unlimited.
  146. #
  147. # NOTE: This won't have any impact if additional properties are disabled. Please
  148. # refer to ``allow_additional_image_properties``.
  149. #
  150. # Related options:
  151. # * ``allow_additional_image_properties``
  152. #
  153. # (integer value)
  154. #image_property_quota = 128
  155.  
  156. #
  157. # Maximum number of tags allowed on an image.
  158. #
  159. # Any negative value is interpreted as unlimited.
  160. #
  161. # Related options:
  162. # * None
  163. #
  164. # (integer value)
  165. #image_tag_quota = 128
  166.  
  167. #
  168. # Maximum number of locations allowed on an image.
  169. #
  170. # Any negative value is interpreted as unlimited.
  171. #
  172. # Related options:
  173. # * None
  174. #
  175. # (integer value)
  176. #image_location_quota = 10
  177.  
  178. #
  179. # The default number of results to return for a request.
  180. #
  181. # Responses to certain API requests, like list images, may return
  182. # multiple items. The number of results returned can be explicitly
  183. # controlled by specifying the ``limit`` parameter in the API request.
  184. # However, if a ``limit`` parameter is not specified, this
  185. # configuration value will be used as the default number of results to
  186. # be returned for any API request.
  187. #
  188. # NOTES:
  189. # * The value of this configuration option may not be greater than
  190. # the value specified by ``api_limit_max``.
  191. # * Setting this to a very large value may slow down database
  192. # queries and increase response times. Setting this to a
  193. # very low value may result in poor user experience.
  194. #
  195. # Possible values:
  196. # * Any positive integer
  197. #
  198. # Related options:
  199. # * api_limit_max
  200. #
  201. # (integer value)
  202. # Minimum value: 1
  203. #limit_param_default = 25
  204.  
  205. #
  206. # Maximum number of results that could be returned by a request.
  207. #
  208. # As described in the help text of ``limit_param_default``, some
  209. # requests may return multiple results. The number of results to be
  210. # returned are governed either by the ``limit`` parameter in the
  211. # request or the ``limit_param_default`` configuration option.
  212. # The value in either case, can't be greater than the absolute maximum
  213. # defined by this configuration option. Anything greater than this
  214. # value is trimmed down to the maximum value defined here.
  215. #
  216. # NOTE: Setting this to a very large value may slow down database
  217. # queries and increase response times. Setting this to a
  218. # very low value may result in poor user experience.
  219. #
  220. # Possible values:
  221. # * Any positive integer
  222. #
  223. # Related options:
  224. # * limit_param_default
  225. #
  226. # (integer value)
  227. # Minimum value: 1
  228. #api_limit_max = 1000
  229.  
  230. #
  231. # Show direct image location when returning an image.
  232. #
  233. # This configuration option indicates whether to show the direct image
  234. # location when returning image details to the user. The direct image
  235. # location is where the image data is stored in backend storage. This
  236. # image location is shown under the image property ``direct_url``.
  237. #
  238. # When multiple image locations exist for an image, the best location
  239. # is displayed based on the location strategy indicated by the
  240. # configuration option ``location_strategy``.
  241. #
  242. # NOTES:
  243. # * Revealing image locations can present a GRAVE SECURITY RISK as
  244. # image locations can sometimes include credentials. Hence, this
  245. # is set to ``False`` by default. Set this to ``True`` with
  246. # EXTREME CAUTION and ONLY IF you know what you are doing!
  247. # * If an operator wishes to avoid showing any image location(s)
  248. # to the user, then both this option and
  249. # ``show_multiple_locations`` MUST be set to ``False``.
  250. #
  251. # Possible values:
  252. # * True
  253. # * False
  254. #
  255. # Related options:
  256. # * show_multiple_locations
  257. # * location_strategy
  258. #
  259. # (boolean value)
  260. #show_image_direct_url = false
  261.  
  262. # DEPRECATED:
  263. # Show all image locations when returning an image.
  264. #
  265. # This configuration option indicates whether to show all the image
  266. # locations when returning image details to the user. When multiple
  267. # image locations exist for an image, the locations are ordered based
  268. # on the location strategy indicated by the configuration opt
  269. # ``location_strategy``. The image locations are shown under the
  270. # image property ``locations``.
  271. #
  272. # NOTES:
  273. # * Revealing image locations can present a GRAVE SECURITY RISK as
  274. # image locations can sometimes include credentials. Hence, this
  275. # is set to ``False`` by default. Set this to ``True`` with
  276. # EXTREME CAUTION and ONLY IF you know what you are doing!
  277. # * See https://wiki.openstack.org/wiki/OSSN/OSSN-0065 for more
  278. # information.
  279. # * If an operator wishes to avoid showing any image location(s)
  280. # to the user, then both this option and
  281. # ``show_image_direct_url`` MUST be set to ``False``.
  282. #
  283. # Possible values:
  284. # * True
  285. # * False
  286. #
  287. # Related options:
  288. # * show_image_direct_url
  289. # * location_strategy
  290. #
  291. # (boolean value)
  292. # This option is deprecated for removal since Newton.
  293. # Its value may be silently ignored in the future.
  294. # Reason: Use of this option, deprecated since Newton, is a security risk and
  295. # will be removed once we figure out a way to satisfy those use cases that
  296. # currently require it. An earlier announcement that the same functionality can
  297. # be achieved with greater granularity by using policies is incorrect. You
  298. # cannot work around this option via policy configuration at the present time,
  299. # though that is the direction we believe the fix will take. Please keep an eye
  300. # on the Glance release notes to stay up to date on progress in addressing this
  301. # issue.
  302. #show_multiple_locations = false
  303.  
  304. #
  305. # Maximum size of image a user can upload in bytes.
  306. #
  307. # An image upload greater than the size mentioned here would result
  308. # in an image creation failure. This configuration option defaults to
  309. # 1099511627776 bytes (1 TiB).
  310. #
  311. # NOTES:
  312. # * This value should only be increased after careful
  313. # consideration and must be set less than or equal to
  314. # 8 EiB (9223372036854775808).
  315. # * This value must be set with careful consideration of the
  316. # backend storage capacity. Setting this to a very low value
  317. # may result in a large number of image failures. And, setting
  318. # this to a very large value may result in faster consumption
  319. # of storage. Hence, this must be set according to the nature of
  320. # images created and storage capacity available.
  321. #
  322. # Possible values:
  323. # * Any positive number less than or equal to 9223372036854775808
  324. #
  325. # (integer value)
  326. # Minimum value: 1
  327. # Maximum value: 9223372036854775808
  328. #image_size_cap = 1099511627776
  329.  
  330. #
  331. # Maximum amount of image storage per tenant.
  332. #
  333. # This enforces an upper limit on the cumulative storage consumed by all images
  334. # of a tenant across all stores. This is a per-tenant limit.
  335. #
  336. # The default unit for this configuration option is Bytes. However, storage
  337. # units can be specified using case-sensitive literals ``B``, ``KB``, ``MB``,
  338. # ``GB`` and ``TB`` representing Bytes, KiloBytes, MegaBytes, GigaBytes and
  339. # TeraBytes respectively. Note that there should not be any space between the
  340. # value and unit. Value ``0`` signifies no quota enforcement. Negative values
  341. # are invalid and result in errors.
  342. #
  343. # This has no effect if ``use_keystone_limits`` is enabled.
  344. #
  345. # Possible values:
  346. # * A string that is a valid concatenation of a non-negative integer
  347. # representing the storage value and an optional string literal
  348. # representing storage units as mentioned above.
  349. #
  350. # Related options:
  351. # * use_keystone_limits
  352. #
  353. # (string value)
  354. #user_storage_quota = 0
  355.  
  356. #
  357. # Utilize per-tenant resource limits registered in Keystone.
  358. #
  359. # Enabling this feature will cause Glance to retrieve limits set in keystone
  360. # for resource consumption and enforce them against API users. Before turning
  361. # this on, the limits need to be registered in Keystone or all quotas will be
  362. # considered to be zero, and thus reject all new resource requests.
  363. #
  364. # These per-tenant resource limits are independent from the static
  365. # global ones configured in this config file. If this is enabled, the
  366. # relevant static global limits will be ignored.
  367. # (boolean value)
  368. #use_keystone_limits = false
  369.  
  370. #
  371. # Host address of the pydev server.
  372. #
  373. # Provide a string value representing the hostname or IP of the
  374. # pydev server to use for debugging. The pydev server listens for
  375. # debug connections on this address, facilitating remote debugging
  376. # in Glance.
  377. #
  378. # Possible values:
  379. # * Valid hostname
  380. # * Valid IP address
  381. #
  382. # Related options:
  383. # * None
  384. #
  385. # (host address value)
  386. #
  387. # This option has a sample default set, which means that
  388. # its actual default value may vary from the one documented
  389. # below.
  390. #pydev_worker_debug_host = localhost
  391.  
  392. #
  393. # Port number that the pydev server will listen on.
  394. #
  395. # Provide a port number to bind the pydev server to. The pydev
  396. # process accepts debug connections on this port and facilitates
  397. # remote debugging in Glance.
  398. #
  399. # Possible values:
  400. # * A valid port number
  401. #
  402. # Related options:
  403. # * None
  404. #
  405. # (port value)
  406. # Minimum value: 0
  407. # Maximum value: 65535
  408. #pydev_worker_debug_port = 5678
  409.  
  410. #
  411. # AES key for encrypting store location metadata.
  412. #
  413. # Provide a string value representing the AES cipher to use for
  414. # encrypting Glance store metadata.
  415. #
  416. # NOTE: The AES key to use must be set to a random string of length
  417. # 16, 24 or 32 bytes.
  418. #
  419. # Possible values:
  420. # * String value representing a valid AES key
  421. #
  422. # Related options:
  423. # * None
  424. #
  425. # (string value)
  426. #metadata_encryption_key = <None>
  427.  
  428. #
  429. # Digest algorithm to use for digital signature.
  430. #
  431. # Provide a string value representing the digest algorithm to
  432. # use for generating digital signatures. By default, ``sha256``
  433. # is used.
  434. #
  435. # To get a list of the available algorithms supported by the version
  436. # of OpenSSL on your platform, run the command:
  437. # ``openssl list-message-digest-algorithms``.
  438. # Examples are 'sha1', 'sha256', and 'sha512'.
  439. #
  440. # NOTE: ``digest_algorithm`` is not related to Glance's image signing
  441. # and verification. It is only used to sign the universally unique
  442. # identifier (UUID) as a part of the certificate file and key file
  443. # validation.
  444. #
  445. # Possible values:
  446. # * An OpenSSL message digest algorithm identifier
  447. #
  448. # Relation options:
  449. # * None
  450. #
  451. # (string value)
  452. #digest_algorithm = sha256
  453.  
  454. #
  455. # The URL provides location where the temporary data will be stored
  456. #
  457. # This option is for Glance internal use only. Glance will save the
  458. # image data uploaded by the user to 'staging' endpoint during the
  459. # image import process.
  460. #
  461. # This option does not change the 'staging' API endpoint by any means.
  462. #
  463. # NOTE: It is discouraged to use same path as [task]/work_dir
  464. #
  465. # NOTE: 'file://<absolute-directory-path>' is the only option
  466. # api_image_import flow will support for now.
  467. #
  468. # NOTE: The staging path must be on shared filesystem available to all
  469. # Glance API nodes.
  470. #
  471. # Possible values:
  472. # * String starting with 'file://' followed by absolute FS path
  473. #
  474. # Related options:
  475. # * [task]/work_dir
  476. #
  477. # (string value)
  478. #node_staging_uri = file:///tmp/staging/
  479.  
  480. #
  481. # List of enabled Image Import Methods
  482. #
  483. # 'glance-direct', 'copy-image' and 'web-download' are enabled by default.
  484. # 'glance-download' is available, but requires federated deployments.
  485. #
  486. # Related options:
  487. # * [DEFAULT]/node_staging_uri (list value)
  488. #enabled_import_methods = [glance-direct,web-download,copy-image]
  489.  
  490. #
  491. # The URL to this worker.
  492. #
  493. # If this is set, other glance workers will know how to contact this one
  494. # directly if needed. For image import, a single worker stages the image
  495. # and other workers need to be able to proxy the import request to the
  496. # right one.
  497. #
  498. # If unset, this will be considered to be `public_endpoint`, which
  499. # normally would be set to the same value on all workers, effectively
  500. # disabling the proxying behavior.
  501. #
  502. # Possible values:
  503. # * A URL by which this worker is reachable from other workers
  504. #
  505. # Related options:
  506. # * public_endpoint
  507. #
  508. # (string value)
  509. #worker_self_reference_url = <None>
  510.  
  511. # DEPRECATED:
  512. # Strategy to determine the preference order of image locations.
  513. #
  514. # This configuration option indicates the strategy to determine
  515. # the order in which an image's locations must be accessed to
  516. # serve the image's data. Glance then retrieves the image data
  517. # from the first responsive active location it finds in this list.
  518. #
  519. # This option takes one of two possible values ``location_order``
  520. # and ``store_type``. The default value is ``location_order``,
  521. # which suggests that image data be served by using locations in
  522. # the order they are stored in Glance. The ``store_type`` value
  523. # sets the image location preference based on the order in which
  524. # the storage backends are listed as a comma separated list for
  525. # the configuration option ``store_type_preference``.
  526. #
  527. # Possible values:
  528. # * location_order
  529. # * store_type
  530. #
  531. # Related options:
  532. # * store_type_preference
  533. #
  534. # (string value)
  535. # Possible values:
  536. # location_order - <No description provided>
  537. # store_type - <No description provided>
  538. # This option is deprecated for removal since Caracal.
  539. # Its value may be silently ignored in the future.
  540. # Reason:
  541. # In Bobcat, a new weighing mechanism has been introduced, which makes the
  542. # location strategy obsolete. This option is scheduled to be removed during the
  543. # Dalmatian development cycle.
  544. #location_strategy = location_order
  545.  
  546. #
  547. # The location of the property protection file.
  548. #
  549. # Provide a valid path to the property protection file which contains
  550. # the rules for property protections and the roles/policies associated
  551. # with them.
  552. #
  553. # A property protection file, when set, restricts the Glance image
  554. # properties to be created, read, updated and/or deleted by a specific
  555. # set of users that are identified by either roles or policies.
  556. # If this configuration option is not set, by default, property
  557. # protections won't be enforced. If a value is specified and the file
  558. # is not found, the glance-api service will fail to start.
  559. # More information on property protections can be found at:
  560. # https://docs.openstack.org/glance/latest/admin/property-protections.html
  561. #
  562. # Possible values:
  563. # * Empty string
  564. # * Valid path to the property protection configuration file
  565. #
  566. # Related options:
  567. # * property_protection_rule_format
  568. #
  569. # (string value)
  570. #property_protection_file = <None>
  571.  
  572. #
  573. # Rule format for property protection.
  574. #
  575. # Provide the desired way to set property protection on Glance
  576. # image properties. The two permissible values are ``roles``
  577. # and ``policies``. The default value is ``roles``.
  578. #
  579. # If the value is ``roles``, the property protection file must
  580. # contain a comma separated list of user roles indicating
  581. # permissions for each of the CRUD operations on each property
  582. # being protected. If set to ``policies``, a policy defined in
  583. # policy.yaml is used to express property protections for each
  584. # of the CRUD operations. Examples of how property protections
  585. # are enforced based on ``roles`` or ``policies`` can be found at:
  586. # https://docs.openstack.org/glance/latest/admin/property-
  587. # protections.html#examples
  588. #
  589. # Possible values:
  590. # * roles
  591. # * policies
  592. #
  593. # Related options:
  594. # * property_protection_file
  595. #
  596. # (string value)
  597. # Possible values:
  598. # roles - <No description provided>
  599. # policies - <No description provided>
  600. #property_protection_rule_format = roles
  601.  
  602. #
  603. # IP address to bind the glance servers to.
  604. #
  605. # Provide an IP address to bind the glance server to. The default
  606. # value is ``0.0.0.0``.
  607. #
  608. # Edit this option to enable the server to listen on one particular
  609. # IP address on the network card. This facilitates selection of a
  610. # particular network interface for the server.
  611. #
  612. # Possible values:
  613. # * A valid IPv4 address
  614. # * A valid IPv6 address
  615. #
  616. # Related options:
  617. # * None
  618. #
  619. # (host address value)
  620. #bind_host = 0.0.0.0
  621.  
  622. #
  623. # Port number on which the server will listen.
  624. #
  625. # Provide a valid port number to bind the server's socket to. This
  626. # port is then set to identify processes and forward network messages
  627. # that arrive at the server. The default bind_port value for the API
  628. # server is 9292 and for the registry server is 9191.
  629. #
  630. # Possible values:
  631. # * A valid port number (0 to 65535)
  632. #
  633. # Related options:
  634. # * None
  635. #
  636. # (port value)
  637. # Minimum value: 0
  638. # Maximum value: 65535
  639. #bind_port = <None>
  640.  
  641. #
  642. # Number of Glance worker processes to start.
  643. #
  644. # Provide a non-negative integer value to set the number of child
  645. # process workers to service requests. By default, the number of CPUs
  646. # available is set as the value for ``workers`` limited to 8. For
  647. # example if the processor count is 6, 6 workers will be used, if the
  648. # processor count is 24 only 8 workers will be used. The limit will only
  649. # apply to the default value, if 24 workers is configured, 24 is used.
  650. #
  651. # Each worker process is made to listen on the port set in the
  652. # configuration file and contains a greenthread pool of size 1000.
  653. #
  654. # NOTE: Setting the number of workers to zero, triggers the creation
  655. # of a single API process with a greenthread pool of size 1000.
  656. #
  657. # Possible values:
  658. # * 0
  659. # * Positive integer value (typically equal to the number of CPUs)
  660. #
  661. # Related options:
  662. # * None
  663. #
  664. # (integer value)
  665. # Minimum value: 0
  666. #workers = <None>
  667.  
  668. #
  669. # Maximum line size of message headers.
  670. #
  671. # Provide an integer value representing a length to limit the size of
  672. # message headers. The default value is 16384.
  673. #
  674. # NOTE: ``max_header_line`` may need to be increased when using large
  675. # tokens (typically those generated by the Keystone v3 API with big
  676. # service catalogs). However, it is to be kept in mind that larger
  677. # values for ``max_header_line`` would flood the logs.
  678. #
  679. # Setting ``max_header_line`` to 0 sets no limit for the line size of
  680. # message headers.
  681. #
  682. # Possible values:
  683. # * 0
  684. # * Positive integer
  685. #
  686. # Related options:
  687. # * None
  688. #
  689. # (integer value)
  690. # Minimum value: 0
  691. #max_header_line = 16384
  692.  
  693. #
  694. # Set keep alive option for HTTP over TCP.
  695. #
  696. # Provide a boolean value to determine sending of keep alive packets.
  697. # If set to ``False``, the server returns the header
  698. # "Connection: close". If set to ``True``, the server returns a
  699. # "Connection: Keep-Alive" in its responses. This enables retention of
  700. # the same TCP connection for HTTP conversations instead of opening a
  701. # new one with each new request.
  702. #
  703. # This option must be set to ``False`` if the client socket connection
  704. # needs to be closed explicitly after the response is received and
  705. # read successfully by the client.
  706. #
  707. # Possible values:
  708. # * True
  709. # * False
  710. #
  711. # Related options:
  712. # * None
  713. #
  714. # (boolean value)
  715. #http_keepalive = true
  716.  
  717. #
  718. # Timeout for client connections' socket operations.
  719. #
  720. # Provide a valid integer value representing time in seconds to set
  721. # the period of wait before an incoming connection can be closed. The
  722. # default value is 900 seconds.
  723. #
  724. # The value zero implies wait forever.
  725. #
  726. # Possible values:
  727. # * Zero
  728. # * Positive integer
  729. #
  730. # Related options:
  731. # * None
  732. #
  733. # (integer value)
  734. # Minimum value: 0
  735. #client_socket_timeout = 900
  736.  
  737. #
  738. # Set the number of incoming connection requests.
  739. #
  740. # Provide a positive integer value to limit the number of requests in
  741. # the backlog queue. The default queue size is 4096.
  742. #
  743. # An incoming connection to a TCP listener socket is queued before a
  744. # connection can be established with the server. Setting the backlog
  745. # for a TCP socket ensures a limited queue size for incoming traffic.
  746. #
  747. # Possible values:
  748. # * Positive integer
  749. #
  750. # Related options:
  751. # * None
  752. #
  753. # (integer value)
  754. # Minimum value: 1
  755. #backlog = 4096
  756.  
  757. #
  758. # Set the wait time before a connection recheck.
  759. #
  760. # Provide a positive integer value representing time in seconds which
  761. # is set as the idle wait time before a TCP keep alive packet can be
  762. # sent to the host. The default value is 600 seconds.
  763. #
  764. # Setting ``tcp_keepidle`` helps verify at regular intervals that a
  765. # connection is intact and prevents frequent TCP connection
  766. # reestablishment.
  767. #
  768. # Possible values:
  769. # * Positive integer value representing time in seconds
  770. #
  771. # Related options:
  772. # * None
  773. #
  774. # (integer value)
  775. # Minimum value: 1
  776. #tcp_keepidle = 600
  777.  
  778. # Key:Value pair of store identifier and store type. In case of multiple
  779. # backends should be separated using comma. (dict value)
  780. #enabled_backends = <None>
  781.  
  782. # This argument is used internally on Windows. Glance passes a pipe handle to
  783. # child processes, which is then used for inter-process communication. (string
  784. # value)
  785. #pipe_handle = <None>
  786.  
  787. # DEPRECATED:
  788. # The relative path to sqlite file database that will be used for image cache
  789. # management.
  790. #
  791. # This is a relative path to the sqlite file database that tracks the age and
  792. # usage statistics of image cache. The path is relative to image cache base
  793. # directory, specified by the configuration option ``image_cache_dir``.
  794. #
  795. # This is a lightweight database with just one table.
  796. #
  797. # Possible values:
  798. # * A valid relative path to sqlite file database
  799. #
  800. # Related options:
  801. # * ``image_cache_dir``
  802. #
  803. # (string value)
  804. # This option is deprecated for removal since Caracal (2024.1).
  805. # Its value may be silently ignored in the future.
  806. # Reason:
  807. # As centralized database will now be used for image cache management, the use
  808. # of `sqlite` database and driver will be dropped from 'E' (2025.1)
  809. # development cycle.
  810. #image_cache_sqlite_db = cache.db
  811.  
  812. #
  813. # The driver to use for image cache management.
  814. #
  815. # This configuration option provides the flexibility to choose between the
  816. # different image-cache drivers available. An image-cache driver is responsible
  817. # for providing the essential functions of image-cache like write images to/read
  818. # images from cache, track age and usage of cached images, provide a list of
  819. # cached images, fetch size of the cache, queue images for caching and clean up
  820. # the cache, etc.
  821. #
  822. # The essential functions of a driver are defined in the base class
  823. # ``glance.image_cache.drivers.base.Driver``. All image-cache drivers (existing
  824. # and prospective) must implement this interface. Currently available drivers
  825. # are ``sqlite`` and ``xattr``. These drivers primarily differ in the way they
  826. # store the information about cached images:
  827. #
  828. # * The ``centralized_db`` driver uses a central database (which will be common
  829. # for all glance nodes) to track the usage of cached images.
  830. # * The ``sqlite`` (deprecated) driver uses a sqlite database (which sits on
  831. # every glance node locally) to track the usage of cached images.
  832. # * The ``xattr`` driver uses the extended attributes of files to store this
  833. # information. It also requires a filesystem that sets ``atime`` on the files
  834. # when accessed.
  835. #
  836. # Deprecation warning:
  837. # * As centralized database will now be used for image cache management, the
  838. # use of `sqlite` database and driver will be dropped from 'E' (2025.1)
  839. # development cycle.
  840. #
  841. # Possible values:
  842. # * centralized_db
  843. # * sqlite
  844. # * xattr
  845. #
  846. # Related options:
  847. # * None
  848. #
  849. # (string value)
  850. # Possible values:
  851. # centralized_db - <No description provided>
  852. # sqlite - <No description provided>
  853. # xattr - <No description provided>
  854. #image_cache_driver = centralized_db
  855.  
  856. #
  857. # The upper limit on cache size, in bytes, after which the cache-pruner cleans
  858. # up the image cache.
  859. #
  860. # NOTE: This is just a threshold for cache-pruner to act upon. It is NOT a
  861. # hard limit beyond which the image cache would never grow. In fact, depending
  862. # on how often the cache-pruner runs and how quickly the cache fills, the image
  863. # cache can far exceed the size specified here very easily. Hence, care must be
  864. # taken to appropriately schedule the cache-pruner and in setting this limit.
  865. #
  866. # Glance caches an image when it is downloaded. Consequently, the size of the
  867. # image cache grows over time as the number of downloads increases. To keep the
  868. # cache size from becoming unmanageable, it is recommended to run the
  869. # cache-pruner as a periodic task. When the cache pruner is kicked off, it
  870. # compares the current size of image cache and triggers a cleanup if the image
  871. # cache grew beyond the size specified here. After the cleanup, the size of
  872. # cache is less than or equal to size specified here.
  873. #
  874. # Possible values:
  875. # * Any non-negative integer
  876. #
  877. # Related options:
  878. # * None
  879. #
  880. # (integer value)
  881. # Minimum value: 0
  882. #image_cache_max_size = 10737418240
  883.  
  884. #
  885. # The amount of time, in seconds, an incomplete image remains in the cache.
  886. #
  887. # Incomplete images are images for which download is in progress. Please see the
  888. # description of configuration option ``image_cache_dir`` for more detail.
  889. # Sometimes, due to various reasons, it is possible the download may hang and
  890. # the incompletely downloaded image remains in the ``incomplete`` directory.
  891. # This configuration option sets a time limit on how long the incomplete images
  892. # should remain in the ``incomplete`` directory before they are cleaned up.
  893. # Once an incomplete image spends more time than is specified here, it'll be
  894. # removed by cache-cleaner on its next run.
  895. #
  896. # It is recommended to run cache-cleaner as a periodic task on the Glance API
  897. # nodes to keep the incomplete images from occupying disk space.
  898. #
  899. # Possible values:
  900. # * Any non-negative integer
  901. #
  902. # Related options:
  903. # * None
  904. #
  905. # (integer value)
  906. # Minimum value: 0
  907. #image_cache_stall_time = 86400
  908.  
  909. #
  910. # Base directory for image cache.
  911. #
  912. # This is the location where image data is cached and served out of. All cached
  913. # images are stored directly under this directory. This directory also contains
  914. # three subdirectories, namely, ``incomplete``, ``invalid`` and ``queue``.
  915. #
  916. # The ``incomplete`` subdirectory is the staging area for downloading images. An
  917. # image is first downloaded to this directory. When the image download is
  918. # successful it is moved to the base directory. However, if the download fails,
  919. # the partially downloaded image file is moved to the ``invalid`` subdirectory.
  920. #
  921. # The ``queue``subdirectory is used for queuing images for download. This is
  922. # used primarily by the cache-prefetcher, which can be scheduled as a periodic
  923. # task like cache-pruner and cache-cleaner, to cache images ahead of their
  924. # usage.
  925. # Upon receiving the request to cache an image, Glance touches a file in the
  926. # ``queue`` directory with the image id as the file name. The cache-prefetcher,
  927. # when running, polls for the files in ``queue`` directory and starts
  928. # downloading them in the order they were created. When the download is
  929. # successful, the zero-sized file is deleted from the ``queue`` directory.
  930. # If the download fails, the zero-sized file remains and it'll be retried the
  931. # next time cache-prefetcher runs.
  932. #
  933. # Possible values:
  934. # * A valid path
  935. #
  936. # Related options:
  937. # * ``image_cache_sqlite_db``
  938. #
  939. # (string value)
  940. #image_cache_dir = <None>
  941.  
  942. #
  943. # Default publisher_id for outgoing Glance notifications.
  944. #
  945. # This is the value that the notification driver will use to identify
  946. # messages for events originating from the Glance service. Typically,
  947. # this is the hostname of the instance that generated the message.
  948. #
  949. # Possible values:
  950. # * Any reasonable instance identifier, for example: image.host1
  951. #
  952. # Related options:
  953. # * None
  954. #
  955. # (string value)
  956. #default_publisher_id = image.localhost
  957.  
  958. #
  959. # List of notifications to be disabled.
  960. #
  961. # Specify a list of notifications that should not be emitted.
  962. # A notification can be given either as a notification type to
  963. # disable a single event notification, or as a notification group
  964. # prefix to disable all event notifications within a group.
  965. #
  966. # Possible values:
  967. # A comma-separated list of individual notification types or
  968. # notification groups to be disabled. Currently supported groups:
  969. #
  970. # * image
  971. # * image.member
  972. # * task
  973. # * metadef_namespace
  974. # * metadef_object
  975. # * metadef_property
  976. # * metadef_resource_type
  977. # * metadef_tag
  978. #
  979. # For a complete listing and description of each event refer to:
  980. # https://docs.openstack.org/glance/latest/admin/notifications.html
  981. #
  982. # The values must be specified as: <group_name>.<event_name>
  983. # For example: image.create,task.success,metadef_tag
  984. #
  985. # Related options:
  986. # * None
  987. #
  988. # (list value)
  989. #disabled_notifications =
  990.  
  991. # DEPRECATED:
  992. # The amount of time, in seconds, to delay image scrubbing.
  993. #
  994. # When delayed delete is turned on, an image is put into ``pending_delete``
  995. # state upon deletion until the scrubber deletes its image data. Typically, soon
  996. # after the image is put into ``pending_delete`` state, it is available for
  997. # scrubbing. However, scrubbing can be delayed until a later point using this
  998. # configuration option. This option denotes the time period an image spends in
  999. # ``pending_delete`` state before it is available for scrubbing.
  1000. #
  1001. # It is important to realize that this has storage implications. The larger the
  1002. # ``scrub_time``, the longer the time to reclaim backend storage from deleted
  1003. # images.
  1004. #
  1005. # Possible values:
  1006. # * Any non-negative integer
  1007. #
  1008. # Related options:
  1009. # * ``delayed_delete``
  1010. #
  1011. # (integer value)
  1012. # Minimum value: 0
  1013. # This option is deprecated for removal since 2024.1 (Caracal).
  1014. # Its value may be silently ignored in the future.
  1015. # Reason: The entire glance scrubber, including this option, is scheduled to be
  1016. # removed during the 2024.2 (Dalmatian) development cycle.
  1017. #scrub_time = 0
  1018.  
  1019. # DEPRECATED:
  1020. # The size of thread pool to be used for scrubbing images.
  1021. #
  1022. # When there are a large number of images to scrub, it is beneficial to scrub
  1023. # images in parallel so that the scrub queue stays in control and the backend
  1024. # storage is reclaimed in a timely fashion. This configuration option denotes
  1025. # the maximum number of images to be scrubbed in parallel. The default value is
  1026. # one, which signifies serial scrubbing. Any value above one indicates parallel
  1027. # scrubbing.
  1028. #
  1029. # Possible values:
  1030. # * Any non-zero positive integer
  1031. #
  1032. # Related options:
  1033. # * ``delayed_delete``
  1034. #
  1035. # (integer value)
  1036. # Minimum value: 1
  1037. # This option is deprecated for removal since 2024.1 (Caracal).
  1038. # Its value may be silently ignored in the future.
  1039. # Reason: The entire glance scrubber, including this option, is scheduled to be
  1040. # removed during the 2024.2 (Dalmatian) development cycle.
  1041. #scrub_pool_size = 1
  1042.  
  1043. # DEPRECATED:
  1044. # Turn on/off delayed delete.
  1045. #
  1046. # Typically when an image is deleted, the ``glance-api`` service puts the image
  1047. # into ``deleted`` state and deletes its data at the same time. Delayed delete
  1048. # is a feature in Glance that delays the actual deletion of image data until a
  1049. # later point in time (as determined by the configuration option
  1050. # ``scrub_time``).
  1051. # When delayed delete is turned on, the ``glance-api`` service puts the image
  1052. # into ``pending_delete`` state upon deletion and leaves the image data in the
  1053. # storage backend for the image scrubber to delete at a later time. The image
  1054. # scrubber will move the image into ``deleted`` state upon successful deletion
  1055. # of image data.
  1056. #
  1057. # NOTE: When delayed delete is turned on, image scrubber MUST be running as a
  1058. # periodic task to prevent the backend storage from filling up with undesired
  1059. # usage.
  1060. #
  1061. # Possible values:
  1062. # * True
  1063. # * False
  1064. #
  1065. # Related options:
  1066. # * ``scrub_time``
  1067. # * ``wakeup_time``
  1068. # * ``scrub_pool_size``
  1069. #
  1070. # (boolean value)
  1071. # This option is deprecated for removal since 2024.1 (Caracal).
  1072. # Its value may be silently ignored in the future.
  1073. # Reason: The entire glance scrubber, including this option, is scheduled to be
  1074. # removed during the 2024.2 (Dalmatian) development cycle.
  1075. #delayed_delete = false
  1076.  
  1077. #
  1078. # From oslo.log
  1079. #
  1080.  
  1081. # If set to true, the logging level will be set to DEBUG instead of the default
  1082. # INFO level. (boolean value)
  1083. # Note: This option can be changed without restarting.
  1084. #debug = false
  1085.  
  1086. # The name of a logging configuration file. This file is appended to any
  1087. # existing logging configuration files. For details about logging configuration
  1088. # files, see the Python logging module documentation. Note that when logging
  1089. # configuration files are used then all logging configuration is set in the
  1090. # configuration file and other logging configuration options are ignored (for
  1091. # example, log-date-format). (string value)
  1092. # Note: This option can be changed without restarting.
  1093. # Deprecated group/name - [DEFAULT]/log_config
  1094. #log_config_append = <None>
  1095.  
  1096. # Defines the format string for %%(asctime)s in log records. Default:
  1097. # %(default)s . This option is ignored if log_config_append is set. (string
  1098. # value)
  1099. #log_date_format = %Y-%m-%d %H:%M:%S
  1100.  
  1101. # (Optional) Name of log file to send logging output to. If no default is set,
  1102. # logging will go to stderr as defined by use_stderr. This option is ignored if
  1103. # log_config_append is set. (string value)
  1104. # Deprecated group/name - [DEFAULT]/logfile
  1105. #log_file = <None>
  1106.  
  1107. # (Optional) The base directory used for relative log_file paths. This option
  1108. # is ignored if log_config_append is set. (string value)
  1109. # Deprecated group/name - [DEFAULT]/logdir
  1110. #log_dir = <None>
  1111.  
  1112. # Uses logging handler designed to watch file system. When log file is moved or
  1113. # removed this handler will open a new log file with specified path
  1114. # instantaneously. It makes sense only if log_file option is specified and Linux
  1115. # platform is used. This option is ignored if log_config_append is set. (boolean
  1116. # value)
  1117. #watch_log_file = false
  1118.  
  1119. # Use syslog for logging. Existing syslog format is DEPRECATED and will be
  1120. # changed later to honor RFC5424. This option is ignored if log_config_append is
  1121. # set. (boolean value)
  1122. #use_syslog = false
  1123.  
  1124. # Enable journald for logging. If running in a systemd environment you may wish
  1125. # to enable journal support. Doing so will use the journal native protocol which
  1126. # includes structured metadata in addition to log messages.This option is
  1127. # ignored if log_config_append is set. (boolean value)
  1128. #use_journal = false
  1129.  
  1130. # Syslog facility to receive log lines. This option is ignored if
  1131. # log_config_append is set. (string value)
  1132. #syslog_log_facility = LOG_USER
  1133.  
  1134. # Use JSON formatting for logging. This option is ignored if log_config_append
  1135. # is set. (boolean value)
  1136. #use_json = false
  1137.  
  1138. # Log output to standard error. This option is ignored if log_config_append is
  1139. # set. (boolean value)
  1140. #use_stderr = false
  1141.  
  1142. # DEPRECATED: Log output to Windows Event Log. (boolean value)
  1143. # This option is deprecated for removal.
  1144. # Its value may be silently ignored in the future.
  1145. # Reason: Windows support is no longer maintained.
  1146. #use_eventlog = false
  1147.  
  1148. # The amount of time before the log files are rotated. This option is ignored
  1149. # unless log_rotation_type is set to "interval". (integer value)
  1150. #log_rotate_interval = 1
  1151.  
  1152. # Rotation interval type. The time of the last file change (or the time when the
  1153. # service was started) is used when scheduling the next rotation. (string value)
  1154. # Possible values:
  1155. # Seconds - <No description provided>
  1156. # Minutes - <No description provided>
  1157. # Hours - <No description provided>
  1158. # Days - <No description provided>
  1159. # Weekday - <No description provided>
  1160. # Midnight - <No description provided>
  1161. #log_rotate_interval_type = days
  1162.  
  1163. # Maximum number of rotated log files. (integer value)
  1164. #max_logfile_count = 30
  1165.  
  1166. # Log file maximum size in MB. This option is ignored if "log_rotation_type" is
  1167. # not set to "size". (integer value)
  1168. #max_logfile_size_mb = 200
  1169.  
  1170. # Log rotation type. (string value)
  1171. # Possible values:
  1172. # interval - Rotate logs at predefined time intervals.
  1173. # size - Rotate logs once they reach a predefined size.
  1174. # none - Do not rotate log files.
  1175. #log_rotation_type = none
  1176.  
  1177. # Format string to use for log messages with context. Used by
  1178. # oslo_log.formatters.ContextFormatter (string value)
  1179. #logging_context_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [%(global_request_id)s %(request_id)s %(user_identity)s] %(instance)s%(message)s
  1180.  
  1181. # Format string to use for log messages when context is undefined. Used by
  1182. # oslo_log.formatters.ContextFormatter (string value)
  1183. #logging_default_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [-] %(instance)s%(message)s
  1184.  
  1185. # Additional data to append to log message when logging level for the message is
  1186. # DEBUG. Used by oslo_log.formatters.ContextFormatter (string value)
  1187. #logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d
  1188.  
  1189. # Prefix each line of exception output with this format. Used by
  1190. # oslo_log.formatters.ContextFormatter (string value)
  1191. #logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s
  1192.  
  1193. # Defines the format string for %(user_identity)s that is used in
  1194. # logging_context_format_string. Used by oslo_log.formatters.ContextFormatter
  1195. # (string value)
  1196. #logging_user_identity_format = %(user)s %(project)s %(domain)s %(system_scope)s %(user_domain)s %(project_domain)s
  1197.  
  1198. # List of package logging levels in logger=LEVEL pairs. This option is ignored
  1199. # if log_config_append is set. (list value)
  1200. #default_log_levels = amqp=WARN,amqplib=WARN,boto=WARN,qpid=WARN,sqlalchemy=WARN,suds=INFO,oslo.messaging=INFO,oslo_messaging=INFO,iso8601=WARN,requests.packages.urllib3.connectionpool=WARN,urllib3.connectionpool=WARN,websocket=WARN,requests.packages.urllib3.util.retry=WARN,urllib3.util.retry=WARN,keystonemiddleware=WARN,routes.middleware=WARN,stevedore=WARN,taskflow=WARN,keystoneauth=WARN,oslo.cache=INFO,oslo_policy=INFO,dogpile.core.dogpile=INFO
  1201.  
  1202. # Enables or disables publication of error events. (boolean value)
  1203. #publish_errors = false
  1204.  
  1205. # The format for an instance that is passed with the log message. (string value)
  1206. #instance_format = "[instance: %(uuid)s] "
  1207.  
  1208. # The format for an instance UUID that is passed with the log message. (string
  1209. # value)
  1210. #instance_uuid_format = "[instance: %(uuid)s] "
  1211.  
  1212. # Interval, number of seconds, of log rate limiting. (integer value)
  1213. #rate_limit_interval = 0
  1214.  
  1215. # Maximum number of logged messages per rate_limit_interval. (integer value)
  1216. #rate_limit_burst = 0
  1217.  
  1218. # Log level name used by rate limiting: CRITICAL, ERROR, INFO, WARNING, DEBUG or
  1219. # empty string. Logs with level greater or equal to rate_limit_except_level are
  1220. # not filtered. An empty string means that all levels are filtered. (string
  1221. # value)
  1222. #rate_limit_except_level = CRITICAL
  1223.  
  1224. # Enables or disables fatal status of deprecations. (boolean value)
  1225. #fatal_deprecations = false
  1226.  
  1227. #
  1228. # From oslo.messaging
  1229. #
  1230.  
  1231. # Size of RPC connection pool. (integer value)
  1232. # Minimum value: 1
  1233. #rpc_conn_pool_size = 30
  1234.  
  1235. # The pool size limit for connections expiration policy (integer value)
  1236. #conn_pool_min_size = 2
  1237.  
  1238. # The time-to-live in sec of idle connections in the pool (integer value)
  1239. #conn_pool_ttl = 1200
  1240.  
  1241. # Size of executor thread pool when executor is threading or eventlet. (integer
  1242. # value)
  1243. # Deprecated group/name - [DEFAULT]/rpc_thread_pool_size
  1244. #executor_thread_pool_size = 64
  1245.  
  1246. # Seconds to wait for a response from a call. (integer value)
  1247. #rpc_response_timeout = 60
  1248.  
  1249. # The network address and optional user credentials for connecting to the
  1250. # messaging backend, in URL format. The expected format is:
  1251. #
  1252. # driver://[user:pass@]host:port[,[userN:passN@]hostN:portN]/virtual_host?query
  1253. #
  1254. # Example: rabbit://rabbitmq:password@127.0.0.1:5672//
  1255. #
  1256. # For full details on the fields in the URL see the documentation of
  1257. # oslo_messaging.TransportURL at
  1258. # https://docs.openstack.org/oslo.messaging/latest/reference/transport.html
  1259. # (string value)
  1260. #transport_url = rabbit://
  1261.  
  1262. # The default exchange under which topics are scoped. May be overridden by an
  1263. # exchange name specified in the transport_url option. (string value)
  1264. #control_exchange = openstack
  1265.  
  1266. # Add an endpoint to answer to ping calls. Endpoint is named
  1267. # oslo_rpc_server_ping (boolean value)
  1268. #rpc_ping_enabled = false
  1269.  
  1270.  
  1271. [barbican]
  1272.  
  1273. #
  1274. # From castellan.config
  1275. #
  1276.  
  1277. # Use this endpoint to connect to Barbican, for example:
  1278. # "http://localhost:9311/" (string value)
  1279. #barbican_endpoint = <None>
  1280.  
  1281. # Version of the Barbican API, for example: "v1" (string value)
  1282. #barbican_api_version = <None>
  1283.  
  1284. # Use this endpoint to connect to Keystone (string value)
  1285. # Deprecated group/name - [key_manager]/auth_url
  1286. #auth_endpoint = http://localhost/identity/v3
  1287.  
  1288. # Number of seconds to wait before retrying poll for key creation completion
  1289. # (integer value)
  1290. #retry_delay = 1
  1291.  
  1292. # Number of times to retry poll for key creation completion (integer value)
  1293. #number_of_retries = 60
  1294.  
  1295. # Specifies if insecure TLS (https) requests. If False, the server's certificate
  1296. # will not be validated, if True, we can set the verify_ssl_path config
  1297. # meanwhile. (boolean value)
  1298. #verify_ssl = true
  1299.  
  1300. # A path to a bundle or CA certs to check against, or None for requests to
  1301. # attempt to locate and use certificates which verify_ssh is True. If verify_ssl
  1302. # is False, this is ignored. (string value)
  1303. #verify_ssl_path = <None>
  1304.  
  1305. # Specifies the type of endpoint. Allowed values are: public, private, and
  1306. # admin (string value)
  1307. # Possible values:
  1308. # public - <No description provided>
  1309. # internal - <No description provided>
  1310. # admin - <No description provided>
  1311. #barbican_endpoint_type = public
  1312.  
  1313. # Specifies the region of the chosen endpoint. (string value)
  1314. #barbican_region_name = <None>
  1315.  
  1316. #
  1317. # When True, if sending a user token to a REST API, also send a service token.
  1318. #
  1319. # Nova often reuses the user token provided to the nova-api to talk to other
  1320. # REST
  1321. # APIs, such as Cinder, Glance and Neutron. It is possible that while the user
  1322. # token was valid when the request was made to Nova, the token may expire before
  1323. # it reaches the other service. To avoid any failures, and to make it clear it
  1324. # is
  1325. # Nova calling the service on the user's behalf, we include a service token
  1326. # along
  1327. # with the user token. Should the user's token have expired, a valid service
  1328. # token ensures the REST API request will still be accepted by the keystone
  1329. # middleware.
  1330. # (boolean value)
  1331. #send_service_user_token = false
  1332.  
  1333.  
  1334. [barbican_service_user]
  1335.  
  1336. #
  1337. # From castellan.config
  1338. #
  1339.  
  1340. # PEM encoded Certificate Authority to use when verifying HTTPs connections.
  1341. # (string value)
  1342. #cafile = <None>
  1343.  
  1344. # PEM encoded client certificate cert file (string value)
  1345. #certfile = <None>
  1346.  
  1347. # PEM encoded client certificate key file (string value)
  1348. #keyfile = <None>
  1349.  
  1350. # Verify HTTPS connections. (boolean value)
  1351. #insecure = false
  1352.  
  1353. # Timeout value for http requests (integer value)
  1354. #timeout = <None>
  1355.  
  1356. # Collect per-API call timing information. (boolean value)
  1357. #collect_timing = false
  1358.  
  1359. # Log requests to multiple loggers. (boolean value)
  1360. #split_loggers = false
  1361.  
  1362. # Authentication type to load (string value)
  1363. # Deprecated group/name - [barbican_service_user]/auth_plugin
  1364. #auth_type = <None>
  1365.  
  1366. # Config Section from which to load plugin specific options (string value)
  1367. #auth_section = <None>
  1368.  
  1369.  
  1370. [cinder]
  1371.  
  1372. #
  1373. # From glance.multi_store
  1374. #
  1375.  
  1376. #
  1377. # Information to match when looking for cinder in the service catalog.
  1378. #
  1379. # When the ``cinder_endpoint_template`` is not set and any of
  1380. # ``cinder_store_auth_address``, ``cinder_store_user_name``,
  1381. # ``cinder_store_project_name``, ``cinder_store_password`` is not set,
  1382. # cinder store uses this information to lookup cinder endpoint from the service
  1383. # catalog in the current context. ``cinder_os_region_name``, if set, is taken
  1384. # into consideration to fetch the appropriate endpoint.
  1385. #
  1386. # The service catalog can be listed by the ``openstack catalog list`` command.
  1387. #
  1388. # Possible values:
  1389. # * A string of of the following form:
  1390. # ``<service_type>:<service_name>:<interface>``
  1391. # At least ``service_type`` and ``interface`` should be specified.
  1392. # ``service_name`` can be omitted.
  1393. #
  1394. # Related options:
  1395. # * cinder_os_region_name
  1396. # * cinder_endpoint_template
  1397. # * cinder_store_auth_address
  1398. # * cinder_store_user_name
  1399. # * cinder_store_project_name
  1400. # * cinder_store_password
  1401. # * cinder_store_project_domain_name
  1402. # * cinder_store_user_domain_name
  1403. #
  1404. # (string value)
  1405. #cinder_catalog_info = volumev3::publicURL
  1406.  
  1407. #
  1408. # Override service catalog lookup with template for cinder endpoint.
  1409. #
  1410. # When this option is set, this value is used to generate cinder endpoint,
  1411. # instead of looking up from the service catalog.
  1412. # This value is ignored if ``cinder_store_auth_address``,
  1413. # ``cinder_store_user_name``, ``cinder_store_project_name``, and
  1414. # ``cinder_store_password`` are specified.
  1415. #
  1416. # If this configuration option is set, ``cinder_catalog_info`` will be ignored.
  1417. #
  1418. # Possible values:
  1419. # * URL template string for cinder endpoint, where ``%%(tenant)s`` is
  1420. # replaced with the current tenant (project) name.
  1421. # For example: ``http://cinder.openstack.example.org/v2/%%(tenant)s``
  1422. #
  1423. # Related options:
  1424. # * cinder_store_auth_address
  1425. # * cinder_store_user_name
  1426. # * cinder_store_project_name
  1427. # * cinder_store_password
  1428. # * cinder_store_project_domain_name
  1429. # * cinder_store_user_domain_name
  1430. # * cinder_catalog_info
  1431. #
  1432. # (string value)
  1433. #cinder_endpoint_template = <None>
  1434.  
  1435. #
  1436. # Region name to lookup cinder service from the service catalog.
  1437. #
  1438. # This is used only when ``cinder_catalog_info`` is used for determining the
  1439. # endpoint. If set, the lookup for cinder endpoint by this node is filtered to
  1440. # the specified region. It is useful when multiple regions are listed in the
  1441. # catalog. If this is not set, the endpoint is looked up from every region.
  1442. #
  1443. # Possible values:
  1444. # * A string that is a valid region name.
  1445. #
  1446. # Related options:
  1447. # * cinder_catalog_info
  1448. #
  1449. # (string value)
  1450. # Deprecated group/name - [cinder]/os_region_name
  1451. #cinder_os_region_name = <None>
  1452.  
  1453. #
  1454. # Location of a CA certificates file used for cinder client requests.
  1455. #
  1456. # The specified CA certificates file, if set, is used to verify cinder
  1457. # connections via HTTPS endpoint. If the endpoint is HTTP, this value is
  1458. # ignored.
  1459. # ``cinder_api_insecure`` must be set to ``True`` to enable the verification.
  1460. #
  1461. # Possible values:
  1462. # * Path to a ca certificates file
  1463. #
  1464. # Related options:
  1465. # * cinder_api_insecure
  1466. #
  1467. # (string value)
  1468. #cinder_ca_certificates_file = <None>
  1469.  
  1470. #
  1471. # Number of cinderclient retries on failed http calls.
  1472. #
  1473. # When a call failed by any errors, cinderclient will retry the call up to the
  1474. # specified times after sleeping a few seconds.
  1475. #
  1476. # Possible values:
  1477. # * A positive integer
  1478. #
  1479. # Related options:
  1480. # * None
  1481. #
  1482. # (integer value)
  1483. # Minimum value: 0
  1484. #cinder_http_retries = 3
  1485.  
  1486. #
  1487. # Time period, in seconds, to wait for a cinder volume transition to
  1488. # complete.
  1489. #
  1490. # When the cinder volume is created, deleted, or attached to the glance node to
  1491. # read/write the volume data, the volume's state is changed. For example, the
  1492. # newly created volume status changes from ``creating`` to ``available`` after
  1493. # the creation process is completed. This specifies the maximum time to wait for
  1494. # the status change. If a timeout occurs while waiting, or the status is changed
  1495. # to an unexpected value (e.g. `error``), the image creation fails.
  1496. #
  1497. # Possible values:
  1498. # * A positive integer
  1499. #
  1500. # Related options:
  1501. # * None
  1502. #
  1503. # (integer value)
  1504. # Minimum value: 0
  1505. #cinder_state_transition_timeout = 300
  1506.  
  1507. #
  1508. # Allow to perform insecure SSL requests to cinder.
  1509. #
  1510. # If this option is set to True, HTTPS endpoint connection is verified using the
  1511. # CA certificates file specified by ``cinder_ca_certificates_file`` option.
  1512. #
  1513. # Possible values:
  1514. # * True
  1515. # * False
  1516. #
  1517. # Related options:
  1518. # * cinder_ca_certificates_file
  1519. #
  1520. # (boolean value)
  1521. #cinder_api_insecure = false
  1522.  
  1523. #
  1524. # The address where the cinder authentication service is listening.
  1525. #
  1526. # When all of ``cinder_store_auth_address``, ``cinder_store_user_name``,
  1527. # ``cinder_store_project_name``, and ``cinder_store_password`` options are
  1528. # specified, the specified values are always used for the authentication.
  1529. # This is useful to hide the image volumes from users by storing them in a
  1530. # project/tenant specific to the image service. It also enables users to share
  1531. # the image volume among other projects under the control of glance's ACL.
  1532. #
  1533. # If either of these options are not set, the cinder endpoint is looked up
  1534. # from the service catalog, and current context's user and project are used.
  1535. #
  1536. # Possible values:
  1537. # * A valid authentication service address, for example:
  1538. # ``http://openstack.example.org/identity/v2.0``
  1539. #
  1540. # Related options:
  1541. # * cinder_store_user_name
  1542. # * cinder_store_password
  1543. # * cinder_store_project_name
  1544. # * cinder_store_project_domain_name
  1545. # * cinder_store_user_domain_name
  1546. #
  1547. # (string value)
  1548. #cinder_store_auth_address = <None>
  1549.  
  1550. #
  1551. # User name to authenticate against cinder.
  1552. #
  1553. # This must be used with all the following non-domain-related options.
  1554. # If any of these are not specified (except domain-related options),
  1555. # the user of the current context is used.
  1556. #
  1557. # Possible values:
  1558. # * A valid user name
  1559. #
  1560. # Related options:
  1561. # * cinder_store_auth_address
  1562. # * cinder_store_password
  1563. # * cinder_store_project_name
  1564. # * cinder_store_project_domain_name
  1565. # * cinder_store_user_domain_name
  1566. #
  1567. # (string value)
  1568. #cinder_store_user_name = <None>
  1569.  
  1570. #
  1571. # Domain of the user to authenticate against cinder.
  1572. #
  1573. # Possible values:
  1574. # * A valid domain name for the user specified by ``cinder_store_user_name``
  1575. #
  1576. # Related options:
  1577. # * cinder_store_auth_address
  1578. # * cinder_store_password
  1579. # * cinder_store_project_name
  1580. # * cinder_store_project_domain_name
  1581. # * cinder_store_user_name
  1582. #
  1583. # (string value)
  1584. #cinder_store_user_domain_name = Default
  1585.  
  1586. #
  1587. # Password for the user authenticating against cinder.
  1588. #
  1589. # This must be used with all the following related options.
  1590. # If any of these are not specified (except domain-related options),
  1591. # the user of the current context is used.
  1592. #
  1593. # Possible values:
  1594. # * A valid password for the user specified by ``cinder_store_user_name``
  1595. #
  1596. # Related options:
  1597. # * cinder_store_auth_address
  1598. # * cinder_store_user_name
  1599. # * cinder_store_project_name
  1600. # * cinder_store_project_domain_name
  1601. # * cinder_store_user_domain_name
  1602. #
  1603. # (string value)
  1604. #cinder_store_password = <None>
  1605.  
  1606. #
  1607. # Project name where the image volume is stored in cinder.
  1608. #
  1609. # If this configuration option is not set, the project in current context is
  1610. # used.
  1611. #
  1612. # This must be used with all the following related options.
  1613. # If any of these are not specified (except domain-related options),
  1614. # the user of the current context is used.
  1615. #
  1616. # Possible values:
  1617. # * A valid project name
  1618. #
  1619. # Related options:
  1620. # * ``cinder_store_auth_address``
  1621. # * ``cinder_store_user_name``
  1622. # * ``cinder_store_password``
  1623. # * ``cinder_store_project_domain_name``
  1624. # * ``cinder_store_user_domain_name``
  1625. #
  1626. # (string value)
  1627. #cinder_store_project_name = <None>
  1628.  
  1629. #
  1630. # Domain of the project where the image volume is stored in cinder.
  1631. #
  1632. # Possible values:
  1633. # * A valid domain name of the project specified by
  1634. # ``cinder_store_project_name``
  1635. #
  1636. # Related options:
  1637. # * ``cinder_store_auth_address``
  1638. # * ``cinder_store_user_name``
  1639. # * ``cinder_store_password``
  1640. # * ``cinder_store_project_domain_name``
  1641. # * ``cinder_store_user_domain_name``
  1642. #
  1643. # (string value)
  1644. #cinder_store_project_domain_name = Default
  1645.  
  1646. #
  1647. # Path to the rootwrap configuration file to use for running commands as root.
  1648. #
  1649. # The cinder store requires root privileges to operate the image volumes (for
  1650. # connecting to iSCSI/FC volumes and reading/writing the volume data, etc.).
  1651. # The configuration file should allow the required commands by cinder store and
  1652. # os-brick library.
  1653. #
  1654. # Possible values:
  1655. # * Path to the rootwrap config file
  1656. #
  1657. # Related options:
  1658. # * None
  1659. #
  1660. # (string value)
  1661. #rootwrap_config = /etc/glance/rootwrap.conf
  1662.  
  1663. #
  1664. # Volume type that will be used for volume creation in cinder.
  1665. #
  1666. # Some cinder backends can have several volume types to optimize storage usage.
  1667. # Adding this option allows an operator to choose a specific volume type
  1668. # in cinder that can be optimized for images.
  1669. #
  1670. # If this is not set, then the default volume type specified in the cinder
  1671. # configuration will be used for volume creation.
  1672. #
  1673. # Possible values:
  1674. # * A valid volume type from cinder
  1675. #
  1676. # Related options:
  1677. # * None
  1678. #
  1679. # NOTE: You cannot use an encrypted volume_type associated with an NFS backend.
  1680. # An encrypted volume stored on an NFS backend will raise an exception whenever
  1681. # glance_store tries to write or access image data stored in that volume.
  1682. # Consult your Cinder administrator to determine an appropriate volume_type.
  1683. #
  1684. # (string value)
  1685. #cinder_volume_type = <None>
  1686.  
  1687. #
  1688. # If this is set to True, attachment of volumes for image transfer will
  1689. # be aborted when multipathd is not running. Otherwise, it will fallback
  1690. # to single path.
  1691. #
  1692. # Possible values:
  1693. # * True or False
  1694. #
  1695. # Related options:
  1696. # * cinder_use_multipath
  1697. #
  1698. # (boolean value)
  1699. #cinder_enforce_multipath = false
  1700.  
  1701. #
  1702. # Flag to identify multipath is supported or not in the deployment.
  1703. #
  1704. # Set it to False if multipath is not supported.
  1705. #
  1706. # Possible values:
  1707. # * True or False
  1708. #
  1709. # Related options:
  1710. # * cinder_enforce_multipath
  1711. #
  1712. # (boolean value)
  1713. #cinder_use_multipath = false
  1714.  
  1715. #
  1716. # Directory where the NFS volume is mounted on the glance node.
  1717. #
  1718. # Possible values:
  1719. #
  1720. # * A string representing absolute path of mount point.
  1721. # (string value)
  1722. #cinder_mount_point_base = /var/lib/glance/mnt
  1723.  
  1724. #
  1725. # If this is set to True, glance will perform an extend operation
  1726. # on the attached volume. Only enable this option if the cinder
  1727. # backend driver supports the functionality of extending online
  1728. # (in-use) volumes. Supported from cinder microversion 3.42 and
  1729. # onwards. By default, it is set to False.
  1730. #
  1731. # Possible values:
  1732. # * True or False
  1733. #
  1734. # (boolean value)
  1735. #cinder_do_extend_attached = false
  1736.  
  1737.  
  1738. [cors]
  1739.  
  1740. #
  1741. # From oslo.middleware.cors
  1742. #
  1743.  
  1744. # Indicate whether this resource may be shared with the domain received in the
  1745. # requests "origin" header. Format: "<protocol>://<host>[:<port>]", no trailing
  1746. # slash. Example: https://horizon.example.com (list value)
  1747. #allowed_origin = <None>
  1748.  
  1749. # Indicate that the actual request can include user credentials (boolean value)
  1750. #allow_credentials = true
  1751.  
  1752. # Indicate which headers are safe to expose to the API. Defaults to HTTP Simple
  1753. # Headers. (list value)
  1754. #expose_headers = X-Image-Meta-Checksum,X-Auth-Token,X-Subject-Token,X-Service-Token,X-OpenStack-Request-ID
  1755.  
  1756. # Maximum cache age of CORS preflight requests. (integer value)
  1757. #max_age = 3600
  1758.  
  1759. # Indicate which methods can be used during the actual request. (list value)
  1760. #allow_methods = GET,PUT,POST,DELETE,PATCH
  1761.  
  1762. # Indicate which header field names may be used during the actual request. (list
  1763. # value)
  1764. #allow_headers = Content-MD5,X-Image-Meta-Checksum,X-Storage-Token,Accept-Encoding,X-Auth-Token,X-Identity-Status,X-Roles,X-Service-Catalog,X-User-Id,X-Tenant-Id,X-OpenStack-Request-ID
  1765.  
  1766.  
  1767. [database]
  1768. # connection = sqlite:////var/lib/glance/glance.sqlite
  1769. connection = mysql+pymysql://glance:my_password@rwcosc1/glance
  1770. backend = sqlalchemy
  1771.  
  1772. #
  1773. # From oslo.db
  1774. #
  1775.  
  1776. # If True, SQLite uses synchronous mode. (boolean value)
  1777. #sqlite_synchronous = true
  1778.  
  1779. # The back end to use for the database. (string value)
  1780. # Deprecated group/name - [DEFAULT]/db_backend
  1781. #backend = sqlalchemy
  1782.  
  1783. # The SQLAlchemy connection string to use to connect to the database. (string
  1784. # value)
  1785. # Deprecated group/name - [DEFAULT]/sql_connection
  1786. # Deprecated group/name - [DATABASE]/sql_connection
  1787. # Deprecated group/name - [sql]/connection
  1788. #connection = <None>
  1789.  
  1790. # The SQLAlchemy connection string to use to connect to the slave database.
  1791. # (string value)
  1792. #slave_connection = <None>
  1793.  
  1794. # The SQL mode to be used for MySQL sessions. This option, including the
  1795. # default, overrides any server-set SQL mode. To use whatever SQL mode is set by
  1796. # the server configuration, set this to no value. Example: mysql_sql_mode=
  1797. # (string value)
  1798. #mysql_sql_mode = TRADITIONAL
  1799.  
  1800. # For Galera only, configure wsrep_sync_wait causality checks on new
  1801. # connections. Default is None, meaning don't configure any setting. (integer
  1802. # value)
  1803. #mysql_wsrep_sync_wait = <None>
  1804.  
  1805. # Connections which have been present in the connection pool longer than this
  1806. # number of seconds will be replaced with a new one the next time they are
  1807. # checked out from the pool. (integer value)
  1808. #connection_recycle_time = 3600
  1809.  
  1810. # Maximum number of SQL connections to keep open in a pool. Setting a value of 0
  1811. # indicates no limit. (integer value)
  1812. #max_pool_size = 5
  1813.  
  1814. # Maximum number of database connection retries during startup. Set to -1 to
  1815. # specify an infinite retry count. (integer value)
  1816. # Deprecated group/name - [DEFAULT]/sql_max_retries
  1817. # Deprecated group/name - [DATABASE]/sql_max_retries
  1818. #max_retries = 10
  1819.  
  1820. # Interval between retries of opening a SQL connection. (integer value)
  1821. # Deprecated group/name - [DEFAULT]/sql_retry_interval
  1822. # Deprecated group/name - [DATABASE]/reconnect_interval
  1823. #retry_interval = 10
  1824.  
  1825. # If set, use this value for max_overflow with SQLAlchemy. (integer value)
  1826. # Deprecated group/name - [DEFAULT]/sql_max_overflow
  1827. # Deprecated group/name - [DATABASE]/sqlalchemy_max_overflow
  1828. #max_overflow = 50
  1829.  
  1830. # Verbosity of SQL debugging information: 0=None, 100=Everything. (integer
  1831. # value)
  1832. # Minimum value: 0
  1833. # Maximum value: 100
  1834. # Deprecated group/name - [DEFAULT]/sql_connection_debug
  1835. #connection_debug = 0
  1836.  
  1837. # Add Python stack traces to SQL as comment strings. (boolean value)
  1838. # Deprecated group/name - [DEFAULT]/sql_connection_trace
  1839. #connection_trace = false
  1840.  
  1841. # If set, use this value for pool_timeout with SQLAlchemy. (integer value)
  1842. # Deprecated group/name - [DATABASE]/sqlalchemy_pool_timeout
  1843. #pool_timeout = <None>
  1844.  
  1845. # Enable the experimental use of database reconnect on connection lost. (boolean
  1846. # value)
  1847. #use_db_reconnect = false
  1848.  
  1849. # Seconds between retries of a database transaction. (integer value)
  1850. #db_retry_interval = 1
  1851.  
  1852. # If True, increases the interval between retries of a database operation up to
  1853. # db_max_retry_interval. (boolean value)
  1854. #db_inc_retry_interval = true
  1855.  
  1856. # If db_inc_retry_interval is set, the maximum seconds between retries of a
  1857. # database operation. (integer value)
  1858. #db_max_retry_interval = 10
  1859.  
  1860. # Maximum retries in case of connection error or deadlock error before error is
  1861. # raised. Set to -1 to specify an infinite retry count. (integer value)
  1862. #db_max_retries = 20
  1863.  
  1864. # Optional URL parameters to append onto the connection URL at connect time;
  1865. # specify as param1=value1&param2=value2&... (string value)
  1866. #connection_parameters =
  1867.  
  1868.  
  1869. [file]
  1870.  
  1871. #
  1872. # From glance.multi_store
  1873. #
  1874.  
  1875. #
  1876. # Directory to which the filesystem backend store writes images.
  1877. #
  1878. # Upon start up, Glance creates the directory if it doesn't already
  1879. # exist and verifies write access to the user under which
  1880. # ``glance-api`` runs. If the write access isn't available, a
  1881. # ``BadStoreConfiguration`` exception is raised and the filesystem
  1882. # store may not be available for adding new images.
  1883. #
  1884. # NOTE: This directory is used only when filesystem store is used as a
  1885. # storage backend. Either ``filesystem_store_datadir`` or
  1886. # ``filesystem_store_datadirs`` option must be specified in
  1887. # ``glance-api.conf``. If both options are specified, a
  1888. # ``BadStoreConfiguration`` will be raised and the filesystem store
  1889. # may not be available for adding new images.
  1890. #
  1891. # Possible values:
  1892. # * A valid path to a directory
  1893. #
  1894. # Related options:
  1895. # * ``filesystem_store_datadirs``
  1896. # * ``filesystem_store_file_perm``
  1897. #
  1898. # (string value)
  1899. #filesystem_store_datadir = /var/lib/glance/images
  1900.  
  1901. #
  1902. # List of directories and their priorities to which the filesystem
  1903. # backend store writes images.
  1904. #
  1905. # The filesystem store can be configured to store images in multiple
  1906. # directories as opposed to using a single directory specified by the
  1907. # ``filesystem_store_datadir`` configuration option. When using
  1908. # multiple directories, each directory can be given an optional
  1909. # priority to specify the preference order in which they should
  1910. # be used. Priority is an integer that is concatenated to the
  1911. # directory path with a colon where a higher value indicates higher
  1912. # priority. When two directories have the same priority, the directory
  1913. # with most free space is used. When no priority is specified, it
  1914. # defaults to zero.
  1915. #
  1916. # More information on configuring filesystem store with multiple store
  1917. # directories can be found at
  1918. # https://docs.openstack.org/glance/latest/configuration/configuring.html
  1919. #
  1920. # NOTE: This directory is used only when filesystem store is used as a
  1921. # storage backend. Either ``filesystem_store_datadir`` or
  1922. # ``filesystem_store_datadirs`` option must be specified in
  1923. # ``glance-api.conf``. If both options are specified, a
  1924. # ``BadStoreConfiguration`` will be raised and the filesystem store
  1925. # may not be available for adding new images.
  1926. #
  1927. # Possible values:
  1928. # * List of strings of the following form:
  1929. # * ``<a valid directory path>:<optional integer priority>``
  1930. #
  1931. # Related options:
  1932. # * ``filesystem_store_datadir``
  1933. # * ``filesystem_store_file_perm``
  1934. #
  1935. # (multi valued)
  1936. #filesystem_store_datadirs =
  1937.  
  1938. #
  1939. # Filesystem store metadata file.
  1940. #
  1941. # The path to a file which contains the metadata to be returned with any
  1942. # location
  1943. # associated with the filesystem store. Once this option is set, it is used for
  1944. # new images created afterward only - previously existing images are not
  1945. # affected.
  1946. #
  1947. # The file must contain a valid JSON object. The object should contain the keys
  1948. # ``id`` and ``mountpoint``. The value for both keys should be a string.
  1949. #
  1950. # Possible values:
  1951. # * A valid path to the store metadata file
  1952. #
  1953. # Related options:
  1954. # * None
  1955. #
  1956. # (string value)
  1957. #filesystem_store_metadata_file = <None>
  1958.  
  1959. #
  1960. # File access permissions for the image files.
  1961. #
  1962. # Set the intended file access permissions for image data. This provides
  1963. # a way to enable other services, e.g. Nova, to consume images directly
  1964. # from the filesystem store. The users running the services that are
  1965. # intended to be given access to could be made a member of the group
  1966. # that owns the files created. Assigning a value less then or equal to
  1967. # zero for this configuration option signifies that no changes be made
  1968. # to the default permissions. This value will be decoded as an octal
  1969. # digit.
  1970. #
  1971. # For more information, please refer the documentation at
  1972. # https://docs.openstack.org/glance/latest/configuration/configuring.html
  1973. #
  1974. # Possible values:
  1975. # * A valid file access permission
  1976. # * Zero
  1977. # * Any negative integer
  1978. #
  1979. # Related options:
  1980. # * None
  1981. #
  1982. # (integer value)
  1983. #filesystem_store_file_perm = 0
  1984.  
  1985. #
  1986. # Chunk size, in bytes.
  1987. #
  1988. # The chunk size used when reading or writing image files. Raising this value
  1989. # may improve the throughput but it may also slightly increase the memory usage
  1990. # when handling a large number of requests.
  1991. #
  1992. # Possible Values:
  1993. # * Any positive integer value
  1994. #
  1995. # Related options:
  1996. # * None
  1997. #
  1998. # (integer value)
  1999. # Minimum value: 1
  2000. #filesystem_store_chunk_size = 65536
  2001.  
  2002. #
  2003. # Enable or not thin provisioning in this backend.
  2004. #
  2005. # This configuration option enable the feature of not really write null byte
  2006. # sequences on the filesystem, the holes who can appear will automatically
  2007. # be interpreted by the filesystem as null bytes, and do not really consume
  2008. # your storage.
  2009. # Enabling this feature will also speed up image upload and save network traffic
  2010. # in addition to save space in the backend, as null bytes sequences are not
  2011. # sent over the network.
  2012. #
  2013. # Possible Values:
  2014. # * True
  2015. # * False
  2016. #
  2017. # Related options:
  2018. # * None
  2019. #
  2020. # (boolean value)
  2021. #filesystem_thin_provisioning = false
  2022.  
  2023.  
  2024. [glance.store.http.store]
  2025.  
  2026. #
  2027. # From glance.multi_store
  2028. #
  2029.  
  2030. #
  2031. # Path to the CA bundle file.
  2032. #
  2033. # This configuration option enables the operator to use a custom
  2034. # Certificate Authority file to verify the remote server certificate. If
  2035. # this option is set, the ``https_insecure`` option will be ignored and
  2036. # the CA file specified will be used to authenticate the server
  2037. # certificate and establish a secure connection to the server.
  2038. #
  2039. # Possible values:
  2040. # * A valid path to a CA file
  2041. #
  2042. # Related options:
  2043. # * https_insecure
  2044. #
  2045. # (string value)
  2046. #https_ca_certificates_file = <None>
  2047.  
  2048. #
  2049. # Set verification of the remote server certificate.
  2050. #
  2051. # This configuration option takes in a boolean value to determine
  2052. # whether or not to verify the remote server certificate. If set to
  2053. # True, the remote server certificate is not verified. If the option is
  2054. # set to False, then the default CA truststore is used for verification.
  2055. #
  2056. # This option is ignored if ``https_ca_certificates_file`` is set.
  2057. # The remote server certificate will then be verified using the file
  2058. # specified using the ``https_ca_certificates_file`` option.
  2059. #
  2060. # Possible values:
  2061. # * True
  2062. # * False
  2063. #
  2064. # Related options:
  2065. # * https_ca_certificates_file
  2066. #
  2067. # (boolean value)
  2068. #https_insecure = true
  2069.  
  2070. #
  2071. # The http/https proxy information to be used to connect to the remote
  2072. # server.
  2073. #
  2074. # This configuration option specifies the http/https proxy information
  2075. # that should be used to connect to the remote server. The proxy
  2076. # information should be a key value pair of the scheme and proxy, for
  2077. # example, http:10.0.0.1:3128. You can also specify proxies for multiple
  2078. # schemes by separating the key value pairs with a comma, for example,
  2079. # http:10.0.0.1:3128, https:10.0.0.1:1080.
  2080. #
  2081. # Possible values:
  2082. # * A comma separated list of scheme:proxy pairs as described above
  2083. #
  2084. # Related options:
  2085. # * None
  2086. #
  2087. # (dict value)
  2088. #http_proxy_information =
  2089.  
  2090.  
  2091. [glance.store.rbd.store]
  2092.  
  2093. #
  2094. # From glance.multi_store
  2095. #
  2096.  
  2097. #
  2098. # Size, in megabytes, to chunk RADOS images into.
  2099. #
  2100. # Provide an integer value representing the size in megabytes to chunk
  2101. # Glance images into. The default chunk size is 8 megabytes. For optimal
  2102. # performance, the value should be a power of two.
  2103. #
  2104. # When Ceph's RBD object storage system is used as the storage backend
  2105. # for storing Glance images, the images are chunked into objects of the
  2106. # size set using this option. These chunked objects are then stored
  2107. # across the distributed block data store to use for Glance.
  2108. #
  2109. # Possible Values:
  2110. # * Any positive integer value
  2111. #
  2112. # Related options:
  2113. # * None
  2114. #
  2115. # (integer value)
  2116. # Minimum value: 1
  2117. #rbd_store_chunk_size = 8
  2118.  
  2119. #
  2120. # RADOS pool in which images are stored.
  2121. #
  2122. # When RBD is used as the storage backend for storing Glance images, the
  2123. # images are stored by means of logical grouping of the objects (chunks
  2124. # of images) into a ``pool``. Each pool is defined with the number of
  2125. # placement groups it can contain. The default pool that is used is
  2126. # 'images'.
  2127. #
  2128. # More information on the RBD storage backend can be found here:
  2129. # http://ceph.com/planet/how-data-is-stored-in-ceph-cluster/
  2130. #
  2131. # Possible Values:
  2132. # * A valid pool name
  2133. #
  2134. # Related options:
  2135. # * None
  2136. #
  2137. # (string value)
  2138. #rbd_store_pool = images
  2139.  
  2140. #
  2141. # RADOS user to authenticate as.
  2142. #
  2143. # This configuration option takes in the RADOS user to authenticate as.
  2144. # This is only needed when RADOS authentication is enabled and is
  2145. # applicable only if the user is using Cephx authentication. If the
  2146. # value for this option is not set by the user or is set to None, a
  2147. # default value will be chosen, which will be based on the client.
  2148. # section in rbd_store_ceph_conf.
  2149. #
  2150. # Possible Values:
  2151. # * A valid RADOS user
  2152. #
  2153. # Related options:
  2154. # * rbd_store_ceph_conf
  2155. #
  2156. # (string value)
  2157. #rbd_store_user = <None>
  2158.  
  2159. #
  2160. # Ceph configuration file path.
  2161. #
  2162. # This configuration option specifies the path to the Ceph configuration
  2163. # file to be used. If the value for this option is not set by the user
  2164. # or is set to the empty string, librados will read the standard ceph.conf
  2165. # file by searching the default Ceph configuration file locations in
  2166. # sequential order. See the Ceph documentation for details.
  2167. #
  2168. # NOTE: If using Cephx authentication, this file should include a reference
  2169. # to the right keyring in a client.<USER> section
  2170. #
  2171. # NOTE 2: If you leave this option empty (the default), the actual Ceph
  2172. # configuration file used may change depending on what version of librados
  2173. # is being used. If it is important for you to know exactly which configuration
  2174. # file is in effect, you may specify that file here using this option.
  2175. #
  2176. # Possible Values:
  2177. # * A valid path to a configuration file
  2178. #
  2179. # Related options:
  2180. # * rbd_store_user
  2181. #
  2182. # (string value)
  2183. #rbd_store_ceph_conf =
  2184.  
  2185. #
  2186. # Timeout value for connecting to Ceph cluster.
  2187. #
  2188. # This configuration option takes in the timeout value in seconds used
  2189. # when connecting to the Ceph cluster i.e. it sets the time to wait for
  2190. # glance-api before closing the connection. This prevents glance-api
  2191. # hangups during the connection to RBD. If the value for this option
  2192. # is set to less than 0, no timeout is set and the default librados value
  2193. # is used.
  2194. #
  2195. # Possible Values:
  2196. # * Any integer value
  2197. #
  2198. # Related options:
  2199. # * None
  2200. #
  2201. # (integer value)
  2202. #rados_connect_timeout = -1
  2203.  
  2204. #
  2205. # Enable or not thin provisioning in this backend.
  2206. #
  2207. # This configuration option enable the feature of not really write null byte
  2208. # sequences on the RBD backend, the holes who can appear will automatically
  2209. # be interpreted by Ceph as null bytes, and do not really consume your storage.
  2210. # Enabling this feature will also speed up image upload and save network traffic
  2211. # in addition to save space in the backend, as null bytes sequences are not
  2212. # sent over the network.
  2213. #
  2214. # Possible Values:
  2215. # * True
  2216. # * False
  2217. #
  2218. # Related options:
  2219. # * None
  2220. #
  2221. # (boolean value)
  2222. #rbd_thin_provisioning = false
  2223.  
  2224.  
  2225. [glance.store.s3.store]
  2226.  
  2227. #
  2228. # From glance.multi_store
  2229. #
  2230.  
  2231. #
  2232. # The host where the S3 server is listening.
  2233. #
  2234. # This configuration option sets the host of the S3 or S3 compatible storage
  2235. # Server. This option is required when using the S3 storage backend.
  2236. # The host can contain a DNS name (e.g. s3.amazonaws.com, my-object-storage.com)
  2237. # or an IP address (127.0.0.1).
  2238. #
  2239. # Possible values:
  2240. # * A valid DNS name
  2241. # * A valid IPv4 address
  2242. #
  2243. # Related Options:
  2244. # * s3_store_access_key
  2245. # * s3_store_secret_key
  2246. #
  2247. # (string value)
  2248. #s3_store_host = <None>
  2249.  
  2250. #
  2251. # The S3 region name.
  2252. #
  2253. # This parameter will set the region_name used by boto.
  2254. # If this parameter is not set, we we will try to compute it from the
  2255. # s3_store_host.
  2256. #
  2257. # Possible values:
  2258. # * A valid region name
  2259. #
  2260. # Related Options:
  2261. # * s3_store_host
  2262. #
  2263. # (string value)
  2264. #s3_store_region_name =
  2265.  
  2266. #
  2267. # The S3 query token access key.
  2268. #
  2269. # This configuration option takes the access key for authenticating with the
  2270. # Amazon S3 or S3 compatible storage server. This option is required when using
  2271. # the S3 storage backend.
  2272. #
  2273. # Possible values:
  2274. # * Any string value that is the access key for a user with appropriate
  2275. # privileges
  2276. #
  2277. # Related Options:
  2278. # * s3_store_host
  2279. # * s3_store_secret_key
  2280. #
  2281. # (string value)
  2282. #s3_store_access_key = <None>
  2283.  
  2284. #
  2285. # The S3 query token secret key.
  2286. #
  2287. # This configuration option takes the secret key for authenticating with the
  2288. # Amazon S3 or S3 compatible storage server. This option is required when using
  2289. # the S3 storage backend.
  2290. #
  2291. # Possible values:
  2292. # * Any string value that is a secret key corresponding to the access key
  2293. # specified using the ``s3_store_host`` option
  2294. #
  2295. # Related Options:
  2296. # * s3_store_host
  2297. # * s3_store_access_key
  2298. #
  2299. # (string value)
  2300. #s3_store_secret_key = <None>
  2301.  
  2302. #
  2303. # The S3 bucket to be used to store the Glance data.
  2304. #
  2305. # This configuration option specifies where the glance images will be stored
  2306. # in the S3. If ``s3_store_create_bucket_on_put`` is set to true, it will be
  2307. # created automatically even if the bucket does not exist.
  2308. #
  2309. # Possible values:
  2310. # * Any string value
  2311. #
  2312. # Related Options:
  2313. # * s3_store_create_bucket_on_put
  2314. # * s3_store_bucket_url_format
  2315. #
  2316. # (string value)
  2317. #s3_store_bucket = <None>
  2318.  
  2319. #
  2320. # Determine whether S3 should create a new bucket.
  2321. #
  2322. # This configuration option takes boolean value to indicate whether Glance
  2323. # should
  2324. # create a new bucket to S3 if it does not exist.
  2325. #
  2326. # Possible values:
  2327. # * Any Boolean value
  2328. #
  2329. # Related Options:
  2330. # * None
  2331. #
  2332. # (boolean value)
  2333. #s3_store_create_bucket_on_put = false
  2334.  
  2335. #
  2336. # The S3 calling format used to determine the object.
  2337. #
  2338. # This configuration option takes access model that is used to specify the
  2339. # address of an object in an S3 bucket.
  2340. #
  2341. # NOTE:
  2342. # In ``path``-style, the endpoint for the object looks like
  2343. # 'https://s3.amazonaws.com/bucket/example.img'.
  2344. # And in ``virtual``-style, the endpoint for the object looks like
  2345. # 'https://bucket.s3.amazonaws.com/example.img'.
  2346. # If you do not follow the DNS naming convention in the bucket name, you can
  2347. # get objects in the path style, but not in the virtual style.
  2348. #
  2349. # Possible values:
  2350. # * Any string value of ``auto``, ``virtual``, or ``path``
  2351. #
  2352. # Related Options:
  2353. # * s3_store_bucket
  2354. #
  2355. # (string value)
  2356. #s3_store_bucket_url_format = auto
  2357.  
  2358. #
  2359. # What size, in MB, should S3 start chunking image files and do a multipart
  2360. # upload in S3.
  2361. #
  2362. # This configuration option takes a threshold in MB to determine whether to
  2363. # upload the image to S3 as is or to split it (Multipart Upload).
  2364. #
  2365. # Note: You can only split up to 10,000 images.
  2366. #
  2367. # Possible values:
  2368. # * Any positive integer value
  2369. #
  2370. # Related Options:
  2371. # * s3_store_large_object_chunk_size
  2372. # * s3_store_thread_pools
  2373. #
  2374. # (integer value)
  2375. #s3_store_large_object_size = 100
  2376.  
  2377. #
  2378. # What multipart upload part size, in MB, should S3 use when uploading parts.
  2379. #
  2380. # This configuration option takes the image split size in MB for Multipart
  2381. # Upload.
  2382. #
  2383. # Note: You can only split up to 10,000 images.
  2384. #
  2385. # Possible values:
  2386. # * Any positive integer value (must be greater than or equal to 5M)
  2387. #
  2388. # Related Options:
  2389. # * s3_store_large_object_size
  2390. # * s3_store_thread_pools
  2391. #
  2392. # (integer value)
  2393. #s3_store_large_object_chunk_size = 10
  2394.  
  2395. #
  2396. # The number of thread pools to perform a multipart upload in S3.
  2397. #
  2398. # This configuration option takes the number of thread pools when performing a
  2399. # Multipart Upload.
  2400. #
  2401. # Possible values:
  2402. # * Any positive integer value
  2403. #
  2404. # Related Options:
  2405. # * s3_store_large_object_size
  2406. # * s3_store_large_object_chunk_size
  2407. #
  2408. # (integer value)
  2409. #s3_store_thread_pools = 10
  2410.  
  2411.  
  2412. [glance.store.swift.store]
  2413.  
  2414. #
  2415. # From glance.multi_store
  2416. #
  2417.  
  2418. #
  2419. # Set verification of the server certificate.
  2420. #
  2421. # This boolean determines whether or not to verify the server
  2422. # certificate. If this option is set to True, swiftclient won't check
  2423. # for a valid SSL certificate when authenticating. If the option is set
  2424. # to False, then the default CA truststore is used for verification.
  2425. #
  2426. # Possible values:
  2427. # * True
  2428. # * False
  2429. #
  2430. # Related options:
  2431. # * swift_store_cacert
  2432. #
  2433. # (boolean value)
  2434. #swift_store_auth_insecure = false
  2435.  
  2436. #
  2437. # Path to the CA bundle file.
  2438. #
  2439. # This configuration option enables the operator to specify the path to
  2440. # a custom Certificate Authority file for SSL verification when
  2441. # connecting to Swift.
  2442. #
  2443. # Possible values:
  2444. # * A valid path to a CA file
  2445. #
  2446. # Related options:
  2447. # * swift_store_auth_insecure
  2448. #
  2449. # (string value)
  2450. #
  2451. # This option has a sample default set, which means that
  2452. # its actual default value may vary from the one documented
  2453. # below.
  2454. #swift_store_cacert = /etc/ssl/certs/ca-certificates.crt
  2455.  
  2456. #
  2457. # The region of Swift endpoint to use by Glance.
  2458. #
  2459. # Provide a string value representing a Swift region where Glance
  2460. # can connect to for image storage. By default, there is no region
  2461. # set.
  2462. #
  2463. # When Glance uses Swift as the storage backend to store images
  2464. # for a specific tenant that has multiple endpoints, setting of a
  2465. # Swift region with ``swift_store_region`` allows Glance to connect
  2466. # to Swift in the specified region as opposed to a single region
  2467. # connectivity.
  2468. #
  2469. # This option can be configured for both single-tenant and
  2470. # multi-tenant storage.
  2471. #
  2472. # NOTE: Setting the region with ``swift_store_region`` is
  2473. # tenant-specific and is necessary ``only if`` the tenant has
  2474. # multiple endpoints across different regions.
  2475. #
  2476. # Possible values:
  2477. # * A string value representing a valid Swift region.
  2478. #
  2479. # Related Options:
  2480. # * None
  2481. #
  2482. # (string value)
  2483. #
  2484. # This option has a sample default set, which means that
  2485. # its actual default value may vary from the one documented
  2486. # below.
  2487. #swift_store_region = RegionTwo
  2488.  
  2489. #
  2490. # The URL endpoint to use for Swift backend storage.
  2491. #
  2492. # Provide a string value representing the URL endpoint to use for
  2493. # storing Glance images in Swift store. By default, an endpoint
  2494. # is not set and the storage URL returned by ``auth`` is used.
  2495. # Setting an endpoint with ``swift_store_endpoint`` overrides the
  2496. # storage URL and is used for Glance image storage.
  2497. #
  2498. # NOTE: The URL should include the path up to, but excluding the
  2499. # container. The location of an object is obtained by appending
  2500. # the container and object to the configured URL.
  2501. #
  2502. # Possible values:
  2503. # * String value representing a valid URL path up to a Swift container
  2504. #
  2505. # Related Options:
  2506. # * None
  2507. #
  2508. # (string value)
  2509. #
  2510. # This option has a sample default set, which means that
  2511. # its actual default value may vary from the one documented
  2512. # below.
  2513. #swift_store_endpoint = https://swift.openstack.example.org/v1/path_not_including_container_name
  2514.  
  2515. #
  2516. # Endpoint Type of Swift service.
  2517. #
  2518. # This string value indicates the endpoint type to use to fetch the
  2519. # Swift endpoint. The endpoint type determines the actions the user will
  2520. # be allowed to perform, for instance, reading and writing to the Store.
  2521. # This setting is only used if swift_store_auth_version is greater than
  2522. # 1.
  2523. #
  2524. # Possible values:
  2525. # * publicURL
  2526. # * adminURL
  2527. # * internalURL
  2528. #
  2529. # Related options:
  2530. # * swift_store_endpoint
  2531. #
  2532. # (string value)
  2533. # Possible values:
  2534. # publicURL - <No description provided>
  2535. # adminURL - <No description provided>
  2536. # internalURL - <No description provided>
  2537. #swift_store_endpoint_type = publicURL
  2538.  
  2539. #
  2540. # Type of Swift service to use.
  2541. #
  2542. # Provide a string value representing the service type to use for
  2543. # storing images while using Swift backend storage. The default
  2544. # service type is set to ``object-store``.
  2545. #
  2546. # NOTE: If ``swift_store_auth_version`` is set to 2, the value for
  2547. # this configuration option needs to be ``object-store``. If using
  2548. # a higher version of Keystone or a different auth scheme, this
  2549. # option may be modified.
  2550. #
  2551. # Possible values:
  2552. # * A string representing a valid service type for Swift storage.
  2553. #
  2554. # Related Options:
  2555. # * None
  2556. #
  2557. # (string value)
  2558. #swift_store_service_type = object-store
  2559.  
  2560. #
  2561. # Name of single container to store images/name prefix for multiple containers
  2562. #
  2563. # When a single container is being used to store images, this configuration
  2564. # option indicates the container within the Glance account to be used for
  2565. # storing all images. When multiple containers are used to store images, this
  2566. # will be the name prefix for all containers. Usage of single/multiple
  2567. # containers can be controlled using the configuration option
  2568. # ``swift_store_multiple_containers_seed``.
  2569. #
  2570. # When using multiple containers, the containers will be named after the value
  2571. # set for this configuration option with the first N chars of the image UUID
  2572. # as the suffix delimited by an underscore (where N is specified by
  2573. # ``swift_store_multiple_containers_seed``).
  2574. #
  2575. # Example: if the seed is set to 3 and swift_store_container = ``glance``, then
  2576. # an image with UUID ``fdae39a1-bac5-4238-aba4-69bcc726e848`` would be placed in
  2577. # the container ``glance_fda``. All dashes in the UUID are included when
  2578. # creating the container name but do not count toward the character limit, so
  2579. # when N=10 the container name would be ``glance_fdae39a1-ba.``
  2580. #
  2581. # Possible values:
  2582. # * If using single container, this configuration option can be any string
  2583. # that is a valid swift container name in Glance's Swift account
  2584. # * If using multiple containers, this configuration option can be any
  2585. # string as long as it satisfies the container naming rules enforced by
  2586. # Swift. The value of ``swift_store_multiple_containers_seed`` should be
  2587. # taken into account as well.
  2588. #
  2589. # Related options:
  2590. # * ``swift_store_multiple_containers_seed``
  2591. # * ``swift_store_multi_tenant``
  2592. # * ``swift_store_create_container_on_put``
  2593. #
  2594. # (string value)
  2595. #swift_store_container = glance
  2596.  
  2597. #
  2598. # The size threshold, in MB, after which Glance will start segmenting image
  2599. # data.
  2600. #
  2601. # Swift has an upper limit on the size of a single uploaded object. By default,
  2602. # this is 5GB. To upload objects bigger than this limit, objects are segmented
  2603. # into multiple smaller objects that are tied together with a manifest file.
  2604. # For more detail, refer to
  2605. # https://docs.openstack.org/swift/latest/overview_large_objects.html
  2606. #
  2607. # This configuration option specifies the size threshold over which the Swift
  2608. # driver will start segmenting image data into multiple smaller files.
  2609. # Currently, the Swift driver only supports creating Dynamic Large Objects.
  2610. #
  2611. # NOTE: This should be set by taking into account the large object limit
  2612. # enforced by the Swift cluster in consideration.
  2613. #
  2614. # Possible values:
  2615. # * A positive integer that is less than or equal to the large object limit
  2616. # enforced by the Swift cluster in consideration.
  2617. #
  2618. # Related options:
  2619. # * ``swift_store_large_object_chunk_size``
  2620. #
  2621. # (integer value)
  2622. # Minimum value: 1
  2623. #swift_store_large_object_size = 5120
  2624.  
  2625. #
  2626. # The maximum size, in MB, of the segments when image data is segmented.
  2627. #
  2628. # When image data is segmented to upload images that are larger than the limit
  2629. # enforced by the Swift cluster, image data is broken into segments that are no
  2630. # bigger than the size specified by this configuration option.
  2631. # Refer to ``swift_store_large_object_size`` for more detail.
  2632. #
  2633. # For example: if ``swift_store_large_object_size`` is 5GB and
  2634. # ``swift_store_large_object_chunk_size`` is 1GB, an image of size 6.2GB will be
  2635. # segmented into 7 segments where the first six segments will be 1GB in size and
  2636. # the seventh segment will be 0.2GB.
  2637. #
  2638. # Possible values:
  2639. # * A positive integer that is less than or equal to the large object limit
  2640. # enforced by Swift cluster in consideration.
  2641. #
  2642. # Related options:
  2643. # * ``swift_store_large_object_size``
  2644. #
  2645. # (integer value)
  2646. # Minimum value: 1
  2647. #swift_store_large_object_chunk_size = 200
  2648.  
  2649. #
  2650. # Create container, if it doesn't already exist, when uploading image.
  2651. #
  2652. # At the time of uploading an image, if the corresponding container doesn't
  2653. # exist, it will be created provided this configuration option is set to True.
  2654. # By default, it won't be created. This behavior is applicable for both single
  2655. # and multiple containers mode.
  2656. #
  2657. # Possible values:
  2658. # * True
  2659. # * False
  2660. #
  2661. # Related options:
  2662. # * None
  2663. #
  2664. # (boolean value)
  2665. #swift_store_create_container_on_put = false
  2666.  
  2667. #
  2668. # Store images in tenant's Swift account.
  2669. #
  2670. # This enables multi-tenant storage mode which causes Glance images to be stored
  2671. # in tenant specific Swift accounts. If this is disabled, Glance stores all
  2672. # images in its own account. More details multi-tenant store can be found at
  2673. # https://wiki.openstack.org/wiki/GlanceSwiftTenantSpecificStorage
  2674. #
  2675. # NOTE: If using multi-tenant swift store, please make sure
  2676. # that you do not set a swift configuration file with the
  2677. # 'swift_store_config_file' option.
  2678. #
  2679. # Possible values:
  2680. # * True
  2681. # * False
  2682. #
  2683. # Related options:
  2684. # * swift_store_config_file
  2685. #
  2686. # (boolean value)
  2687. #swift_store_multi_tenant = false
  2688.  
  2689. #
  2690. # Seed indicating the number of containers to use for storing images.
  2691. #
  2692. # When using a single-tenant store, images can be stored in one or more than one
  2693. # containers. When set to 0, all images will be stored in one single container.
  2694. # When set to an integer value between 1 and 32, multiple containers will be
  2695. # used to store images. This configuration option will determine how many
  2696. # containers are created. The total number of containers that will be used is
  2697. # equal to 16^N, so if this config option is set to 2, then 16^2=256 containers
  2698. # will be used to store images.
  2699. #
  2700. # Please refer to ``swift_store_container`` for more detail on the naming
  2701. # convention. More detail about using multiple containers can be found at
  2702. # https://specs.openstack.org/openstack/glance-specs/specs/kilo/swift-store-
  2703. # multiple-containers.html
  2704. #
  2705. # NOTE: This is used only when swift_store_multi_tenant is disabled.
  2706. #
  2707. # Possible values:
  2708. # * A non-negative integer less than or equal to 32
  2709. #
  2710. # Related options:
  2711. # * ``swift_store_container``
  2712. # * ``swift_store_multi_tenant``
  2713. # * ``swift_store_create_container_on_put``
  2714. #
  2715. # (integer value)
  2716. # Minimum value: 0
  2717. # Maximum value: 32
  2718. #swift_store_multiple_containers_seed = 0
  2719.  
  2720. #
  2721. # List of tenants that will be granted admin access.
  2722. #
  2723. # This is a list of tenants that will be granted read/write access on
  2724. # all Swift containers created by Glance in multi-tenant mode. The
  2725. # default value is an empty list.
  2726. #
  2727. # Possible values:
  2728. # * A comma separated list of strings representing UUIDs of Keystone
  2729. # projects/tenants
  2730. #
  2731. # Related options:
  2732. # * None
  2733. #
  2734. # (list value)
  2735. #swift_store_admin_tenants =
  2736.  
  2737. #
  2738. # SSL layer compression for HTTPS Swift requests.
  2739. #
  2740. # Provide a boolean value to determine whether or not to compress
  2741. # HTTPS Swift requests for images at the SSL layer. By default,
  2742. # compression is enabled.
  2743. #
  2744. # When using Swift as the backend store for Glance image storage,
  2745. # SSL layer compression of HTTPS Swift requests can be set using
  2746. # this option. If set to False, SSL layer compression of HTTPS
  2747. # Swift requests is disabled. Disabling this option may improve
  2748. # performance for images which are already in a compressed format,
  2749. # for example, qcow2.
  2750. #
  2751. # Possible values:
  2752. # * True
  2753. # * False
  2754. #
  2755. # Related Options:
  2756. # * None
  2757. #
  2758. # (boolean value)
  2759. #swift_store_ssl_compression = true
  2760.  
  2761. #
  2762. # The number of times a Swift download will be retried before the
  2763. # request fails.
  2764. #
  2765. # Provide an integer value representing the number of times an image
  2766. # download must be retried before erroring out. The default value is
  2767. # zero (no retry on a failed image download). When set to a positive
  2768. # integer value, ``swift_store_retry_get_count`` ensures that the
  2769. # download is attempted this many more times upon a download failure
  2770. # before sending an error message.
  2771. #
  2772. # Possible values:
  2773. # * Zero
  2774. # * Positive integer value
  2775. #
  2776. # Related Options:
  2777. # * None
  2778. #
  2779. # (integer value)
  2780. # Minimum value: 0
  2781. #swift_store_retry_get_count = 0
  2782.  
  2783. #
  2784. # Time in seconds defining the size of the window in which a new
  2785. # token may be requested before the current token is due to expire.
  2786. #
  2787. # Typically, the Swift storage driver fetches a new token upon the
  2788. # expiration of the current token to ensure continued access to
  2789. # Swift. However, some Swift transactions (like uploading image
  2790. # segments) may not recover well if the token expires on the fly.
  2791. #
  2792. # Hence, by fetching a new token before the current token expiration,
  2793. # we make sure that the token does not expire or is close to expiry
  2794. # before a transaction is attempted. By default, the Swift storage
  2795. # driver requests for a new token 60 seconds or less before the
  2796. # current token expiration.
  2797. #
  2798. # Possible values:
  2799. # * Zero
  2800. # * Positive integer value
  2801. #
  2802. # Related Options:
  2803. # * None
  2804. #
  2805. # (integer value)
  2806. # Minimum value: 0
  2807. #swift_store_expire_soon_interval = 60
  2808.  
  2809. #
  2810. # Use trusts for multi-tenant Swift store.
  2811. #
  2812. # This option instructs the Swift store to create a trust for each
  2813. # add/get request when the multi-tenant store is in use. Using trusts
  2814. # allows the Swift store to avoid problems that can be caused by an
  2815. # authentication token expiring during the upload or download of data.
  2816. #
  2817. # By default, ``swift_store_use_trusts`` is set to ``True``(use of
  2818. # trusts is enabled). If set to ``False``, a user token is used for
  2819. # the Swift connection instead, eliminating the overhead of trust
  2820. # creation.
  2821. #
  2822. # NOTE: This option is considered only when
  2823. # ``swift_store_multi_tenant`` is set to ``True``
  2824. #
  2825. # Possible values:
  2826. # * True
  2827. # * False
  2828. #
  2829. # Related options:
  2830. # * swift_store_multi_tenant
  2831. #
  2832. # (boolean value)
  2833. #swift_store_use_trusts = true
  2834.  
  2835. #
  2836. # Buffer image segments before upload to Swift.
  2837. #
  2838. # Provide a boolean value to indicate whether or not Glance should
  2839. # buffer image data to disk while uploading to swift. This enables
  2840. # Glance to resume uploads on error.
  2841. #
  2842. # NOTES:
  2843. # When enabling this option, one should take great care as this
  2844. # increases disk usage on the API node. Be aware that depending
  2845. # upon how the file system is configured, the disk space used
  2846. # for buffering may decrease the actual disk space available for
  2847. # the glance image cache. Disk utilization will cap according to
  2848. # the following equation:
  2849. # (``swift_store_large_object_chunk_size`` * ``workers`` * 1000)
  2850. #
  2851. # Possible values:
  2852. # * True
  2853. # * False
  2854. #
  2855. # Related options:
  2856. # * swift_upload_buffer_dir
  2857. #
  2858. # (boolean value)
  2859. #swift_buffer_on_upload = false
  2860.  
  2861. #
  2862. # Reference to default Swift account/backing store parameters.
  2863. #
  2864. # Provide a string value representing a reference to the default set
  2865. # of parameters required for using swift account/backing store for
  2866. # image storage. The default reference value for this configuration
  2867. # option is 'ref1'. This configuration option dereferences the
  2868. # parameters and facilitates image storage in Swift storage backend
  2869. # every time a new image is added.
  2870. #
  2871. # Possible values:
  2872. # * A valid string value
  2873. #
  2874. # Related options:
  2875. # * None
  2876. #
  2877. # (string value)
  2878. #default_swift_reference = ref1
  2879.  
  2880. # DEPRECATED: Version of the authentication service to use. Valid versions are 2
  2881. # and 3 for keystone and 1 (deprecated) for swauth and rackspace. (string value)
  2882. # This option is deprecated for removal.
  2883. # Its value may be silently ignored in the future.
  2884. # Reason:
  2885. # The option 'auth_version' in the Swift back-end configuration file is
  2886. # used instead.
  2887. #swift_store_auth_version = 2
  2888.  
  2889. # DEPRECATED: The address where the Swift authentication service is listening.
  2890. # (string value)
  2891. # This option is deprecated for removal.
  2892. # Its value may be silently ignored in the future.
  2893. # Reason:
  2894. # The option 'auth_address' in the Swift back-end configuration file is
  2895. # used instead.
  2896. #swift_store_auth_address = <None>
  2897.  
  2898. # DEPRECATED: The user to authenticate against the Swift authentication service.
  2899. # (string value)
  2900. # This option is deprecated for removal.
  2901. # Its value may be silently ignored in the future.
  2902. # Reason:
  2903. # The option 'user' in the Swift back-end configuration file is set instead.
  2904. #swift_store_user = <None>
  2905.  
  2906. # DEPRECATED: Auth key for the user authenticating against the Swift
  2907. # authentication service. (string value)
  2908. # This option is deprecated for removal.
  2909. # Its value may be silently ignored in the future.
  2910. # Reason:
  2911. # The option 'key' in the Swift back-end configuration file is used
  2912. # to set the authentication key instead.
  2913. #swift_store_key = <None>
  2914.  
  2915. #
  2916. # Absolute path to the file containing the swift account(s)
  2917. # configurations.
  2918. #
  2919. # Include a string value representing the path to a configuration
  2920. # file that has references for each of the configured Swift
  2921. # account(s)/backing stores. By default, no file path is specified
  2922. # and customized Swift referencing is disabled. Configuring this
  2923. # option is highly recommended while using Swift storage backend for
  2924. # image storage as it avoids storage of credentials in the database.
  2925. #
  2926. # NOTE: Please do not configure this option if you have set
  2927. # ``swift_store_multi_tenant`` to ``True``.
  2928. #
  2929. # Possible values:
  2930. # * String value representing an absolute path on the glance-api
  2931. # node
  2932. #
  2933. # Related options:
  2934. # * swift_store_multi_tenant
  2935. #
  2936. # (string value)
  2937. #swift_store_config_file = <None>
  2938.  
  2939. #
  2940. # Directory to buffer image segments before upload to Swift.
  2941. #
  2942. # Provide a string value representing the absolute path to the
  2943. # directory on the glance node where image segments will be
  2944. # buffered briefly before they are uploaded to swift.
  2945. #
  2946. # NOTES:
  2947. # * This is required only when the configuration option
  2948. # ``swift_buffer_on_upload`` is set to True.
  2949. # * This directory should be provisioned keeping in mind the
  2950. # ``swift_store_large_object_chunk_size`` and the maximum
  2951. # number of images that could be uploaded simultaneously by
  2952. # a given glance node.
  2953. #
  2954. # Possible values:
  2955. # * String value representing an absolute directory path
  2956. #
  2957. # Related options:
  2958. # * swift_buffer_on_upload
  2959. # * swift_store_large_object_chunk_size
  2960. #
  2961. # (string value)
  2962. #swift_upload_buffer_dir = <None>
  2963.  
  2964.  
  2965. [glance.store.vmware_datastore.store]
  2966.  
  2967. #
  2968. # From glance.multi_store
  2969. #
  2970.  
  2971. #
  2972. # Address of the ESX/ESXi or vCenter Server target system.
  2973. #
  2974. # This configuration option sets the address of the ESX/ESXi or vCenter
  2975. # Server target system. This option is required when using the VMware
  2976. # storage backend. The address can contain an IP address (127.0.0.1) or
  2977. # a DNS name (www.my-domain.com).
  2978. #
  2979. # Possible Values:
  2980. # * A valid IPv4 or IPv6 address
  2981. # * A valid DNS name
  2982. #
  2983. # Related options:
  2984. # * vmware_server_username
  2985. # * vmware_server_password
  2986. #
  2987. # (host address value)
  2988. #
  2989. # This option has a sample default set, which means that
  2990. # its actual default value may vary from the one documented
  2991. # below.
  2992. #vmware_server_host = 127.0.0.1
  2993.  
  2994. #
  2995. # Server username.
  2996. #
  2997. # This configuration option takes the username for authenticating with
  2998. # the VMware ESX/ESXi or vCenter Server. This option is required when
  2999. # using the VMware storage backend.
  3000. #
  3001. # Possible Values:
  3002. # * Any string that is the username for a user with appropriate
  3003. # privileges
  3004. #
  3005. # Related options:
  3006. # * vmware_server_host
  3007. # * vmware_server_password
  3008. #
  3009. # (string value)
  3010. #
  3011. # This option has a sample default set, which means that
  3012. # its actual default value may vary from the one documented
  3013. # below.
  3014. #vmware_server_username = root
  3015.  
  3016. #
  3017. # Server password.
  3018. #
  3019. # This configuration option takes the password for authenticating with
  3020. # the VMware ESX/ESXi or vCenter Server. This option is required when
  3021. # using the VMware storage backend.
  3022. #
  3023. # Possible Values:
  3024. # * Any string that is a password corresponding to the username
  3025. # specified using the "vmware_server_username" option
  3026. #
  3027. # Related options:
  3028. # * vmware_server_host
  3029. # * vmware_server_username
  3030. #
  3031. # (string value)
  3032. #
  3033. # This option has a sample default set, which means that
  3034. # its actual default value may vary from the one documented
  3035. # below.
  3036. #vmware_server_password = vmware
  3037.  
  3038. #
  3039. # The number of VMware API retries.
  3040. #
  3041. # This configuration option specifies the number of times the VMware
  3042. # ESX/VC server API must be retried upon connection related issues or
  3043. # server API call overload. It is not possible to specify 'retry
  3044. # forever'.
  3045. #
  3046. # Possible Values:
  3047. # * Any positive integer value
  3048. #
  3049. # Related options:
  3050. # * None
  3051. #
  3052. # (integer value)
  3053. # Minimum value: 1
  3054. #vmware_api_retry_count = 10
  3055.  
  3056. #
  3057. # Interval in seconds used for polling remote tasks invoked on VMware
  3058. # ESX/VC server.
  3059. #
  3060. # This configuration option takes in the sleep time in seconds for polling an
  3061. # on-going async task as part of the VMWare ESX/VC server API call.
  3062. #
  3063. # Possible Values:
  3064. # * Any positive integer value
  3065. #
  3066. # Related options:
  3067. # * None
  3068. #
  3069. # (integer value)
  3070. # Minimum value: 1
  3071. #vmware_task_poll_interval = 5
  3072.  
  3073. #
  3074. # The directory where the glance images will be stored in the datastore.
  3075. #
  3076. # This configuration option specifies the path to the directory where the
  3077. # glance images will be stored in the VMware datastore. If this option
  3078. # is not set, the default directory where the glance images are stored
  3079. # is openstack_glance.
  3080. #
  3081. # Possible Values:
  3082. # * Any string that is a valid path to a directory
  3083. #
  3084. # Related options:
  3085. # * None
  3086. #
  3087. # (string value)
  3088. #vmware_store_image_dir = /openstack_glance
  3089.  
  3090. #
  3091. # Set verification of the ESX/vCenter server certificate.
  3092. #
  3093. # This configuration option takes a boolean value to determine
  3094. # whether or not to verify the ESX/vCenter server certificate. If this
  3095. # option is set to True, the ESX/vCenter server certificate is not
  3096. # verified. If this option is set to False, then the default CA
  3097. # truststore is used for verification.
  3098. #
  3099. # This option is ignored if the "vmware_ca_file" option is set. In that
  3100. # case, the ESX/vCenter server certificate will then be verified using
  3101. # the file specified using the "vmware_ca_file" option .
  3102. #
  3103. # Possible Values:
  3104. # * True
  3105. # * False
  3106. #
  3107. # Related options:
  3108. # * vmware_ca_file
  3109. #
  3110. # (boolean value)
  3111. # Deprecated group/name - [glance.store.vmware_datastore.store]/vmware_api_insecure
  3112. #vmware_insecure = false
  3113.  
  3114. #
  3115. # Absolute path to the CA bundle file.
  3116. #
  3117. # This configuration option enables the operator to use a custom
  3118. # Cerificate Authority File to verify the ESX/vCenter certificate.
  3119. #
  3120. # If this option is set, the "vmware_insecure" option will be ignored
  3121. # and the CA file specified will be used to authenticate the ESX/vCenter
  3122. # server certificate and establish a secure connection to the server.
  3123. #
  3124. # Possible Values:
  3125. # * Any string that is a valid absolute path to a CA file
  3126. #
  3127. # Related options:
  3128. # * vmware_insecure
  3129. #
  3130. # (string value)
  3131. #
  3132. # This option has a sample default set, which means that
  3133. # its actual default value may vary from the one documented
  3134. # below.
  3135. #vmware_ca_file = /etc/ssl/certs/ca-certificates.crt
  3136.  
  3137. #
  3138. # The datastores where the image can be stored.
  3139. #
  3140. # This configuration option specifies the datastores where the image can
  3141. # be stored in the VMWare store backend. This option may be specified
  3142. # multiple times for specifying multiple datastores. The datastore name
  3143. # should be specified after its datacenter path, separated by ":". An
  3144. # optional weight may be given after the datastore name, separated again
  3145. # by ":" to specify the priority. Thus, the required format becomes
  3146. # <datacenter_path>:<datastore_name>:<optional_weight>.
  3147. #
  3148. # When adding an image, the datastore with highest weight will be
  3149. # selected, unless there is not enough free space available in cases
  3150. # where the image size is already known. If no weight is given, it is
  3151. # assumed to be zero and the directory will be considered for selection
  3152. # last. If multiple datastores have the same weight, then the one with
  3153. # the most free space available is selected.
  3154. #
  3155. # Possible Values:
  3156. # * Any string of the format:
  3157. # <datacenter_path>:<datastore_name>:<optional_weight>
  3158. #
  3159. # Related options:
  3160. # * None
  3161. #
  3162. # (multi valued)
  3163. #vmware_datastores =
  3164.  
  3165.  
  3166. [glance_store]
  3167. default_backend = fs
  3168.  
  3169. #
  3170. # From glance.multi_store
  3171. #
  3172.  
  3173. #
  3174. # The store identifier for the default backend in which data will be
  3175. # stored.
  3176. #
  3177. # The value must be defined as one of the keys in the dict defined
  3178. # by the ``enabled_backends`` configuration option in the DEFAULT
  3179. # configuration group.
  3180. #
  3181. # If a value is not defined for this option:
  3182. #
  3183. # * the consuming service may refuse to start
  3184. # * store_add calls that do not specify a specific backend will
  3185. # raise a ``glance_store.exceptions.UnknownScheme`` exception
  3186. #
  3187. # Related Options:
  3188. # * enabled_backends
  3189. #
  3190. # (string value)
  3191. #default_backend = <None>
  3192.  
  3193. #
  3194. # From glance.store
  3195. #
  3196.  
  3197. # DEPRECATED:
  3198. # List of enabled Glance stores.
  3199. #
  3200. # Register the storage backends to use for storing disk images
  3201. # as a comma separated list. The default stores enabled for
  3202. # storing disk images with Glance are ``file`` and ``http``.
  3203. #
  3204. # Possible values:
  3205. # * A comma separated list that could include:
  3206. # * file
  3207. # * http
  3208. # * swift
  3209. # * rbd
  3210. # * cinder
  3211. # * vmware
  3212. # * s3
  3213. #
  3214. # Related Options:
  3215. # * default_store
  3216. #
  3217. # (list value)
  3218. # This option is deprecated for removal since Rocky.
  3219. # Its value may be silently ignored in the future.
  3220. # Reason:
  3221. # This option is deprecated against new config option
  3222. # ``enabled_backends`` which helps to configure multiple backend stores
  3223. # of different schemes.
  3224. #
  3225. # This option is scheduled for removal in the U development
  3226. # cycle.
  3227. #stores = file,http
  3228.  
  3229. # DEPRECATED:
  3230. # The default scheme to use for storing images.
  3231. #
  3232. # Provide a string value representing the default scheme to use for
  3233. # storing images. If not set, Glance uses ``file`` as the default
  3234. # scheme to store images with the ``file`` store.
  3235. #
  3236. # NOTE: The value given for this configuration option must be a valid
  3237. # scheme for a store registered with the ``stores`` configuration
  3238. # option.
  3239. #
  3240. # Possible values:
  3241. # * file
  3242. # * filesystem
  3243. # * http
  3244. # * https
  3245. # * swift
  3246. # * swift+http
  3247. # * swift+https
  3248. # * swift+config
  3249. # * rbd
  3250. # * cinder
  3251. # * vsphere
  3252. # * s3
  3253. #
  3254. # Related Options:
  3255. # * stores
  3256. #
  3257. # (string value)
  3258. # Possible values:
  3259. # file - <No description provided>
  3260. # filesystem - <No description provided>
  3261. # http - <No description provided>
  3262. # https - <No description provided>
  3263. # swift - <No description provided>
  3264. # swift+http - <No description provided>
  3265. # swift+https - <No description provided>
  3266. # swift+config - <No description provided>
  3267. # rbd - <No description provided>
  3268. # cinder - <No description provided>
  3269. # vsphere - <No description provided>
  3270. # s3 - <No description provided>
  3271. # This option is deprecated for removal since Rocky.
  3272. # Its value may be silently ignored in the future.
  3273. # Reason:
  3274. # This option is deprecated against new config option
  3275. # ``default_backend`` which acts similar to ``default_store`` config
  3276. # option.
  3277. #
  3278. # This option is scheduled for removal in the U development
  3279. # cycle.
  3280. #default_store = file
  3281.  
  3282. #
  3283. # Information to match when looking for cinder in the service catalog.
  3284. #
  3285. # When the ``cinder_endpoint_template`` is not set and any of
  3286. # ``cinder_store_auth_address``, ``cinder_store_user_name``,
  3287. # ``cinder_store_project_name``, ``cinder_store_password`` is not set,
  3288. # cinder store uses this information to lookup cinder endpoint from the service
  3289. # catalog in the current context. ``cinder_os_region_name``, if set, is taken
  3290. # into consideration to fetch the appropriate endpoint.
  3291. #
  3292. # The service catalog can be listed by the ``openstack catalog list`` command.
  3293. #
  3294. # Possible values:
  3295. # * A string of of the following form:
  3296. # ``<service_type>:<service_name>:<interface>``
  3297. # At least ``service_type`` and ``interface`` should be specified.
  3298. # ``service_name`` can be omitted.
  3299. #
  3300. # Related options:
  3301. # * cinder_os_region_name
  3302. # * cinder_endpoint_template
  3303. # * cinder_store_auth_address
  3304. # * cinder_store_user_name
  3305. # * cinder_store_project_name
  3306. # * cinder_store_password
  3307. # * cinder_store_project_domain_name
  3308. # * cinder_store_user_domain_name
  3309. #
  3310. # (string value)
  3311. #cinder_catalog_info = volumev3::publicURL
  3312.  
  3313. #
  3314. # Override service catalog lookup with template for cinder endpoint.
  3315. #
  3316. # When this option is set, this value is used to generate cinder endpoint,
  3317. # instead of looking up from the service catalog.
  3318. # This value is ignored if ``cinder_store_auth_address``,
  3319. # ``cinder_store_user_name``, ``cinder_store_project_name``, and
  3320. # ``cinder_store_password`` are specified.
  3321. #
  3322. # If this configuration option is set, ``cinder_catalog_info`` will be ignored.
  3323. #
  3324. # Possible values:
  3325. # * URL template string for cinder endpoint, where ``%%(tenant)s`` is
  3326. # replaced with the current tenant (project) name.
  3327. # For example: ``http://cinder.openstack.example.org/v2/%%(tenant)s``
  3328. #
  3329. # Related options:
  3330. # * cinder_store_auth_address
  3331. # * cinder_store_user_name
  3332. # * cinder_store_project_name
  3333. # * cinder_store_password
  3334. # * cinder_store_project_domain_name
  3335. # * cinder_store_user_domain_name
  3336. # * cinder_catalog_info
  3337. #
  3338. # (string value)
  3339. #cinder_endpoint_template = <None>
  3340.  
  3341. #
  3342. # Region name to lookup cinder service from the service catalog.
  3343. #
  3344. # This is used only when ``cinder_catalog_info`` is used for determining the
  3345. # endpoint. If set, the lookup for cinder endpoint by this node is filtered to
  3346. # the specified region. It is useful when multiple regions are listed in the
  3347. # catalog. If this is not set, the endpoint is looked up from every region.
  3348. #
  3349. # Possible values:
  3350. # * A string that is a valid region name.
  3351. #
  3352. # Related options:
  3353. # * cinder_catalog_info
  3354. #
  3355. # (string value)
  3356. # Deprecated group/name - [glance_store]/os_region_name
  3357. #cinder_os_region_name = <None>
  3358.  
  3359. #
  3360. # Location of a CA certificates file used for cinder client requests.
  3361. #
  3362. # The specified CA certificates file, if set, is used to verify cinder
  3363. # connections via HTTPS endpoint. If the endpoint is HTTP, this value is
  3364. # ignored.
  3365. # ``cinder_api_insecure`` must be set to ``True`` to enable the verification.
  3366. #
  3367. # Possible values:
  3368. # * Path to a ca certificates file
  3369. #
  3370. # Related options:
  3371. # * cinder_api_insecure
  3372. #
  3373. # (string value)
  3374. #cinder_ca_certificates_file = <None>
  3375.  
  3376. #
  3377. # Number of cinderclient retries on failed http calls.
  3378. #
  3379. # When a call failed by any errors, cinderclient will retry the call up to the
  3380. # specified times after sleeping a few seconds.
  3381. #
  3382. # Possible values:
  3383. # * A positive integer
  3384. #
  3385. # Related options:
  3386. # * None
  3387. #
  3388. # (integer value)
  3389. # Minimum value: 0
  3390. #cinder_http_retries = 3
  3391.  
  3392. #
  3393. # Time period, in seconds, to wait for a cinder volume transition to
  3394. # complete.
  3395. #
  3396. # When the cinder volume is created, deleted, or attached to the glance node to
  3397. # read/write the volume data, the volume's state is changed. For example, the
  3398. # newly created volume status changes from ``creating`` to ``available`` after
  3399. # the creation process is completed. This specifies the maximum time to wait for
  3400. # the status change. If a timeout occurs while waiting, or the status is changed
  3401. # to an unexpected value (e.g. `error``), the image creation fails.
  3402. #
  3403. # Possible values:
  3404. # * A positive integer
  3405. #
  3406. # Related options:
  3407. # * None
  3408. #
  3409. # (integer value)
  3410. # Minimum value: 0
  3411. #cinder_state_transition_timeout = 300
  3412.  
  3413. #
  3414. # Allow to perform insecure SSL requests to cinder.
  3415. #
  3416. # If this option is set to True, HTTPS endpoint connection is verified using the
  3417. # CA certificates file specified by ``cinder_ca_certificates_file`` option.
  3418. #
  3419. # Possible values:
  3420. # * True
  3421. # * False
  3422. #
  3423. # Related options:
  3424. # * cinder_ca_certificates_file
  3425. #
  3426. # (boolean value)
  3427. #cinder_api_insecure = false
  3428.  
  3429. #
  3430. # The address where the cinder authentication service is listening.
  3431. #
  3432. # When all of ``cinder_store_auth_address``, ``cinder_store_user_name``,
  3433. # ``cinder_store_project_name``, and ``cinder_store_password`` options are
  3434. # specified, the specified values are always used for the authentication.
  3435. # This is useful to hide the image volumes from users by storing them in a
  3436. # project/tenant specific to the image service. It also enables users to share
  3437. # the image volume among other projects under the control of glance's ACL.
  3438. #
  3439. # If either of these options are not set, the cinder endpoint is looked up
  3440. # from the service catalog, and current context's user and project are used.
  3441. #
  3442. # Possible values:
  3443. # * A valid authentication service address, for example:
  3444. # ``http://openstack.example.org/identity/v2.0``
  3445. #
  3446. # Related options:
  3447. # * cinder_store_user_name
  3448. # * cinder_store_password
  3449. # * cinder_store_project_name
  3450. # * cinder_store_project_domain_name
  3451. # * cinder_store_user_domain_name
  3452. #
  3453. # (string value)
  3454. #cinder_store_auth_address = <None>
  3455.  
  3456. #
  3457. # User name to authenticate against cinder.
  3458. #
  3459. # This must be used with all the following non-domain-related options.
  3460. # If any of these are not specified (except domain-related options),
  3461. # the user of the current context is used.
  3462. #
  3463. # Possible values:
  3464. # * A valid user name
  3465. #
  3466. # Related options:
  3467. # * cinder_store_auth_address
  3468. # * cinder_store_password
  3469. # * cinder_store_project_name
  3470. # * cinder_store_project_domain_name
  3471. # * cinder_store_user_domain_name
  3472. #
  3473. # (string value)
  3474. #cinder_store_user_name = <None>
  3475.  
  3476. #
  3477. # Domain of the user to authenticate against cinder.
  3478. #
  3479. # Possible values:
  3480. # * A valid domain name for the user specified by ``cinder_store_user_name``
  3481. #
  3482. # Related options:
  3483. # * cinder_store_auth_address
  3484. # * cinder_store_password
  3485. # * cinder_store_project_name
  3486. # * cinder_store_project_domain_name
  3487. # * cinder_store_user_name
  3488. #
  3489. # (string value)
  3490. #cinder_store_user_domain_name = Default
  3491.  
  3492. #
  3493. # Password for the user authenticating against cinder.
  3494. #
  3495. # This must be used with all the following related options.
  3496. # If any of these are not specified (except domain-related options),
  3497. # the user of the current context is used.
  3498. #
  3499. # Possible values:
  3500. # * A valid password for the user specified by ``cinder_store_user_name``
  3501. #
  3502. # Related options:
  3503. # * cinder_store_auth_address
  3504. # * cinder_store_user_name
  3505. # * cinder_store_project_name
  3506. # * cinder_store_project_domain_name
  3507. # * cinder_store_user_domain_name
  3508. #
  3509. # (string value)
  3510. #cinder_store_password = <None>
  3511.  
  3512. #
  3513. # Project name where the image volume is stored in cinder.
  3514. #
  3515. # If this configuration option is not set, the project in current context is
  3516. # used.
  3517. #
  3518. # This must be used with all the following related options.
  3519. # If any of these are not specified (except domain-related options),
  3520. # the user of the current context is used.
  3521. #
  3522. # Possible values:
  3523. # * A valid project name
  3524. #
  3525. # Related options:
  3526. # * ``cinder_store_auth_address``
  3527. # * ``cinder_store_user_name``
  3528. # * ``cinder_store_password``
  3529. # * ``cinder_store_project_domain_name``
  3530. # * ``cinder_store_user_domain_name``
  3531. #
  3532. # (string value)
  3533. #cinder_store_project_name = <None>
  3534.  
  3535. #
  3536. # Domain of the project where the image volume is stored in cinder.
  3537. #
  3538. # Possible values:
  3539. # * A valid domain name of the project specified by
  3540. # ``cinder_store_project_name``
  3541. #
  3542. # Related options:
  3543. # * ``cinder_store_auth_address``
  3544. # * ``cinder_store_user_name``
  3545. # * ``cinder_store_password``
  3546. # * ``cinder_store_project_domain_name``
  3547. # * ``cinder_store_user_domain_name``
  3548. #
  3549. # (string value)
  3550. #cinder_store_project_domain_name = Default
  3551.  
  3552. #
  3553. # Path to the rootwrap configuration file to use for running commands as root.
  3554. #
  3555. # The cinder store requires root privileges to operate the image volumes (for
  3556. # connecting to iSCSI/FC volumes and reading/writing the volume data, etc.).
  3557. # The configuration file should allow the required commands by cinder store and
  3558. # os-brick library.
  3559. #
  3560. # Possible values:
  3561. # * Path to the rootwrap config file
  3562. #
  3563. # Related options:
  3564. # * None
  3565. #
  3566. # (string value)
  3567. #rootwrap_config = /etc/glance/rootwrap.conf
  3568.  
  3569. #
  3570. # Volume type that will be used for volume creation in cinder.
  3571. #
  3572. # Some cinder backends can have several volume types to optimize storage usage.
  3573. # Adding this option allows an operator to choose a specific volume type
  3574. # in cinder that can be optimized for images.
  3575. #
  3576. # If this is not set, then the default volume type specified in the cinder
  3577. # configuration will be used for volume creation.
  3578. #
  3579. # Possible values:
  3580. # * A valid volume type from cinder
  3581. #
  3582. # Related options:
  3583. # * None
  3584. #
  3585. # NOTE: You cannot use an encrypted volume_type associated with an NFS backend.
  3586. # An encrypted volume stored on an NFS backend will raise an exception whenever
  3587. # glance_store tries to write or access image data stored in that volume.
  3588. # Consult your Cinder administrator to determine an appropriate volume_type.
  3589. #
  3590. # (string value)
  3591. #cinder_volume_type = <None>
  3592.  
  3593. #
  3594. # If this is set to True, attachment of volumes for image transfer will
  3595. # be aborted when multipathd is not running. Otherwise, it will fallback
  3596. # to single path.
  3597. #
  3598. # Possible values:
  3599. # * True or False
  3600. #
  3601. # Related options:
  3602. # * cinder_use_multipath
  3603. #
  3604. # (boolean value)
  3605. #cinder_enforce_multipath = false
  3606.  
  3607. #
  3608. # Flag to identify multipath is supported or not in the deployment.
  3609. #
  3610. # Set it to False if multipath is not supported.
  3611. #
  3612. # Possible values:
  3613. # * True or False
  3614. #
  3615. # Related options:
  3616. # * cinder_enforce_multipath
  3617. #
  3618. # (boolean value)
  3619. #cinder_use_multipath = false
  3620.  
  3621. #
  3622. # Directory where the NFS volume is mounted on the glance node.
  3623. #
  3624. # Possible values:
  3625. #
  3626. # * A string representing absolute path of mount point.
  3627. # (string value)
  3628. #cinder_mount_point_base = /var/lib/glance/mnt
  3629.  
  3630. #
  3631. # If this is set to True, glance will perform an extend operation
  3632. # on the attached volume. Only enable this option if the cinder
  3633. # backend driver supports the functionality of extending online
  3634. # (in-use) volumes. Supported from cinder microversion 3.42 and
  3635. # onwards. By default, it is set to False.
  3636. #
  3637. # Possible values:
  3638. # * True or False
  3639. #
  3640. # (boolean value)
  3641. #cinder_do_extend_attached = false
  3642.  
  3643. #
  3644. # Directory to which the filesystem backend store writes images.
  3645. #
  3646. # Upon start up, Glance creates the directory if it doesn't already
  3647. # exist and verifies write access to the user under which
  3648. # ``glance-api`` runs. If the write access isn't available, a
  3649. # ``BadStoreConfiguration`` exception is raised and the filesystem
  3650. # store may not be available for adding new images.
  3651. #
  3652. # NOTE: This directory is used only when filesystem store is used as a
  3653. # storage backend. Either ``filesystem_store_datadir`` or
  3654. # ``filesystem_store_datadirs`` option must be specified in
  3655. # ``glance-api.conf``. If both options are specified, a
  3656. # ``BadStoreConfiguration`` will be raised and the filesystem store
  3657. # may not be available for adding new images.
  3658. #
  3659. # Possible values:
  3660. # * A valid path to a directory
  3661. #
  3662. # Related options:
  3663. # * ``filesystem_store_datadirs``
  3664. # * ``filesystem_store_file_perm``
  3665. #
  3666. # (string value)
  3667. #filesystem_store_datadir = /var/lib/glance/images
  3668.  
  3669. #
  3670. # List of directories and their priorities to which the filesystem
  3671. # backend store writes images.
  3672. #
  3673. # The filesystem store can be configured to store images in multiple
  3674. # directories as opposed to using a single directory specified by the
  3675. # ``filesystem_store_datadir`` configuration option. When using
  3676. # multiple directories, each directory can be given an optional
  3677. # priority to specify the preference order in which they should
  3678. # be used. Priority is an integer that is concatenated to the
  3679. # directory path with a colon where a higher value indicates higher
  3680. # priority. When two directories have the same priority, the directory
  3681. # with most free space is used. When no priority is specified, it
  3682. # defaults to zero.
  3683. #
  3684. # More information on configuring filesystem store with multiple store
  3685. # directories can be found at
  3686. # https://docs.openstack.org/glance/latest/configuration/configuring.html
  3687. #
  3688. # NOTE: This directory is used only when filesystem store is used as a
  3689. # storage backend. Either ``filesystem_store_datadir`` or
  3690. # ``filesystem_store_datadirs`` option must be specified in
  3691. # ``glance-api.conf``. If both options are specified, a
  3692. # ``BadStoreConfiguration`` will be raised and the filesystem store
  3693. # may not be available for adding new images.
  3694. #
  3695. # Possible values:
  3696. # * List of strings of the following form:
  3697. # * ``<a valid directory path>:<optional integer priority>``
  3698. #
  3699. # Related options:
  3700. # * ``filesystem_store_datadir``
  3701. # * ``filesystem_store_file_perm``
  3702. #
  3703. # (multi valued)
  3704. #filesystem_store_datadirs =
  3705.  
  3706. #
  3707. # Filesystem store metadata file.
  3708. #
  3709. # The path to a file which contains the metadata to be returned with any
  3710. # location
  3711. # associated with the filesystem store. Once this option is set, it is used for
  3712. # new images created afterward only - previously existing images are not
  3713. # affected.
  3714. #
  3715. # The file must contain a valid JSON object. The object should contain the keys
  3716. # ``id`` and ``mountpoint``. The value for both keys should be a string.
  3717. #
  3718. # Possible values:
  3719. # * A valid path to the store metadata file
  3720. #
  3721. # Related options:
  3722. # * None
  3723. #
  3724. # (string value)
  3725. #filesystem_store_metadata_file = <None>
  3726.  
  3727. #
  3728. # File access permissions for the image files.
  3729. #
  3730. # Set the intended file access permissions for image data. This provides
  3731. # a way to enable other services, e.g. Nova, to consume images directly
  3732. # from the filesystem store. The users running the services that are
  3733. # intended to be given access to could be made a member of the group
  3734. # that owns the files created. Assigning a value less then or equal to
  3735. # zero for this configuration option signifies that no changes be made
  3736. # to the default permissions. This value will be decoded as an octal
  3737. # digit.
  3738. #
  3739. # For more information, please refer the documentation at
  3740. # https://docs.openstack.org/glance/latest/configuration/configuring.html
  3741. #
  3742. # Possible values:
  3743. # * A valid file access permission
  3744. # * Zero
  3745. # * Any negative integer
  3746. #
  3747. # Related options:
  3748. # * None
  3749. #
  3750. # (integer value)
  3751. #filesystem_store_file_perm = 0
  3752.  
  3753. #
  3754. # Chunk size, in bytes.
  3755. #
  3756. # The chunk size used when reading or writing image files. Raising this value
  3757. # may improve the throughput but it may also slightly increase the memory usage
  3758. # when handling a large number of requests.
  3759. #
  3760. # Possible Values:
  3761. # * Any positive integer value
  3762. #
  3763. # Related options:
  3764. # * None
  3765. #
  3766. # (integer value)
  3767. # Minimum value: 1
  3768. #filesystem_store_chunk_size = 65536
  3769.  
  3770. #
  3771. # Enable or not thin provisioning in this backend.
  3772. #
  3773. # This configuration option enable the feature of not really write null byte
  3774. # sequences on the filesystem, the holes who can appear will automatically
  3775. # be interpreted by the filesystem as null bytes, and do not really consume
  3776. # your storage.
  3777. # Enabling this feature will also speed up image upload and save network traffic
  3778. # in addition to save space in the backend, as null bytes sequences are not
  3779. # sent over the network.
  3780. #
  3781. # Possible Values:
  3782. # * True
  3783. # * False
  3784. #
  3785. # Related options:
  3786. # * None
  3787. #
  3788. # (boolean value)
  3789. #filesystem_thin_provisioning = false
  3790.  
  3791. #
  3792. # Path to the CA bundle file.
  3793. #
  3794. # This configuration option enables the operator to use a custom
  3795. # Certificate Authority file to verify the remote server certificate. If
  3796. # this option is set, the ``https_insecure`` option will be ignored and
  3797. # the CA file specified will be used to authenticate the server
  3798. # certificate and establish a secure connection to the server.
  3799. #
  3800. # Possible values:
  3801. # * A valid path to a CA file
  3802. #
  3803. # Related options:
  3804. # * https_insecure
  3805. #
  3806. # (string value)
  3807. #https_ca_certificates_file = <None>
  3808.  
  3809. #
  3810. # Set verification of the remote server certificate.
  3811. #
  3812. # This configuration option takes in a boolean value to determine
  3813. # whether or not to verify the remote server certificate. If set to
  3814. # True, the remote server certificate is not verified. If the option is
  3815. # set to False, then the default CA truststore is used for verification.
  3816. #
  3817. # This option is ignored if ``https_ca_certificates_file`` is set.
  3818. # The remote server certificate will then be verified using the file
  3819. # specified using the ``https_ca_certificates_file`` option.
  3820. #
  3821. # Possible values:
  3822. # * True
  3823. # * False
  3824. #
  3825. # Related options:
  3826. # * https_ca_certificates_file
  3827. #
  3828. # (boolean value)
  3829. #https_insecure = true
  3830.  
  3831. #
  3832. # The http/https proxy information to be used to connect to the remote
  3833. # server.
  3834. #
  3835. # This configuration option specifies the http/https proxy information
  3836. # that should be used to connect to the remote server. The proxy
  3837. # information should be a key value pair of the scheme and proxy, for
  3838. # example, http:10.0.0.1:3128. You can also specify proxies for multiple
  3839. # schemes by separating the key value pairs with a comma, for example,
  3840. # http:10.0.0.1:3128, https:10.0.0.1:1080.
  3841. #
  3842. # Possible values:
  3843. # * A comma separated list of scheme:proxy pairs as described above
  3844. #
  3845. # Related options:
  3846. # * None
  3847. #
  3848. # (dict value)
  3849. #http_proxy_information =
  3850.  
  3851. #
  3852. # Size, in megabytes, to chunk RADOS images into.
  3853. #
  3854. # Provide an integer value representing the size in megabytes to chunk
  3855. # Glance images into. The default chunk size is 8 megabytes. For optimal
  3856. # performance, the value should be a power of two.
  3857. #
  3858. # When Ceph's RBD object storage system is used as the storage backend
  3859. # for storing Glance images, the images are chunked into objects of the
  3860. # size set using this option. These chunked objects are then stored
  3861. # across the distributed block data store to use for Glance.
  3862. #
  3863. # Possible Values:
  3864. # * Any positive integer value
  3865. #
  3866. # Related options:
  3867. # * None
  3868. #
  3869. # (integer value)
  3870. # Minimum value: 1
  3871. #rbd_store_chunk_size = 8
  3872.  
  3873. #
  3874. # RADOS pool in which images are stored.
  3875. #
  3876. # When RBD is used as the storage backend for storing Glance images, the
  3877. # images are stored by means of logical grouping of the objects (chunks
  3878. # of images) into a ``pool``. Each pool is defined with the number of
  3879. # placement groups it can contain. The default pool that is used is
  3880. # 'images'.
  3881. #
  3882. # More information on the RBD storage backend can be found here:
  3883. # http://ceph.com/planet/how-data-is-stored-in-ceph-cluster/
  3884. #
  3885. # Possible Values:
  3886. # * A valid pool name
  3887. #
  3888. # Related options:
  3889. # * None
  3890. #
  3891. # (string value)
  3892. #rbd_store_pool = images
  3893.  
  3894. #
  3895. # RADOS user to authenticate as.
  3896. #
  3897. # This configuration option takes in the RADOS user to authenticate as.
  3898. # This is only needed when RADOS authentication is enabled and is
  3899. # applicable only if the user is using Cephx authentication. If the
  3900. # value for this option is not set by the user or is set to None, a
  3901. # default value will be chosen, which will be based on the client.
  3902. # section in rbd_store_ceph_conf.
  3903. #
  3904. # Possible Values:
  3905. # * A valid RADOS user
  3906. #
  3907. # Related options:
  3908. # * rbd_store_ceph_conf
  3909. #
  3910. # (string value)
  3911. #rbd_store_user = <None>
  3912.  
  3913. #
  3914. # Ceph configuration file path.
  3915. #
  3916. # This configuration option specifies the path to the Ceph configuration
  3917. # file to be used. If the value for this option is not set by the user
  3918. # or is set to the empty string, librados will read the standard ceph.conf
  3919. # file by searching the default Ceph configuration file locations in
  3920. # sequential order. See the Ceph documentation for details.
  3921. #
  3922. # NOTE: If using Cephx authentication, this file should include a reference
  3923. # to the right keyring in a client.<USER> section
  3924. #
  3925. # NOTE 2: If you leave this option empty (the default), the actual Ceph
  3926. # configuration file used may change depending on what version of librados
  3927. # is being used. If it is important for you to know exactly which configuration
  3928. # file is in effect, you may specify that file here using this option.
  3929. #
  3930. # Possible Values:
  3931. # * A valid path to a configuration file
  3932. #
  3933. # Related options:
  3934. # * rbd_store_user
  3935. #
  3936. # (string value)
  3937. #rbd_store_ceph_conf =
  3938.  
  3939. #
  3940. # Timeout value for connecting to Ceph cluster.
  3941. #
  3942. # This configuration option takes in the timeout value in seconds used
  3943. # when connecting to the Ceph cluster i.e. it sets the time to wait for
  3944. # glance-api before closing the connection. This prevents glance-api
  3945. # hangups during the connection to RBD. If the value for this option
  3946. # is set to less than 0, no timeout is set and the default librados value
  3947. # is used.
  3948. #
  3949. # Possible Values:
  3950. # * Any integer value
  3951. #
  3952. # Related options:
  3953. # * None
  3954. #
  3955. # (integer value)
  3956. #rados_connect_timeout = -1
  3957.  
  3958. #
  3959. # Enable or not thin provisioning in this backend.
  3960. #
  3961. # This configuration option enable the feature of not really write null byte
  3962. # sequences on the RBD backend, the holes who can appear will automatically
  3963. # be interpreted by Ceph as null bytes, and do not really consume your storage.
  3964. # Enabling this feature will also speed up image upload and save network traffic
  3965. # in addition to save space in the backend, as null bytes sequences are not
  3966. # sent over the network.
  3967. #
  3968. # Possible Values:
  3969. # * True
  3970. # * False
  3971. #
  3972. # Related options:
  3973. # * None
  3974. #
  3975. # (boolean value)
  3976. #rbd_thin_provisioning = false
  3977.  
  3978. #
  3979. # The host where the S3 server is listening.
  3980. #
  3981. # This configuration option sets the host of the S3 or S3 compatible storage
  3982. # Server. This option is required when using the S3 storage backend.
  3983. # The host can contain a DNS name (e.g. s3.amazonaws.com, my-object-storage.com)
  3984. # or an IP address (127.0.0.1).
  3985. #
  3986. # Possible values:
  3987. # * A valid DNS name
  3988. # * A valid IPv4 address
  3989. #
  3990. # Related Options:
  3991. # * s3_store_access_key
  3992. # * s3_store_secret_key
  3993. #
  3994. # (string value)
  3995. #s3_store_host = <None>
  3996.  
  3997. #
  3998. # The S3 region name.
  3999. #
  4000. # This parameter will set the region_name used by boto.
  4001. # If this parameter is not set, we we will try to compute it from the
  4002. # s3_store_host.
  4003. #
  4004. # Possible values:
  4005. # * A valid region name
  4006. #
  4007. # Related Options:
  4008. # * s3_store_host
  4009. #
  4010. # (string value)
  4011. #s3_store_region_name =
  4012.  
  4013. #
  4014. # The S3 query token access key.
  4015. #
  4016. # This configuration option takes the access key for authenticating with the
  4017. # Amazon S3 or S3 compatible storage server. This option is required when using
  4018. # the S3 storage backend.
  4019. #
  4020. # Possible values:
  4021. # * Any string value that is the access key for a user with appropriate
  4022. # privileges
  4023. #
  4024. # Related Options:
  4025. # * s3_store_host
  4026. # * s3_store_secret_key
  4027. #
  4028. # (string value)
  4029. #s3_store_access_key = <None>
  4030.  
  4031. #
  4032. # The S3 query token secret key.
  4033. #
  4034. # This configuration option takes the secret key for authenticating with the
  4035. # Amazon S3 or S3 compatible storage server. This option is required when using
  4036. # the S3 storage backend.
  4037. #
  4038. # Possible values:
  4039. # * Any string value that is a secret key corresponding to the access key
  4040. # specified using the ``s3_store_host`` option
  4041. #
  4042. # Related Options:
  4043. # * s3_store_host
  4044. # * s3_store_access_key
  4045. #
  4046. # (string value)
  4047. #s3_store_secret_key = <None>
  4048.  
  4049. #
  4050. # The S3 bucket to be used to store the Glance data.
  4051. #
  4052. # This configuration option specifies where the glance images will be stored
  4053. # in the S3. If ``s3_store_create_bucket_on_put`` is set to true, it will be
  4054. # created automatically even if the bucket does not exist.
  4055. #
  4056. # Possible values:
  4057. # * Any string value
  4058. #
  4059. # Related Options:
  4060. # * s3_store_create_bucket_on_put
  4061. # * s3_store_bucket_url_format
  4062. #
  4063. # (string value)
  4064. #s3_store_bucket = <None>
  4065.  
  4066. #
  4067. # Determine whether S3 should create a new bucket.
  4068. #
  4069. # This configuration option takes boolean value to indicate whether Glance
  4070. # should
  4071. # create a new bucket to S3 if it does not exist.
  4072. #
  4073. # Possible values:
  4074. # * Any Boolean value
  4075. #
  4076. # Related Options:
  4077. # * None
  4078. #
  4079. # (boolean value)
  4080. #s3_store_create_bucket_on_put = false
  4081.  
  4082. #
  4083. # The S3 calling format used to determine the object.
  4084. #
  4085. # This configuration option takes access model that is used to specify the
  4086. # address of an object in an S3 bucket.
  4087. #
  4088. # NOTE:
  4089. # In ``path``-style, the endpoint for the object looks like
  4090. # 'https://s3.amazonaws.com/bucket/example.img'.
  4091. # And in ``virtual``-style, the endpoint for the object looks like
  4092. # 'https://bucket.s3.amazonaws.com/example.img'.
  4093. # If you do not follow the DNS naming convention in the bucket name, you can
  4094. # get objects in the path style, but not in the virtual style.
  4095. #
  4096. # Possible values:
  4097. # * Any string value of ``auto``, ``virtual``, or ``path``
  4098. #
  4099. # Related Options:
  4100. # * s3_store_bucket
  4101. #
  4102. # (string value)
  4103. #s3_store_bucket_url_format = auto
  4104.  
  4105. #
  4106. # What size, in MB, should S3 start chunking image files and do a multipart
  4107. # upload in S3.
  4108. #
  4109. # This configuration option takes a threshold in MB to determine whether to
  4110. # upload the image to S3 as is or to split it (Multipart Upload).
  4111. #
  4112. # Note: You can only split up to 10,000 images.
  4113. #
  4114. # Possible values:
  4115. # * Any positive integer value
  4116. #
  4117. # Related Options:
  4118. # * s3_store_large_object_chunk_size
  4119. # * s3_store_thread_pools
  4120. #
  4121. # (integer value)
  4122. #s3_store_large_object_size = 100
  4123.  
  4124. #
  4125. # What multipart upload part size, in MB, should S3 use when uploading parts.
  4126. #
  4127. # This configuration option takes the image split size in MB for Multipart
  4128. # Upload.
  4129. #
  4130. # Note: You can only split up to 10,000 images.
  4131. #
  4132. # Possible values:
  4133. # * Any positive integer value (must be greater than or equal to 5M)
  4134. #
  4135. # Related Options:
  4136. # * s3_store_large_object_size
  4137. # * s3_store_thread_pools
  4138. #
  4139. # (integer value)
  4140. #s3_store_large_object_chunk_size = 10
  4141.  
  4142. #
  4143. # The number of thread pools to perform a multipart upload in S3.
  4144. #
  4145. # This configuration option takes the number of thread pools when performing a
  4146. # Multipart Upload.
  4147. #
  4148. # Possible values:
  4149. # * Any positive integer value
  4150. #
  4151. # Related Options:
  4152. # * s3_store_large_object_size
  4153. # * s3_store_large_object_chunk_size
  4154. #
  4155. # (integer value)
  4156. #s3_store_thread_pools = 10
  4157.  
  4158. #
  4159. # Set verification of the server certificate.
  4160. #
  4161. # This boolean determines whether or not to verify the server
  4162. # certificate. If this option is set to True, swiftclient won't check
  4163. # for a valid SSL certificate when authenticating. If the option is set
  4164. # to False, then the default CA truststore is used for verification.
  4165. #
  4166. # Possible values:
  4167. # * True
  4168. # * False
  4169. #
  4170. # Related options:
  4171. # * swift_store_cacert
  4172. #
  4173. # (boolean value)
  4174. #swift_store_auth_insecure = false
  4175.  
  4176. #
  4177. # Path to the CA bundle file.
  4178. #
  4179. # This configuration option enables the operator to specify the path to
  4180. # a custom Certificate Authority file for SSL verification when
  4181. # connecting to Swift.
  4182. #
  4183. # Possible values:
  4184. # * A valid path to a CA file
  4185. #
  4186. # Related options:
  4187. # * swift_store_auth_insecure
  4188. #
  4189. # (string value)
  4190. #
  4191. # This option has a sample default set, which means that
  4192. # its actual default value may vary from the one documented
  4193. # below.
  4194. #swift_store_cacert = /etc/ssl/certs/ca-certificates.crt
  4195.  
  4196. #
  4197. # The region of Swift endpoint to use by Glance.
  4198. #
  4199. # Provide a string value representing a Swift region where Glance
  4200. # can connect to for image storage. By default, there is no region
  4201. # set.
  4202. #
  4203. # When Glance uses Swift as the storage backend to store images
  4204. # for a specific tenant that has multiple endpoints, setting of a
  4205. # Swift region with ``swift_store_region`` allows Glance to connect
  4206. # to Swift in the specified region as opposed to a single region
  4207. # connectivity.
  4208. #
  4209. # This option can be configured for both single-tenant and
  4210. # multi-tenant storage.
  4211. #
  4212. # NOTE: Setting the region with ``swift_store_region`` is
  4213. # tenant-specific and is necessary ``only if`` the tenant has
  4214. # multiple endpoints across different regions.
  4215. #
  4216. # Possible values:
  4217. # * A string value representing a valid Swift region.
  4218. #
  4219. # Related Options:
  4220. # * None
  4221. #
  4222. # (string value)
  4223. #
  4224. # This option has a sample default set, which means that
  4225. # its actual default value may vary from the one documented
  4226. # below.
  4227. #swift_store_region = RegionTwo
  4228.  
  4229. #
  4230. # The URL endpoint to use for Swift backend storage.
  4231. #
  4232. # Provide a string value representing the URL endpoint to use for
  4233. # storing Glance images in Swift store. By default, an endpoint
  4234. # is not set and the storage URL returned by ``auth`` is used.
  4235. # Setting an endpoint with ``swift_store_endpoint`` overrides the
  4236. # storage URL and is used for Glance image storage.
  4237. #
  4238. # NOTE: The URL should include the path up to, but excluding the
  4239. # container. The location of an object is obtained by appending
  4240. # the container and object to the configured URL.
  4241. #
  4242. # Possible values:
  4243. # * String value representing a valid URL path up to a Swift container
  4244. #
  4245. # Related Options:
  4246. # * None
  4247. #
  4248. # (string value)
  4249. #
  4250. # This option has a sample default set, which means that
  4251. # its actual default value may vary from the one documented
  4252. # below.
  4253. #swift_store_endpoint = https://swift.openstack.example.org/v1/path_not_including_container_name
  4254.  
  4255. #
  4256. # Endpoint Type of Swift service.
  4257. #
  4258. # This string value indicates the endpoint type to use to fetch the
  4259. # Swift endpoint. The endpoint type determines the actions the user will
  4260. # be allowed to perform, for instance, reading and writing to the Store.
  4261. # This setting is only used if swift_store_auth_version is greater than
  4262. # 1.
  4263. #
  4264. # Possible values:
  4265. # * publicURL
  4266. # * adminURL
  4267. # * internalURL
  4268. #
  4269. # Related options:
  4270. # * swift_store_endpoint
  4271. #
  4272. # (string value)
  4273. # Possible values:
  4274. # publicURL - <No description provided>
  4275. # adminURL - <No description provided>
  4276. # internalURL - <No description provided>
  4277. #swift_store_endpoint_type = publicURL
  4278.  
  4279. #
  4280. # Type of Swift service to use.
  4281. #
  4282. # Provide a string value representing the service type to use for
  4283. # storing images while using Swift backend storage. The default
  4284. # service type is set to ``object-store``.
  4285. #
  4286. # NOTE: If ``swift_store_auth_version`` is set to 2, the value for
  4287. # this configuration option needs to be ``object-store``. If using
  4288. # a higher version of Keystone or a different auth scheme, this
  4289. # option may be modified.
  4290. #
  4291. # Possible values:
  4292. # * A string representing a valid service type for Swift storage.
  4293. #
  4294. # Related Options:
  4295. # * None
  4296. #
  4297. # (string value)
  4298. #swift_store_service_type = object-store
  4299.  
  4300. #
  4301. # Name of single container to store images/name prefix for multiple containers
  4302. #
  4303. # When a single container is being used to store images, this configuration
  4304. # option indicates the container within the Glance account to be used for
  4305. # storing all images. When multiple containers are used to store images, this
  4306. # will be the name prefix for all containers. Usage of single/multiple
  4307. # containers can be controlled using the configuration option
  4308. # ``swift_store_multiple_containers_seed``.
  4309. #
  4310. # When using multiple containers, the containers will be named after the value
  4311. # set for this configuration option with the first N chars of the image UUID
  4312. # as the suffix delimited by an underscore (where N is specified by
  4313. # ``swift_store_multiple_containers_seed``).
  4314. #
  4315. # Example: if the seed is set to 3 and swift_store_container = ``glance``, then
  4316. # an image with UUID ``fdae39a1-bac5-4238-aba4-69bcc726e848`` would be placed in
  4317. # the container ``glance_fda``. All dashes in the UUID are included when
  4318. # creating the container name but do not count toward the character limit, so
  4319. # when N=10 the container name would be ``glance_fdae39a1-ba.``
  4320. #
  4321. # Possible values:
  4322. # * If using single container, this configuration option can be any string
  4323. # that is a valid swift container name in Glance's Swift account
  4324. # * If using multiple containers, this configuration option can be any
  4325. # string as long as it satisfies the container naming rules enforced by
  4326. # Swift. The value of ``swift_store_multiple_containers_seed`` should be
  4327. # taken into account as well.
  4328. #
  4329. # Related options:
  4330. # * ``swift_store_multiple_containers_seed``
  4331. # * ``swift_store_multi_tenant``
  4332. # * ``swift_store_create_container_on_put``
  4333. #
  4334. # (string value)
  4335. #swift_store_container = glance
  4336.  
  4337. #
  4338. # The size threshold, in MB, after which Glance will start segmenting image
  4339. # data.
  4340. #
  4341. # Swift has an upper limit on the size of a single uploaded object. By default,
  4342. # this is 5GB. To upload objects bigger than this limit, objects are segmented
  4343. # into multiple smaller objects that are tied together with a manifest file.
  4344. # For more detail, refer to
  4345. # https://docs.openstack.org/swift/latest/overview_large_objects.html
  4346. #
  4347. # This configuration option specifies the size threshold over which the Swift
  4348. # driver will start segmenting image data into multiple smaller files.
  4349. # Currently, the Swift driver only supports creating Dynamic Large Objects.
  4350. #
  4351. # NOTE: This should be set by taking into account the large object limit
  4352. # enforced by the Swift cluster in consideration.
  4353. #
  4354. # Possible values:
  4355. # * A positive integer that is less than or equal to the large object limit
  4356. # enforced by the Swift cluster in consideration.
  4357. #
  4358. # Related options:
  4359. # * ``swift_store_large_object_chunk_size``
  4360. #
  4361. # (integer value)
  4362. # Minimum value: 1
  4363. #swift_store_large_object_size = 5120
  4364.  
  4365. #
  4366. # The maximum size, in MB, of the segments when image data is segmented.
  4367. #
  4368. # When image data is segmented to upload images that are larger than the limit
  4369. # enforced by the Swift cluster, image data is broken into segments that are no
  4370. # bigger than the size specified by this configuration option.
  4371. # Refer to ``swift_store_large_object_size`` for more detail.
  4372. #
  4373. # For example: if ``swift_store_large_object_size`` is 5GB and
  4374. # ``swift_store_large_object_chunk_size`` is 1GB, an image of size 6.2GB will be
  4375. # segmented into 7 segments where the first six segments will be 1GB in size and
  4376. # the seventh segment will be 0.2GB.
  4377. #
  4378. # Possible values:
  4379. # * A positive integer that is less than or equal to the large object limit
  4380. # enforced by Swift cluster in consideration.
  4381. #
  4382. # Related options:
  4383. # * ``swift_store_large_object_size``
  4384. #
  4385. # (integer value)
  4386. # Minimum value: 1
  4387. #swift_store_large_object_chunk_size = 200
  4388.  
  4389. #
  4390. # Create container, if it doesn't already exist, when uploading image.
  4391. #
  4392. # At the time of uploading an image, if the corresponding container doesn't
  4393. # exist, it will be created provided this configuration option is set to True.
  4394. # By default, it won't be created. This behavior is applicable for both single
  4395. # and multiple containers mode.
  4396. #
  4397. # Possible values:
  4398. # * True
  4399. # * False
  4400. #
  4401. # Related options:
  4402. # * None
  4403. #
  4404. # (boolean value)
  4405. #swift_store_create_container_on_put = false
  4406.  
  4407. #
  4408. # Store images in tenant's Swift account.
  4409. #
  4410. # This enables multi-tenant storage mode which causes Glance images to be stored
  4411. # in tenant specific Swift accounts. If this is disabled, Glance stores all
  4412. # images in its own account. More details multi-tenant store can be found at
  4413. # https://wiki.openstack.org/wiki/GlanceSwiftTenantSpecificStorage
  4414. #
  4415. # NOTE: If using multi-tenant swift store, please make sure
  4416. # that you do not set a swift configuration file with the
  4417. # 'swift_store_config_file' option.
  4418. #
  4419. # Possible values:
  4420. # * True
  4421. # * False
  4422. #
  4423. # Related options:
  4424. # * swift_store_config_file
  4425. #
  4426. # (boolean value)
  4427. #swift_store_multi_tenant = false
  4428.  
  4429. #
  4430. # Seed indicating the number of containers to use for storing images.
  4431. #
  4432. # When using a single-tenant store, images can be stored in one or more than one
  4433. # containers. When set to 0, all images will be stored in one single container.
  4434. # When set to an integer value between 1 and 32, multiple containers will be
  4435. # used to store images. This configuration option will determine how many
  4436. # containers are created. The total number of containers that will be used is
  4437. # equal to 16^N, so if this config option is set to 2, then 16^2=256 containers
  4438. # will be used to store images.
  4439. #
  4440. # Please refer to ``swift_store_container`` for more detail on the naming
  4441. # convention. More detail about using multiple containers can be found at
  4442. # https://specs.openstack.org/openstack/glance-specs/specs/kilo/swift-store-
  4443. # multiple-containers.html
  4444. #
  4445. # NOTE: This is used only when swift_store_multi_tenant is disabled.
  4446. #
  4447. # Possible values:
  4448. # * A non-negative integer less than or equal to 32
  4449. #
  4450. # Related options:
  4451. # * ``swift_store_container``
  4452. # * ``swift_store_multi_tenant``
  4453. # * ``swift_store_create_container_on_put``
  4454. #
  4455. # (integer value)
  4456. # Minimum value: 0
  4457. # Maximum value: 32
  4458. #swift_store_multiple_containers_seed = 0
  4459.  
  4460. #
  4461. # List of tenants that will be granted admin access.
  4462. #
  4463. # This is a list of tenants that will be granted read/write access on
  4464. # all Swift containers created by Glance in multi-tenant mode. The
  4465. # default value is an empty list.
  4466. #
  4467. # Possible values:
  4468. # * A comma separated list of strings representing UUIDs of Keystone
  4469. # projects/tenants
  4470. #
  4471. # Related options:
  4472. # * None
  4473. #
  4474. # (list value)
  4475. #swift_store_admin_tenants =
  4476.  
  4477. #
  4478. # SSL layer compression for HTTPS Swift requests.
  4479. #
  4480. # Provide a boolean value to determine whether or not to compress
  4481. # HTTPS Swift requests for images at the SSL layer. By default,
  4482. # compression is enabled.
  4483. #
  4484. # When using Swift as the backend store for Glance image storage,
  4485. # SSL layer compression of HTTPS Swift requests can be set using
  4486. # this option. If set to False, SSL layer compression of HTTPS
  4487. # Swift requests is disabled. Disabling this option may improve
  4488. # performance for images which are already in a compressed format,
  4489. # for example, qcow2.
  4490. #
  4491. # Possible values:
  4492. # * True
  4493. # * False
  4494. #
  4495. # Related Options:
  4496. # * None
  4497. #
  4498. # (boolean value)
  4499. #swift_store_ssl_compression = true
  4500.  
  4501. #
  4502. # The number of times a Swift download will be retried before the
  4503. # request fails.
  4504. #
  4505. # Provide an integer value representing the number of times an image
  4506. # download must be retried before erroring out. The default value is
  4507. # zero (no retry on a failed image download). When set to a positive
  4508. # integer value, ``swift_store_retry_get_count`` ensures that the
  4509. # download is attempted this many more times upon a download failure
  4510. # before sending an error message.
  4511. #
  4512. # Possible values:
  4513. # * Zero
  4514. # * Positive integer value
  4515. #
  4516. # Related Options:
  4517. # * None
  4518. #
  4519. # (integer value)
  4520. # Minimum value: 0
  4521. #swift_store_retry_get_count = 0
  4522.  
  4523. #
  4524. # Time in seconds defining the size of the window in which a new
  4525. # token may be requested before the current token is due to expire.
  4526. #
  4527. # Typically, the Swift storage driver fetches a new token upon the
  4528. # expiration of the current token to ensure continued access to
  4529. # Swift. However, some Swift transactions (like uploading image
  4530. # segments) may not recover well if the token expires on the fly.
  4531. #
  4532. # Hence, by fetching a new token before the current token expiration,
  4533. # we make sure that the token does not expire or is close to expiry
  4534. # before a transaction is attempted. By default, the Swift storage
  4535. # driver requests for a new token 60 seconds or less before the
  4536. # current token expiration.
  4537. #
  4538. # Possible values:
  4539. # * Zero
  4540. # * Positive integer value
  4541. #
  4542. # Related Options:
  4543. # * None
  4544. #
  4545. # (integer value)
  4546. # Minimum value: 0
  4547. #swift_store_expire_soon_interval = 60
  4548.  
  4549. #
  4550. # Use trusts for multi-tenant Swift store.
  4551. #
  4552. # This option instructs the Swift store to create a trust for each
  4553. # add/get request when the multi-tenant store is in use. Using trusts
  4554. # allows the Swift store to avoid problems that can be caused by an
  4555. # authentication token expiring during the upload or download of data.
  4556. #
  4557. # By default, ``swift_store_use_trusts`` is set to ``True``(use of
  4558. # trusts is enabled). If set to ``False``, a user token is used for
  4559. # the Swift connection instead, eliminating the overhead of trust
  4560. # creation.
  4561. #
  4562. # NOTE: This option is considered only when
  4563. # ``swift_store_multi_tenant`` is set to ``True``
  4564. #
  4565. # Possible values:
  4566. # * True
  4567. # * False
  4568. #
  4569. # Related options:
  4570. # * swift_store_multi_tenant
  4571. #
  4572. # (boolean value)
  4573. #swift_store_use_trusts = true
  4574.  
  4575. #
  4576. # Buffer image segments before upload to Swift.
  4577. #
  4578. # Provide a boolean value to indicate whether or not Glance should
  4579. # buffer image data to disk while uploading to swift. This enables
  4580. # Glance to resume uploads on error.
  4581. #
  4582. # NOTES:
  4583. # When enabling this option, one should take great care as this
  4584. # increases disk usage on the API node. Be aware that depending
  4585. # upon how the file system is configured, the disk space used
  4586. # for buffering may decrease the actual disk space available for
  4587. # the glance image cache. Disk utilization will cap according to
  4588. # the following equation:
  4589. # (``swift_store_large_object_chunk_size`` * ``workers`` * 1000)
  4590. #
  4591. # Possible values:
  4592. # * True
  4593. # * False
  4594. #
  4595. # Related options:
  4596. # * swift_upload_buffer_dir
  4597. #
  4598. # (boolean value)
  4599. #swift_buffer_on_upload = false
  4600.  
  4601. #
  4602. # Reference to default Swift account/backing store parameters.
  4603. #
  4604. # Provide a string value representing a reference to the default set
  4605. # of parameters required for using swift account/backing store for
  4606. # image storage. The default reference value for this configuration
  4607. # option is 'ref1'. This configuration option dereferences the
  4608. # parameters and facilitates image storage in Swift storage backend
  4609. # every time a new image is added.
  4610. #
  4611. # Possible values:
  4612. # * A valid string value
  4613. #
  4614. # Related options:
  4615. # * None
  4616. #
  4617. # (string value)
  4618. #default_swift_reference = ref1
  4619.  
  4620. # DEPRECATED: Version of the authentication service to use. Valid versions are 2
  4621. # and 3 for keystone and 1 (deprecated) for swauth and rackspace. (string value)
  4622. # This option is deprecated for removal.
  4623. # Its value may be silently ignored in the future.
  4624. # Reason:
  4625. # The option 'auth_version' in the Swift back-end configuration file is
  4626. # used instead.
  4627. #swift_store_auth_version = 2
  4628.  
  4629. # DEPRECATED: The address where the Swift authentication service is listening.
  4630. # (string value)
  4631. # This option is deprecated for removal.
  4632. # Its value may be silently ignored in the future.
  4633. # Reason:
  4634. # The option 'auth_address' in the Swift back-end configuration file is
  4635. # used instead.
  4636. #swift_store_auth_address = <None>
  4637.  
  4638. # DEPRECATED: The user to authenticate against the Swift authentication service.
  4639. # (string value)
  4640. # This option is deprecated for removal.
  4641. # Its value may be silently ignored in the future.
  4642. # Reason:
  4643. # The option 'user' in the Swift back-end configuration file is set instead.
  4644. #swift_store_user = <None>
  4645.  
  4646. # DEPRECATED: Auth key for the user authenticating against the Swift
  4647. # authentication service. (string value)
  4648. # This option is deprecated for removal.
  4649. # Its value may be silently ignored in the future.
  4650. # Reason:
  4651. # The option 'key' in the Swift back-end configuration file is used
  4652. # to set the authentication key instead.
  4653. #swift_store_key = <None>
  4654.  
  4655. #
  4656. # Absolute path to the file containing the swift account(s)
  4657. # configurations.
  4658. #
  4659. # Include a string value representing the path to a configuration
  4660. # file that has references for each of the configured Swift
  4661. # account(s)/backing stores. By default, no file path is specified
  4662. # and customized Swift referencing is disabled. Configuring this
  4663. # option is highly recommended while using Swift storage backend for
  4664. # image storage as it avoids storage of credentials in the database.
  4665. #
  4666. # NOTE: Please do not configure this option if you have set
  4667. # ``swift_store_multi_tenant`` to ``True``.
  4668. #
  4669. # Possible values:
  4670. # * String value representing an absolute path on the glance-api
  4671. # node
  4672. #
  4673. # Related options:
  4674. # * swift_store_multi_tenant
  4675. #
  4676. # (string value)
  4677. #swift_store_config_file = <None>
  4678.  
  4679. #
  4680. # Directory to buffer image segments before upload to Swift.
  4681. #
  4682. # Provide a string value representing the absolute path to the
  4683. # directory on the glance node where image segments will be
  4684. # buffered briefly before they are uploaded to swift.
  4685. #
  4686. # NOTES:
  4687. # * This is required only when the configuration option
  4688. # ``swift_buffer_on_upload`` is set to True.
  4689. # * This directory should be provisioned keeping in mind the
  4690. # ``swift_store_large_object_chunk_size`` and the maximum
  4691. # number of images that could be uploaded simultaneously by
  4692. # a given glance node.
  4693. #
  4694. # Possible values:
  4695. # * String value representing an absolute directory path
  4696. #
  4697. # Related options:
  4698. # * swift_buffer_on_upload
  4699. # * swift_store_large_object_chunk_size
  4700. #
  4701. # (string value)
  4702. #swift_upload_buffer_dir = <None>
  4703.  
  4704. #
  4705. # Address of the ESX/ESXi or vCenter Server target system.
  4706. #
  4707. # This configuration option sets the address of the ESX/ESXi or vCenter
  4708. # Server target system. This option is required when using the VMware
  4709. # storage backend. The address can contain an IP address (127.0.0.1) or
  4710. # a DNS name (www.my-domain.com).
  4711. #
  4712. # Possible Values:
  4713. # * A valid IPv4 or IPv6 address
  4714. # * A valid DNS name
  4715. #
  4716. # Related options:
  4717. # * vmware_server_username
  4718. # * vmware_server_password
  4719. #
  4720. # (host address value)
  4721. #
  4722. # This option has a sample default set, which means that
  4723. # its actual default value may vary from the one documented
  4724. # below.
  4725. #vmware_server_host = 127.0.0.1
  4726.  
  4727. #
  4728. # Server username.
  4729. #
  4730. # This configuration option takes the username for authenticating with
  4731. # the VMware ESX/ESXi or vCenter Server. This option is required when
  4732. # using the VMware storage backend.
  4733. #
  4734. # Possible Values:
  4735. # * Any string that is the username for a user with appropriate
  4736. # privileges
  4737. #
  4738. # Related options:
  4739. # * vmware_server_host
  4740. # * vmware_server_password
  4741. #
  4742. # (string value)
  4743. #
  4744. # This option has a sample default set, which means that
  4745. # its actual default value may vary from the one documented
  4746. # below.
  4747. #vmware_server_username = root
  4748.  
  4749. #
  4750. # Server password.
  4751. #
  4752. # This configuration option takes the password for authenticating with
  4753. # the VMware ESX/ESXi or vCenter Server. This option is required when
  4754. # using the VMware storage backend.
  4755. #
  4756. # Possible Values:
  4757. # * Any string that is a password corresponding to the username
  4758. # specified using the "vmware_server_username" option
  4759. #
  4760. # Related options:
  4761. # * vmware_server_host
  4762. # * vmware_server_username
  4763. #
  4764. # (string value)
  4765. #
  4766. # This option has a sample default set, which means that
  4767. # its actual default value may vary from the one documented
  4768. # below.
  4769. #vmware_server_password = vmware
  4770.  
  4771. #
  4772. # The number of VMware API retries.
  4773. #
  4774. # This configuration option specifies the number of times the VMware
  4775. # ESX/VC server API must be retried upon connection related issues or
  4776. # server API call overload. It is not possible to specify 'retry
  4777. # forever'.
  4778. #
  4779. # Possible Values:
  4780. # * Any positive integer value
  4781. #
  4782. # Related options:
  4783. # * None
  4784. #
  4785. # (integer value)
  4786. # Minimum value: 1
  4787. #vmware_api_retry_count = 10
  4788.  
  4789. #
  4790. # Interval in seconds used for polling remote tasks invoked on VMware
  4791. # ESX/VC server.
  4792. #
  4793. # This configuration option takes in the sleep time in seconds for polling an
  4794. # on-going async task as part of the VMWare ESX/VC server API call.
  4795. #
  4796. # Possible Values:
  4797. # * Any positive integer value
  4798. #
  4799. # Related options:
  4800. # * None
  4801. #
  4802. # (integer value)
  4803. # Minimum value: 1
  4804. #vmware_task_poll_interval = 5
  4805.  
  4806. #
  4807. # The directory where the glance images will be stored in the datastore.
  4808. #
  4809. # This configuration option specifies the path to the directory where the
  4810. # glance images will be stored in the VMware datastore. If this option
  4811. # is not set, the default directory where the glance images are stored
  4812. # is openstack_glance.
  4813. #
  4814. # Possible Values:
  4815. # * Any string that is a valid path to a directory
  4816. #
  4817. # Related options:
  4818. # * None
  4819. #
  4820. # (string value)
  4821. #vmware_store_image_dir = /openstack_glance
  4822.  
  4823. #
  4824. # Set verification of the ESX/vCenter server certificate.
  4825. #
  4826. # This configuration option takes a boolean value to determine
  4827. # whether or not to verify the ESX/vCenter server certificate. If this
  4828. # option is set to True, the ESX/vCenter server certificate is not
  4829. # verified. If this option is set to False, then the default CA
  4830. # truststore is used for verification.
  4831. #
  4832. # This option is ignored if the "vmware_ca_file" option is set. In that
  4833. # case, the ESX/vCenter server certificate will then be verified using
  4834. # the file specified using the "vmware_ca_file" option .
  4835. #
  4836. # Possible Values:
  4837. # * True
  4838. # * False
  4839. #
  4840. # Related options:
  4841. # * vmware_ca_file
  4842. #
  4843. # (boolean value)
  4844. # Deprecated group/name - [glance_store]/vmware_api_insecure
  4845. #vmware_insecure = false
  4846.  
  4847. #
  4848. # Absolute path to the CA bundle file.
  4849. #
  4850. # This configuration option enables the operator to use a custom
  4851. # Cerificate Authority File to verify the ESX/vCenter certificate.
  4852. #
  4853. # If this option is set, the "vmware_insecure" option will be ignored
  4854. # and the CA file specified will be used to authenticate the ESX/vCenter
  4855. # server certificate and establish a secure connection to the server.
  4856. #
  4857. # Possible Values:
  4858. # * Any string that is a valid absolute path to a CA file
  4859. #
  4860. # Related options:
  4861. # * vmware_insecure
  4862. #
  4863. # (string value)
  4864. #
  4865. # This option has a sample default set, which means that
  4866. # its actual default value may vary from the one documented
  4867. # below.
  4868. #vmware_ca_file = /etc/ssl/certs/ca-certificates.crt
  4869.  
  4870. #
  4871. # The datastores where the image can be stored.
  4872. #
  4873. # This configuration option specifies the datastores where the image can
  4874. # be stored in the VMWare store backend. This option may be specified
  4875. # multiple times for specifying multiple datastores. The datastore name
  4876. # should be specified after its datacenter path, separated by ":". An
  4877. # optional weight may be given after the datastore name, separated again
  4878. # by ":" to specify the priority. Thus, the required format becomes
  4879. # <datacenter_path>:<datastore_name>:<optional_weight>.
  4880. #
  4881. # When adding an image, the datastore with highest weight will be
  4882. # selected, unless there is not enough free space available in cases
  4883. # where the image size is already known. If no weight is given, it is
  4884. # assumed to be zero and the directory will be considered for selection
  4885. # last. If multiple datastores have the same weight, then the one with
  4886. # the most free space available is selected.
  4887. #
  4888. # Possible Values:
  4889. # * Any string of the format:
  4890. # <datacenter_path>:<datastore_name>:<optional_weight>
  4891. #
  4892. # Related options:
  4893. # * None
  4894. #
  4895. # (multi valued)
  4896. #vmware_datastores =
  4897.  
  4898.  
  4899. [healthcheck]
  4900.  
  4901. #
  4902. # From oslo.middleware.healthcheck
  4903. #
  4904.  
  4905. # DEPRECATED: The path to respond to healtcheck requests on. (string value)
  4906. # This option is deprecated for removal.
  4907. # Its value may be silently ignored in the future.
  4908. #path = /healthcheck
  4909.  
  4910. # Show more detailed information as part of the response. Security note:
  4911. # Enabling this option may expose sensitive details about the service being
  4912. # monitored. Be sure to verify that it will not violate your security policies.
  4913. # (boolean value)
  4914. #detailed = false
  4915.  
  4916. # Additional backends that can perform health checks and report that information
  4917. # back as part of a request. (list value)
  4918. #backends =
  4919.  
  4920. # A list of network addresses to limit source ip allowed to access healthcheck
  4921. # information. Any request from ip outside of these network addresses are
  4922. # ignored. (list value)
  4923. #allowed_source_ranges =
  4924.  
  4925. # Ignore requests with proxy headers. (boolean value)
  4926. #ignore_proxied_requests = false
  4927.  
  4928. # Check the presence of a file to determine if an application is running on a
  4929. # port. Used by DisableByFileHealthcheck plugin. (string value)
  4930. #disable_by_file_path = <None>
  4931.  
  4932. # Check the presence of a file based on a port to determine if an application is
  4933. # running on a port. Expects a "port:path" list of strings. Used by
  4934. # DisableByFilesPortsHealthcheck plugin. (list value)
  4935. #disable_by_file_paths =
  4936.  
  4937.  
  4938. [image_format]
  4939.  
  4940. #
  4941. # From glance.api
  4942. #
  4943.  
  4944. # Supported values for the 'container_format' image attribute (list value)
  4945. # Deprecated group/name - [DEFAULT]/container_formats
  4946. #container_formats = ami,ari,aki,bare,ovf,ova,docker,compressed
  4947.  
  4948. # Supported values for the 'disk_format' image attribute (list value)
  4949. # Deprecated group/name - [DEFAULT]/disk_formats
  4950. disk_formats = ami,ari,aki,vhd,vhdx,vmdk,raw,qcow2,vdi,iso,ploop.root-tar
  4951.  
  4952. # A list of strings describing allowed VMDK 'create-type' subformats that will
  4953. # be allowed. This is recommended to only include single-file-with-sparse-header
  4954. # variants to avoid potential host file exposure due to processing named
  4955. # extents. If this list is empty, then no VDMK image types allowed. Note that
  4956. # this is currently only checked during image conversion (if enabled), and
  4957. # limits the types of VMDK images we will convert from. (list value)
  4958. #vmdk_allowed_types = streamOptimized,monolithicSparse
  4959.  
  4960.  
  4961. [key_manager]
  4962.  
  4963. #
  4964. # From castellan.config
  4965. #
  4966.  
  4967. # Specify the key manager implementation. Options are "barbican" and "vault".
  4968. # Default is "barbican". Will support the values earlier set using
  4969. # [key_manager]/api_class for some time. (string value)
  4970. # Deprecated group/name - [key_manager]/api_class
  4971. #backend = barbican
  4972.  
  4973. # The type of authentication credential to create. Possible values are 'token',
  4974. # 'password', 'keystone_token', and 'keystone_password'. Required if no context
  4975. # is passed to the credential factory. (string value)
  4976. #auth_type = <None>
  4977.  
  4978. # Token for authentication. Required for 'token' and 'keystone_token' auth_type
  4979. # if no context is passed to the credential factory. (string value)
  4980. #token = <None>
  4981.  
  4982. # Username for authentication. Required for 'password' auth_type. Optional for
  4983. # the 'keystone_password' auth_type. (string value)
  4984. #username = <None>
  4985.  
  4986. # Password for authentication. Required for 'password' and 'keystone_password'
  4987. # auth_type. (string value)
  4988. #password = <None>
  4989.  
  4990. # Use this endpoint to connect to Keystone. (string value)
  4991. #auth_url = <None>
  4992.  
  4993. # User ID for authentication. Optional for 'keystone_token' and
  4994. # 'keystone_password' auth_type. (string value)
  4995. #user_id = <None>
  4996.  
  4997. # User's domain ID for authentication. Optional for 'keystone_token' and
  4998. # 'keystone_password' auth_type. (string value)
  4999. #user_domain_id = <None>
  5000.  
  5001. # User's domain name for authentication. Optional for 'keystone_token' and
  5002. # 'keystone_password' auth_type. (string value)
  5003. #user_domain_name = <None>
  5004.  
  5005. # Trust ID for trust scoping. Optional for 'keystone_token' and
  5006. # 'keystone_password' auth_type. (string value)
  5007. #trust_id = <None>
  5008.  
  5009. # Domain ID for domain scoping. Optional for 'keystone_token' and
  5010. # 'keystone_password' auth_type. (string value)
  5011. #domain_id = <None>
  5012.  
  5013. # Domain name for domain scoping. Optional for 'keystone_token' and
  5014. # 'keystone_password' auth_type. (string value)
  5015. #domain_name = <None>
  5016.  
  5017. # Project ID for project scoping. Optional for 'keystone_token' and
  5018. # 'keystone_password' auth_type. (string value)
  5019. #project_id = <None>
  5020.  
  5021. # Project name for project scoping. Optional for 'keystone_token' and
  5022. # 'keystone_password' auth_type. (string value)
  5023. #project_name = <None>
  5024.  
  5025. # Project's domain ID for project. Optional for 'keystone_token' and
  5026. # 'keystone_password' auth_type. (string value)
  5027. #project_domain_id = <None>
  5028.  
  5029. # Project's domain name for project. Optional for 'keystone_token' and
  5030. # 'keystone_password' auth_type. (string value)
  5031. #project_domain_name = <None>
  5032.  
  5033. # Allow fetching a new token if the current one is going to expire. Optional for
  5034. # 'keystone_token' and 'keystone_password' auth_type. (boolean value)
  5035. #reauthenticate = true
  5036.  
  5037.  
  5038. [keystone_authtoken]
  5039. www_authenticate_uri = http://rwcosc1:5000
  5040. auth_url = http://rwcosc1:5000
  5041. memcached_servers = rwcosc1:11211
  5042. auth_type = password
  5043. project_domain_name = Default
  5044. user_domain_name = Default
  5045. project_name = service
  5046. username = glance
  5047. password = my_password
  5048. #
  5049. # From keystonemiddleware.auth_token
  5050. #
  5051.  
  5052. # Complete "public" Identity API endpoint. This endpoint should not be an
  5053. # "admin" endpoint, as it should be accessible by all end users. Unauthenticated
  5054. # clients are redirected to this endpoint to authenticate. Although this
  5055. # endpoint should ideally be unversioned, client support in the wild varies. If
  5056. # you're using a versioned v2 endpoint here, then this should *not* be the same
  5057. # endpoint the service user utilizes for validating tokens, because normal end
  5058. # users may not be able to reach that endpoint. (string value)
  5059. # Deprecated group/name - [keystone_authtoken]/auth_uri
  5060. #www_authenticate_uri = <None>
  5061.  
  5062. # DEPRECATED: Complete "public" Identity API endpoint. This endpoint should not
  5063. # be an "admin" endpoint, as it should be accessible by all end users.
  5064. # Unauthenticated clients are redirected to this endpoint to authenticate.
  5065. # Although this endpoint should ideally be unversioned, client support in the
  5066. # wild varies. If you're using a versioned v2 endpoint here, then this should
  5067. # *not* be the same endpoint the service user utilizes for validating tokens,
  5068. # because normal end users may not be able to reach that endpoint. This option
  5069. # is deprecated in favor of www_authenticate_uri and will be removed in the S
  5070. # release. (string value)
  5071. # This option is deprecated for removal since Queens.
  5072. # Its value may be silently ignored in the future.
  5073. # Reason: The auth_uri option is deprecated in favor of www_authenticate_uri and
  5074. # will be removed in the S release.
  5075. #auth_uri = <None>
  5076.  
  5077. # API version of the Identity API endpoint. (string value)
  5078. #auth_version = <None>
  5079.  
  5080. # Interface to use for the Identity API endpoint. Valid values are "public",
  5081. # "internal" (default) or "admin". (string value)
  5082. #interface = internal
  5083.  
  5084. # Do not handle authorization requests within the middleware, but delegate the
  5085. # authorization decision to downstream WSGI components. (boolean value)
  5086. #delay_auth_decision = false
  5087.  
  5088. # Request timeout value for communicating with Identity API server. (integer
  5089. # value)
  5090. #http_connect_timeout = <None>
  5091.  
  5092. # How many times are we trying to reconnect when communicating with Identity API
  5093. # Server. (integer value)
  5094. #http_request_max_retries = 3
  5095.  
  5096. # Request environment key where the Swift cache object is stored. When
  5097. # auth_token middleware is deployed with a Swift cache, use this option to have
  5098. # the middleware share a caching backend with swift. Otherwise, use the
  5099. # ``memcached_servers`` option instead. (string value)
  5100. #cache = <None>
  5101.  
  5102. # Required if identity server requires client certificate (string value)
  5103. #certfile = <None>
  5104.  
  5105. # Required if identity server requires client certificate (string value)
  5106. #keyfile = <None>
  5107.  
  5108. # A PEM encoded Certificate Authority to use when verifying HTTPs connections.
  5109. # Defaults to system CAs. (string value)
  5110. #cafile = <None>
  5111.  
  5112. # Verify HTTPS connections. (boolean value)
  5113. #insecure = false
  5114.  
  5115. # The region in which the identity server can be found. (string value)
  5116. #region_name = <None>
  5117.  
  5118. # Optionally specify a list of memcached server(s) to use for caching. If left
  5119. # undefined, tokens will instead be cached in-process. (list value)
  5120. # Deprecated group/name - [keystone_authtoken]/memcache_servers
  5121. #memcached_servers = <None>
  5122.  
  5123. # In order to prevent excessive effort spent validating tokens, the middleware
  5124. # caches previously-seen tokens for a configurable duration (in seconds). Set to
  5125. # -1 to disable caching completely. (integer value)
  5126. #token_cache_time = 300
  5127.  
  5128. # (Optional) If defined, indicate whether token data should be authenticated or
  5129. # authenticated and encrypted. If MAC, token data is authenticated (with HMAC)
  5130. # in the cache. If ENCRYPT, token data is encrypted and authenticated in the
  5131. # cache. If the value is not one of these options or empty, auth_token will
  5132. # raise an exception on initialization. (string value)
  5133. # Possible values:
  5134. # None - <No description provided>
  5135. # MAC - <No description provided>
  5136. # ENCRYPT - <No description provided>
  5137. #memcache_security_strategy = None
  5138.  
  5139. # (Optional, mandatory if memcache_security_strategy is defined) This string is
  5140. # used for key derivation. (string value)
  5141. #memcache_secret_key = <None>
  5142.  
  5143. # (Optional) Number of seconds memcached server is considered dead before it is
  5144. # tried again. (integer value)
  5145. #memcache_pool_dead_retry = 300
  5146.  
  5147. # (Optional) Maximum total number of open connections to every memcached server.
  5148. # (integer value)
  5149. #memcache_pool_maxsize = 10
  5150.  
  5151. # (Optional) Socket timeout in seconds for communicating with a memcached
  5152. # server. (integer value)
  5153. #memcache_pool_socket_timeout = 3
  5154.  
  5155. # (Optional) Number of seconds a connection to memcached is held unused in the
  5156. # pool before it is closed. (integer value)
  5157. #memcache_pool_unused_timeout = 60
  5158.  
  5159. # (Optional) Number of seconds that an operation will wait to get a memcached
  5160. # client connection from the pool. (integer value)
  5161. #memcache_pool_conn_get_timeout = 10
  5162.  
  5163. # (Optional) Use the advanced (eventlet safe) memcached client pool. (boolean
  5164. # value)
  5165. #memcache_use_advanced_pool = true
  5166.  
  5167. # (Optional) Indicate whether to set the X-Service-Catalog header. If False,
  5168. # middleware will not ask for service catalog on token validation and will not
  5169. # set the X-Service-Catalog header. (boolean value)
  5170. #include_service_catalog = true
  5171.  
  5172. # Used to control the use and type of token binding. Can be set to: "disabled"
  5173. # to not check token binding. "permissive" (default) to validate binding
  5174. # information if the bind type is of a form known to the server and ignore it if
  5175. # not. "strict" like "permissive" but if the bind type is unknown the token will
  5176. # be rejected. "required" any form of token binding is needed to be allowed.
  5177. # Finally the name of a binding method that must be present in tokens. (string
  5178. # value)
  5179. #enforce_token_bind = permissive
  5180.  
  5181. # A choice of roles that must be present in a service token. Service tokens are
  5182. # allowed to request that an expired token can be used and so this check should
  5183. # tightly control that only actual services should be sending this token. Roles
  5184. # here are applied as an ANY check so any role in this list must be present. For
  5185. # backwards compatibility reasons this currently only affects the allow_expired
  5186. # check. (list value)
  5187. #service_token_roles = service
  5188.  
  5189. # For backwards compatibility reasons we must let valid service tokens pass that
  5190. # don't pass the service_token_roles check as valid. Setting this true will
  5191. # become the default in a future release and should be enabled if possible.
  5192. # (boolean value)
  5193. #service_token_roles_required = false
  5194.  
  5195. # The name or type of the service as it appears in the service catalog. This is
  5196. # used to validate tokens that have restricted access rules. (string value)
  5197. #service_type = <None>
  5198.  
  5199. # Authentication type to load (string value)
  5200. # Deprecated group/name - [keystone_authtoken]/auth_plugin
  5201. #auth_type = <None>
  5202.  
  5203. # Config Section from which to load plugin specific options (string value)
  5204. #auth_section = <None>
  5205.  
  5206.  
  5207. [os_brick]
  5208.  
  5209. #
  5210. # From os_brick
  5211. #
  5212.  
  5213. # Directory to use for os-brick lock files. Defaults to
  5214. # oslo_concurrency.lock_path which is a sensible default for compute nodes, but
  5215. # not for HCI deployments or controllers where Glance uses Cinder as a backend,
  5216. # as locks should use the same directory. (string value)
  5217. #lock_path = <None>
  5218.  
  5219.  
  5220. [oslo_concurrency]
  5221.  
  5222. #
  5223. # From oslo.concurrency
  5224. #
  5225.  
  5226. # Enables or disables inter-process locks. (boolean value)
  5227. #disable_process_locking = false
  5228.  
  5229. # Directory to use for lock files. For security, the specified directory should
  5230. # only be writable by the user running the processes that need locking. Defaults
  5231. # to environment variable OSLO_LOCK_PATH. If external locks are used, a lock
  5232. # path must be set. (string value)
  5233. #lock_path = <None>
  5234.  
  5235.  
  5236. [oslo_limit]
  5237. auth_url = http://rwcosc1:5000
  5238. auth_type = password
  5239. user_domain_id = default
  5240. username = glance
  5241. system_scope = all
  5242. password = my_password
  5243. endpoint_id = b2e78828d37e4b728f86b9a82ee6c3ce
  5244. region_name = RegionOne
  5245. #
  5246. # From oslo.limit
  5247. #
  5248.  
  5249. # The service's endpoint id which is registered in Keystone. (string value)
  5250. #endpoint_id = <None>
  5251.  
  5252. # PEM encoded Certificate Authority to use when verifying HTTPs connections.
  5253. # (string value)
  5254. #cafile = <None>
  5255.  
  5256. # PEM encoded client certificate cert file (string value)
  5257. #certfile = <None>
  5258.  
  5259. # PEM encoded client certificate key file (string value)
  5260. #keyfile = <None>
  5261.  
  5262. # Verify HTTPS connections. (boolean value)
  5263. #insecure = false
  5264.  
  5265. # Timeout value for http requests (integer value)
  5266. #timeout = <None>
  5267.  
  5268. # Collect per-API call timing information. (boolean value)
  5269. #collect_timing = false
  5270.  
  5271. # Log requests to multiple loggers. (boolean value)
  5272. #split_loggers = false
  5273.  
  5274. # Authentication URL (string value)
  5275. #auth_url = <None>
  5276.  
  5277. # Scope for system operations (string value)
  5278. #system_scope = <None>
  5279.  
  5280. # Domain ID to scope to (string value)
  5281. #domain_id = <None>
  5282.  
  5283. # Domain name to scope to (string value)
  5284. #domain_name = <None>
  5285.  
  5286. # Project ID to scope to (string value)
  5287. #project_id = <None>
  5288.  
  5289. # Project name to scope to (string value)
  5290. #project_name = <None>
  5291.  
  5292. # Domain ID containing project (string value)
  5293. #project_domain_id = <None>
  5294.  
  5295. # Domain name containing project (string value)
  5296. #project_domain_name = <None>
  5297.  
  5298. # ID of the trust to use as a trustee use (string value)
  5299. #trust_id = <None>
  5300.  
  5301. # Optional domain ID to use with v3 and v2 parameters. It will be used for both
  5302. # the user and project domain in v3 and ignored in v2 authentication. (string
  5303. # value)
  5304. #default_domain_id = <None>
  5305.  
  5306. # Optional domain name to use with v3 API and v2 parameters. It will be used for
  5307. # both the user and project domain in v3 and ignored in v2 authentication.
  5308. # (string value)
  5309. #default_domain_name = <None>
  5310.  
  5311. # User ID (string value)
  5312. #user_id = <None>
  5313.  
  5314. # Username (string value)
  5315. # Deprecated group/name - [oslo_limit]/user_name
  5316. #username = <None>
  5317.  
  5318. # User's domain id (string value)
  5319. #user_domain_id = <None>
  5320.  
  5321. # User's domain name (string value)
  5322. #user_domain_name = <None>
  5323.  
  5324. # User's password (string value)
  5325. #password = <None>
  5326.  
  5327. # Tenant ID (string value)
  5328. #tenant_id = <None>
  5329.  
  5330. # Tenant Name (string value)
  5331. #tenant_name = <None>
  5332.  
  5333. # The default service_type for endpoint URL discovery. (string value)
  5334. #service_type = <None>
  5335.  
  5336. # The default service_name for endpoint URL discovery. (string value)
  5337. #service_name = <None>
  5338.  
  5339. # List of interfaces, in order of preference, for endpoint URL. (list value)
  5340. #valid_interfaces = <None>
  5341.  
  5342. # The default region_name for endpoint URL discovery. (string value)
  5343. #region_name = <None>
  5344.  
  5345. # Always use this endpoint URL for requests for this client. NOTE: The
  5346. # unversioned endpoint should be specified here; to request a particular API
  5347. # version, use the `version`, `min-version`, and/or `max-version` options.
  5348. # (string value)
  5349. #endpoint_override = <None>
  5350.  
  5351. # Minimum Major API version within a given Major API version for endpoint URL
  5352. # discovery. Mutually exclusive with min_version and max_version (string value)
  5353. #version = <None>
  5354.  
  5355. # The minimum major version of a given API, intended to be used as the lower
  5356. # bound of a range with max_version. Mutually exclusive with version. If
  5357. # min_version is given with no max_version it is as if max version is "latest".
  5358. # (string value)
  5359. #min_version = <None>
  5360.  
  5361. # The maximum major version of a given API, intended to be used as the upper
  5362. # bound of a range with min_version. Mutually exclusive with version. (string
  5363. # value)
  5364. #max_version = <None>
  5365.  
  5366. # The maximum number of retries that should be attempted for connection errors.
  5367. # (integer value)
  5368. #connect_retries = <None>
  5369.  
  5370. # Delay (in seconds) between two retries for connection errors. If not set,
  5371. # exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is
  5372. # used. (floating point value)
  5373. #connect_retry_delay = <None>
  5374.  
  5375. # The maximum number of retries that should be attempted for retriable HTTP
  5376. # status codes. (integer value)
  5377. #status_code_retries = <None>
  5378.  
  5379. # Delay (in seconds) between two retries for retriable status codes. If not set,
  5380. # exponential retry starting with 0.5 seconds up to a maximum of 60 seconds is
  5381. # used. (floating point value)
  5382. #status_code_retry_delay = <None>
  5383.  
  5384. # List of retriable HTTP status codes that should be retried. If not set default
  5385. # to [503] (list value)
  5386. #retriable_status_codes = <None>
  5387.  
  5388.  
  5389. [oslo_messaging_amqp]
  5390.  
  5391. #
  5392. # From oslo.messaging
  5393. #
  5394.  
  5395. # Name for the AMQP container. must be globally unique. Defaults to a generated
  5396. # UUID (string value)
  5397. #container_name = <None>
  5398.  
  5399. # Timeout for inactive connections (in seconds) (integer value)
  5400. #idle_timeout = 0
  5401.  
  5402. # Debug: dump AMQP frames to stdout (boolean value)
  5403. #trace = false
  5404.  
  5405. # Attempt to connect via SSL. If no other ssl-related parameters are given, it
  5406. # will use the system's CA-bundle to verify the server's certificate. (boolean
  5407. # value)
  5408. #ssl = false
  5409.  
  5410. # CA certificate PEM file used to verify the server's certificate (string value)
  5411. #ssl_ca_file =
  5412.  
  5413. # Self-identifying certificate PEM file for client authentication (string value)
  5414. #ssl_cert_file =
  5415.  
  5416. # Private key PEM file used to sign ssl_cert_file certificate (optional) (string
  5417. # value)
  5418. #ssl_key_file =
  5419.  
  5420. # Password for decrypting ssl_key_file (if encrypted) (string value)
  5421. #ssl_key_password = <None>
  5422.  
  5423. # By default SSL checks that the name in the server's certificate matches the
  5424. # hostname in the transport_url. In some configurations it may be preferable to
  5425. # use the virtual hostname instead, for example if the server uses the Server
  5426. # Name Indication TLS extension (rfc6066) to provide a certificate per virtual
  5427. # host. Set ssl_verify_vhost to True if the server's SSL certificate uses the
  5428. # virtual host name instead of the DNS name. (boolean value)
  5429. #ssl_verify_vhost = false
  5430.  
  5431. # Space separated list of acceptable SASL mechanisms (string value)
  5432. #sasl_mechanisms =
  5433.  
  5434. # Path to directory that contains the SASL configuration (string value)
  5435. #sasl_config_dir =
  5436.  
  5437. # Name of configuration file (without .conf suffix) (string value)
  5438. #sasl_config_name =
  5439.  
  5440. # SASL realm to use if no realm present in username (string value)
  5441. #sasl_default_realm =
  5442.  
  5443. # Seconds to pause before attempting to re-connect. (integer value)
  5444. # Minimum value: 1
  5445. #connection_retry_interval = 1
  5446.  
  5447. # Increase the connection_retry_interval by this many seconds after each
  5448. # unsuccessful failover attempt. (integer value)
  5449. # Minimum value: 0
  5450. #connection_retry_backoff = 2
  5451.  
  5452. # Maximum limit for connection_retry_interval + connection_retry_backoff
  5453. # (integer value)
  5454. # Minimum value: 1
  5455. #connection_retry_interval_max = 30
  5456.  
  5457. # Time to pause between re-connecting an AMQP 1.0 link that failed due to a
  5458. # recoverable error. (integer value)
  5459. # Minimum value: 1
  5460. #link_retry_delay = 10
  5461.  
  5462. # The maximum number of attempts to re-send a reply message which failed due to
  5463. # a recoverable error. (integer value)
  5464. # Minimum value: -1
  5465. #default_reply_retry = 0
  5466.  
  5467. # The deadline for an rpc reply message delivery. (integer value)
  5468. # Minimum value: 5
  5469. #default_reply_timeout = 30
  5470.  
  5471. # The deadline for an rpc cast or call message delivery. Only used when caller
  5472. # does not provide a timeout expiry. (integer value)
  5473. # Minimum value: 5
  5474. #default_send_timeout = 30
  5475.  
  5476. # The deadline for a sent notification message delivery. Only used when caller
  5477. # does not provide a timeout expiry. (integer value)
  5478. # Minimum value: 5
  5479. #default_notify_timeout = 30
  5480.  
  5481. # The duration to schedule a purge of idle sender links. Detach link after
  5482. # expiry. (integer value)
  5483. # Minimum value: 1
  5484. #default_sender_link_timeout = 600
  5485.  
  5486. # Indicates the addressing mode used by the driver.
  5487. # Permitted values:
  5488. # 'legacy' - use legacy non-routable addressing
  5489. # 'routable' - use routable addresses
  5490. # 'dynamic' - use legacy addresses if the message bus does not support routing
  5491. # otherwise use routable addressing (string value)
  5492. #addressing_mode = dynamic
  5493.  
  5494. # Enable virtual host support for those message buses that do not natively
  5495. # support virtual hosting (such as qpidd). When set to true the virtual host
  5496. # name will be added to all message bus addresses, effectively creating a
  5497. # private 'subnet' per virtual host. Set to False if the message bus supports
  5498. # virtual hosting using the 'hostname' field in the AMQP 1.0 Open performative
  5499. # as the name of the virtual host. (boolean value)
  5500. #pseudo_vhost = true
  5501.  
  5502. # address prefix used when sending to a specific server (string value)
  5503. #server_request_prefix = exclusive
  5504.  
  5505. # address prefix used when broadcasting to all servers (string value)
  5506. #broadcast_prefix = broadcast
  5507.  
  5508. # address prefix when sending to any server in group (string value)
  5509. #group_request_prefix = unicast
  5510.  
  5511. # Address prefix for all generated RPC addresses (string value)
  5512. #rpc_address_prefix = openstack.org/om/rpc
  5513.  
  5514. # Address prefix for all generated Notification addresses (string value)
  5515. #notify_address_prefix = openstack.org/om/notify
  5516.  
  5517. # Appended to the address prefix when sending a fanout message. Used by the
  5518. # message bus to identify fanout messages. (string value)
  5519. #multicast_address = multicast
  5520.  
  5521. # Appended to the address prefix when sending to a particular RPC/Notification
  5522. # server. Used by the message bus to identify messages sent to a single
  5523. # destination. (string value)
  5524. #unicast_address = unicast
  5525.  
  5526. # Appended to the address prefix when sending to a group of consumers. Used by
  5527. # the message bus to identify messages that should be delivered in a round-robin
  5528. # fashion across consumers. (string value)
  5529. #anycast_address = anycast
  5530.  
  5531. # Exchange name used in notification addresses.
  5532. # Exchange name resolution precedence:
  5533. # Target.exchange if set
  5534. # else default_notification_exchange if set
  5535. # else control_exchange if set
  5536. # else 'notify' (string value)
  5537. #default_notification_exchange = <None>
  5538.  
  5539. # Exchange name used in RPC addresses.
  5540. # Exchange name resolution precedence:
  5541. # Target.exchange if set
  5542. # else default_rpc_exchange if set
  5543. # else control_exchange if set
  5544. # else 'rpc' (string value)
  5545. #default_rpc_exchange = <None>
  5546.  
  5547. # Window size for incoming RPC Reply messages. (integer value)
  5548. # Minimum value: 1
  5549. #reply_link_credit = 200
  5550.  
  5551. # Window size for incoming RPC Request messages (integer value)
  5552. # Minimum value: 1
  5553. #rpc_server_credit = 100
  5554.  
  5555. # Window size for incoming Notification messages (integer value)
  5556. # Minimum value: 1
  5557. #notify_server_credit = 100
  5558.  
  5559. # Send messages of this type pre-settled.
  5560. # Pre-settled messages will not receive acknowledgement
  5561. # from the peer. Note well: pre-settled messages may be
  5562. # silently discarded if the delivery fails.
  5563. # Permitted values:
  5564. # 'rpc-call' - send RPC Calls pre-settled
  5565. # 'rpc-reply'- send RPC Replies pre-settled
  5566. # 'rpc-cast' - Send RPC Casts pre-settled
  5567. # 'notify' - Send Notifications pre-settled
  5568. # (multi valued)
  5569. #pre_settled = rpc-cast
  5570. #pre_settled = rpc-reply
  5571.  
  5572.  
  5573. [oslo_messaging_kafka]
  5574.  
  5575. #
  5576. # From oslo.messaging
  5577. #
  5578.  
  5579. # Max fetch bytes of Kafka consumer (integer value)
  5580. #kafka_max_fetch_bytes = 1048576
  5581.  
  5582. # Default timeout(s) for Kafka consumers (floating point value)
  5583. #kafka_consumer_timeout = 1.0
  5584.  
  5585. # DEPRECATED: Pool Size for Kafka Consumers (integer value)
  5586. # This option is deprecated for removal.
  5587. # Its value may be silently ignored in the future.
  5588. # Reason: Driver no longer uses connection pool.
  5589. #pool_size = 10
  5590.  
  5591. # DEPRECATED: The pool size limit for connections expiration policy (integer
  5592. # value)
  5593. # This option is deprecated for removal.
  5594. # Its value may be silently ignored in the future.
  5595. # Reason: Driver no longer uses connection pool.
  5596. #conn_pool_min_size = 2
  5597.  
  5598. # DEPRECATED: The time-to-live in sec of idle connections in the pool (integer
  5599. # value)
  5600. # This option is deprecated for removal.
  5601. # Its value may be silently ignored in the future.
  5602. # Reason: Driver no longer uses connection pool.
  5603. #conn_pool_ttl = 1200
  5604.  
  5605. # Group id for Kafka consumer. Consumers in one group will coordinate message
  5606. # consumption (string value)
  5607. #consumer_group = oslo_messaging_consumer
  5608.  
  5609. # Upper bound on the delay for KafkaProducer batching in seconds (floating point
  5610. # value)
  5611. #producer_batch_timeout = 0.0
  5612.  
  5613. # Size of batch for the producer async send (integer value)
  5614. #producer_batch_size = 16384
  5615.  
  5616. # The compression codec for all data generated by the producer. If not set,
  5617. # compression will not be used. Note that the allowed values of this depend on
  5618. # the kafka version (string value)
  5619. # Possible values:
  5620. # none - <No description provided>
  5621. # gzip - <No description provided>
  5622. # snappy - <No description provided>
  5623. # lz4 - <No description provided>
  5624. # zstd - <No description provided>
  5625. #compression_codec = none
  5626.  
  5627. # Enable asynchronous consumer commits (boolean value)
  5628. #enable_auto_commit = false
  5629.  
  5630. # The maximum number of records returned in a poll call (integer value)
  5631. #max_poll_records = 500
  5632.  
  5633. # Protocol used to communicate with brokers (string value)
  5634. # Possible values:
  5635. # PLAINTEXT - <No description provided>
  5636. # SASL_PLAINTEXT - <No description provided>
  5637. # SSL - <No description provided>
  5638. # SASL_SSL - <No description provided>
  5639. #security_protocol = PLAINTEXT
  5640.  
  5641. # Mechanism when security protocol is SASL (string value)
  5642. #sasl_mechanism = PLAIN
  5643.  
  5644. # CA certificate PEM file used to verify the server certificate (string value)
  5645. #ssl_cafile =
  5646.  
  5647. # Client certificate PEM file used for authentication. (string value)
  5648. #ssl_client_cert_file =
  5649.  
  5650. # Client key PEM file used for authentication. (string value)
  5651. #ssl_client_key_file =
  5652.  
  5653. # Client key password file used for authentication. (string value)
  5654. #ssl_client_key_password =
  5655.  
  5656.  
  5657. [oslo_messaging_notifications]
  5658.  
  5659. #
  5660. # From oslo.messaging
  5661. #
  5662.  
  5663. # The Drivers(s) to handle sending notifications. Possible values are messaging,
  5664. # messagingv2, routing, log, test, noop (multi valued)
  5665. # Deprecated group/name - [DEFAULT]/notification_driver
  5666. #driver =
  5667.  
  5668. # A URL representing the messaging driver to use for notifications. If not set,
  5669. # we fall back to the same configuration used for RPC. (string value)
  5670. # Deprecated group/name - [DEFAULT]/notification_transport_url
  5671. #transport_url = <None>
  5672.  
  5673. # AMQP topic used for OpenStack notifications. (list value)
  5674. # Deprecated group/name - [rpc_notifier2]/topics
  5675. # Deprecated group/name - [DEFAULT]/notification_topics
  5676. #topics = notifications
  5677.  
  5678. # The maximum number of attempts to re-send a notification message which failed
  5679. # to be delivered due to a recoverable error. 0 - No retry, -1 - indefinite
  5680. # (integer value)
  5681. #retry = -1
  5682.  
  5683.  
  5684. [oslo_messaging_rabbit]
  5685.  
  5686. #
  5687. # From oslo.messaging
  5688. #
  5689.  
  5690. # Use durable queues in AMQP. If rabbit_quorum_queue is enabled, queues will be
  5691. # durable and this value will be ignored. (boolean value)
  5692. #amqp_durable_queues = false
  5693.  
  5694. # Auto-delete queues in AMQP. (boolean value)
  5695. #amqp_auto_delete = false
  5696.  
  5697. # Connect over SSL. (boolean value)
  5698. # Deprecated group/name - [oslo_messaging_rabbit]/rabbit_use_ssl
  5699. #ssl = false
  5700.  
  5701. # SSL version to use (valid only if SSL enabled). Valid values are TLSv1 and
  5702. # SSLv23. SSLv2, SSLv3, TLSv1_1, and TLSv1_2 may be available on some
  5703. # distributions. (string value)
  5704. # Deprecated group/name - [oslo_messaging_rabbit]/kombu_ssl_version
  5705. #ssl_version =
  5706.  
  5707. # SSL key file (valid only if SSL enabled). (string value)
  5708. # Deprecated group/name - [oslo_messaging_rabbit]/kombu_ssl_keyfile
  5709. #ssl_key_file =
  5710.  
  5711. # SSL cert file (valid only if SSL enabled). (string value)
  5712. # Deprecated group/name - [oslo_messaging_rabbit]/kombu_ssl_certfile
  5713. #ssl_cert_file =
  5714.  
  5715. # SSL certification authority file (valid only if SSL enabled). (string value)
  5716. # Deprecated group/name - [oslo_messaging_rabbit]/kombu_ssl_ca_certs
  5717. #ssl_ca_file =
  5718.  
  5719. # Global toggle for enforcing the OpenSSL FIPS mode. This feature requires
  5720. # Python support. This is available in Python 3.9 in all environments and may
  5721. # have been backported to older Python versions on select environments. If the
  5722. # Python executable used does not support OpenSSL FIPS mode, an exception will
  5723. # be raised. (boolean value)
  5724. #ssl_enforce_fips_mode = false
  5725.  
  5726. # Run the health check heartbeat thread through a native python thread by
  5727. # default. If this option is equal to False then the health check heartbeat will
  5728. # inherit the execution model from the parent process. For example if the parent
  5729. # process has monkey patched the stdlib by using eventlet/greenlet then the
  5730. # heartbeat will be run through a green thread. This option should be set to
  5731. # True only for the wsgi services. (boolean value)
  5732. #heartbeat_in_pthread = false
  5733.  
  5734. # How long to wait (in seconds) before reconnecting in response to an AMQP
  5735. # consumer cancel notification. (floating point value)
  5736. # Minimum value: 0.0
  5737. # Maximum value: 4.5
  5738. #kombu_reconnect_delay = 1.0
  5739.  
  5740. # EXPERIMENTAL: Possible values are: gzip, bz2. If not set compression will not
  5741. # be used. This option may not be available in future versions. (string value)
  5742. #kombu_compression = <None>
  5743.  
  5744. # How long to wait a missing client before abandoning to send it its replies.
  5745. # This value should not be longer than rpc_response_timeout. (integer value)
  5746. # Deprecated group/name - [oslo_messaging_rabbit]/kombu_reconnect_timeout
  5747. #kombu_missing_consumer_retry_timeout = 60
  5748.  
  5749. # Determines how the next RabbitMQ node is chosen in case the one we are
  5750. # currently connected to becomes unavailable. Takes effect only if more than one
  5751. # RabbitMQ node is provided in config. (string value)
  5752. # Possible values:
  5753. # round-robin - <No description provided>
  5754. # shuffle - <No description provided>
  5755. #kombu_failover_strategy = round-robin
  5756.  
  5757. # The RabbitMQ login method. (string value)
  5758. # Possible values:
  5759. # PLAIN - <No description provided>
  5760. # AMQPLAIN - <No description provided>
  5761. # EXTERNAL - <No description provided>
  5762. # RABBIT-CR-DEMO - <No description provided>
  5763. #rabbit_login_method = AMQPLAIN
  5764.  
  5765. # How frequently to retry connecting with RabbitMQ. (integer value)
  5766. #rabbit_retry_interval = 1
  5767.  
  5768. # How long to backoff for between retries when connecting to RabbitMQ. (integer
  5769. # value)
  5770. #rabbit_retry_backoff = 2
  5771.  
  5772. # Maximum interval of RabbitMQ connection retries. Default is 30 seconds.
  5773. # (integer value)
  5774. #rabbit_interval_max = 30
  5775.  
  5776. # Try to use HA queues in RabbitMQ (x-ha-policy: all). If you change this
  5777. # option, you must wipe the RabbitMQ database. In RabbitMQ 3.0, queue mirroring
  5778. # is no longer controlled by the x-ha-policy argument when declaring a queue. If
  5779. # you just want to make sure that all queues (except those with auto-generated
  5780. # names) are mirrored across all nodes, run: "rabbitmqctl set_policy HA
  5781. # '^(?!amq\.).*' '{"ha-mode": "all"}' " (boolean value)
  5782. #rabbit_ha_queues = false
  5783.  
  5784. # Use quorum queues in RabbitMQ (x-queue-type: quorum). The quorum queue is a
  5785. # modern queue type for RabbitMQ implementing a durable, replicated FIFO queue
  5786. # based on the Raft consensus algorithm. It is available as of RabbitMQ 3.8.0.
  5787. # If set this option will conflict with the HA queues (``rabbit_ha_queues``) aka
  5788. # mirrored queues, in other words the HA queues should be disabled, quorum
  5789. # queues durable by default so the amqp_durable_queues opion is ignored when
  5790. # this option enabled. (boolean value)
  5791. #rabbit_quorum_queue = false
  5792.  
  5793. # Each time a message is redelivered to a consumer, a counter is incremented.
  5794. # Once the redelivery count exceeds the delivery limit the message gets dropped
  5795. # or dead-lettered (if a DLX exchange has been configured) Used only when
  5796. # rabbit_quorum_queue is enabled, Default 0 which means dont set a limit.
  5797. # (integer value)
  5798. #rabbit_quorum_delivery_limit = 0
  5799.  
  5800. # By default all messages are maintained in memory if a quorum queue grows in
  5801. # length it can put memory pressure on a cluster. This option can limit the
  5802. # number of messages in the quorum queue. Used only when rabbit_quorum_queue is
  5803. # enabled, Default 0 which means dont set a limit. (integer value)
  5804. # Deprecated group/name - [oslo_messaging_rabbit]/rabbit_quroum_max_memory_length
  5805. #rabbit_quorum_max_memory_length = 0
  5806.  
  5807. # By default all messages are maintained in memory if a quorum queue grows in
  5808. # length it can put memory pressure on a cluster. This option can limit the
  5809. # number of memory bytes used by the quorum queue. Used only when
  5810. # rabbit_quorum_queue is enabled, Default 0 which means dont set a limit.
  5811. # (integer value)
  5812. # Deprecated group/name - [oslo_messaging_rabbit]/rabbit_quroum_max_memory_bytes
  5813. #rabbit_quorum_max_memory_bytes = 0
  5814.  
  5815. # Positive integer representing duration in seconds for queue TTL (x-expires).
  5816. # Queues which are unused for the duration of the TTL are automatically deleted.
  5817. # The parameter affects only reply and fanout queues. Setting 0 as value will
  5818. # disable the x-expires. If doing so, make sure you have a rabbitmq policy to
  5819. # delete the queues or you deployment will create an infinite number of queue
  5820. # over time. (integer value)
  5821. # Minimum value: 0
  5822. #rabbit_transient_queues_ttl = 1800
  5823.  
  5824. # Specifies the number of messages to prefetch. Setting to zero allows unlimited
  5825. # messages. (integer value)
  5826. #rabbit_qos_prefetch_count = 0
  5827.  
  5828. # Number of seconds after which the Rabbit broker is considered down if
  5829. # heartbeat's keep-alive fails (0 disables heartbeat). (integer value)
  5830. #heartbeat_timeout_threshold = 60
  5831.  
  5832. # How often times during the heartbeat_timeout_threshold we check the heartbeat.
  5833. # (integer value)
  5834. #heartbeat_rate = 3
  5835.  
  5836. # DEPRECATED: (DEPRECATED) Enable/Disable the RabbitMQ mandatory flag for direct
  5837. # send. The direct send is used as reply, so the MessageUndeliverable exception
  5838. # is raised in case the client queue does not exist.MessageUndeliverable
  5839. # exception will be used to loop for a timeout to lets a chance to sender to
  5840. # recover.This flag is deprecated and it will not be possible to deactivate this
  5841. # functionality anymore (boolean value)
  5842. # This option is deprecated for removal.
  5843. # Its value may be silently ignored in the future.
  5844. # Reason: Mandatory flag no longer deactivable.
  5845. #direct_mandatory_flag = true
  5846.  
  5847. # Enable x-cancel-on-ha-failover flag so that rabbitmq server will cancel and
  5848. # notify consumerswhen queue is down (boolean value)
  5849. #enable_cancel_on_failover = false
  5850.  
  5851.  
  5852. [oslo_middleware]
  5853.  
  5854. #
  5855. # From oslo.middleware.http_proxy_to_wsgi
  5856. #
  5857.  
  5858. # Whether the application is behind a proxy or not. This determines if the
  5859. # middleware should parse the headers or not. (boolean value)
  5860. #enable_proxy_headers_parsing = false
  5861.  
  5862.  
  5863. [oslo_policy]
  5864.  
  5865. #
  5866. # From oslo.policy
  5867. #
  5868.  
  5869. # This option controls whether or not to enforce scope when evaluating policies.
  5870. # If ``True``, the scope of the token used in the request is compared to the
  5871. # ``scope_types`` of the policy being enforced. If the scopes do not match, an
  5872. # ``InvalidScope`` exception will be raised. If ``False``, a message will be
  5873. # logged informing operators that policies are being invoked with mismatching
  5874. # scope. (boolean value)
  5875. #enforce_scope = true
  5876.  
  5877. # This option controls whether or not to use old deprecated defaults when
  5878. # evaluating policies. If ``True``, the old deprecated defaults are not going to
  5879. # be evaluated. This means if any existing token is allowed for old defaults but
  5880. # is disallowed for new defaults, it will be disallowed. It is encouraged to
  5881. # enable this flag along with the ``enforce_scope`` flag so that you can get the
  5882. # benefits of new defaults and ``scope_type`` together. If ``False``, the
  5883. # deprecated policy check string is logically OR'd with the new policy check
  5884. # string, allowing for a graceful upgrade experience between releases with new
  5885. # policies, which is the default behavior. (boolean value)
  5886. #enforce_new_defaults = true
  5887.  
  5888. # The relative or absolute path of a file that maps roles to permissions for a
  5889. # given service. Relative paths must be specified in relation to the
  5890. # configuration file setting this option. (string value)
  5891. #policy_file = policy.yaml
  5892.  
  5893. # Default rule. Enforced when a requested rule is not found. (string value)
  5894. #policy_default_rule = default
  5895.  
  5896. # Directories where policy configuration files are stored. They can be relative
  5897. # to any directory in the search path defined by the config_dir option, or
  5898. # absolute paths. The file defined by policy_file must exist for these
  5899. # directories to be searched. Missing or empty directories are ignored. (multi
  5900. # valued)
  5901. #policy_dirs = policy.d
  5902.  
  5903. # Content Type to send and receive data for REST based policy check (string
  5904. # value)
  5905. # Possible values:
  5906. # application/x-www-form-urlencoded - <No description provided>
  5907. # application/json - <No description provided>
  5908. #remote_content_type = application/x-www-form-urlencoded
  5909.  
  5910. # server identity verification for REST based policy check (boolean value)
  5911. #remote_ssl_verify_server_crt = false
  5912.  
  5913. # Absolute path to ca cert file for REST based policy check (string value)
  5914. #remote_ssl_ca_crt_file = <None>
  5915.  
  5916. # Absolute path to client cert for REST based policy check (string value)
  5917. #remote_ssl_client_crt_file = <None>
  5918.  
  5919. # Absolute path client key file REST based policy check (string value)
  5920. #remote_ssl_client_key_file = <None>
  5921.  
  5922.  
  5923. [oslo_reports]
  5924.  
  5925. #
  5926. # From oslo.reports
  5927. #
  5928.  
  5929. # Path to a log directory where to create a file (string value)
  5930. #log_dir = <None>
  5931.  
  5932. # The path to a file to watch for changes to trigger the reports, instead of
  5933. # signals. Setting this option disables the signal trigger for the reports. If
  5934. # application is running as a WSGI application it is recommended to use this
  5935. # instead of signals. (string value)
  5936. #file_event_handler = <None>
  5937.  
  5938. # How many seconds to wait between polls when file_event_handler is set (integer
  5939. # value)
  5940. #file_event_handler_interval = 1
  5941.  
  5942.  
  5943. [paste_deploy]
  5944. flavor = keystone
  5945. api_paste_config = /etc/glance/glance-api-paste.ini
  5946.  
  5947. #
  5948. # From glance.api
  5949. #
  5950.  
  5951. #
  5952. # Deployment flavor to use in the server application pipeline.
  5953. #
  5954. # Provide a string value representing the appropriate deployment
  5955. # flavor used in the server application pipeline. This is typically
  5956. # the partial name of a pipeline in the paste configuration file with
  5957. # the service name removed.
  5958. #
  5959. # For example, if your paste section name in the paste configuration
  5960. # file is [pipeline:glance-api-keystone], set ``flavor`` to
  5961. # ``keystone``.
  5962. #
  5963. # Possible values:
  5964. # * String value representing a partial pipeline name.
  5965. #
  5966. # Related Options:
  5967. # * config_file
  5968. #
  5969. # (string value)
  5970. #
  5971. # This option has a sample default set, which means that
  5972. # its actual default value may vary from the one documented
  5973. # below.
  5974. #flavor = keystone
  5975.  
  5976. #
  5977. # Name of the paste configuration file.
  5978. #
  5979. # Provide a string value representing the name of the paste
  5980. # configuration file to use for configuring pipelines for
  5981. # server application deployments.
  5982. #
  5983. # NOTES:
  5984. # * Provide the name or the path relative to the glance directory
  5985. # for the paste configuration file and not the absolute path.
  5986. # * The sample paste configuration file shipped with Glance need
  5987. # not be edited in most cases as it comes with ready-made
  5988. # pipelines for all common deployment flavors.
  5989. #
  5990. # If no value is specified for this option, the ``paste.ini`` file
  5991. # with the prefix of the corresponding Glance service's configuration
  5992. # file name will be searched for in the known configuration
  5993. # directories. (For example, if this option is missing from or has no
  5994. # value set in ``glance-api.conf``, the service will look for a file
  5995. # named ``glance-api-paste.ini``.) If the paste configuration file is
  5996. # not found, the service will not start.
  5997. #
  5998. # Possible values:
  5999. # * A string value representing the name of the paste configuration
  6000. # file.
  6001. #
  6002. # Related Options:
  6003. # * flavor
  6004. #
  6005. # (string value)
  6006. #
  6007. # This option has a sample default set, which means that
  6008. # its actual default value may vary from the one documented
  6009. # below.
  6010. config_file = /etc/glance/glance-api-paste.ini
  6011.  
  6012.  
  6013. [profiler]
  6014.  
  6015. #
  6016. # From glance.api
  6017. #
  6018.  
  6019. #
  6020. # Enable the profiling for all services on this node.
  6021. #
  6022. # Default value is False (fully disable the profiling feature).
  6023. #
  6024. # Possible values:
  6025. #
  6026. # * True: Enables the feature
  6027. # * False: Disables the feature. The profiling cannot be started via this
  6028. # project
  6029. # operations. If the profiling is triggered by another project, this project
  6030. # part will be empty.
  6031. # (boolean value)
  6032. # Deprecated group/name - [profiler]/profiler_enabled
  6033. #enabled = false
  6034.  
  6035. #
  6036. # Enable SQL requests profiling in services.
  6037. #
  6038. # Default value is False (SQL requests won't be traced).
  6039. #
  6040. # Possible values:
  6041. #
  6042. # * True: Enables SQL requests profiling. Each SQL query will be part of the
  6043. # trace and can the be analyzed by how much time was spent for that.
  6044. # * False: Disables SQL requests profiling. The spent time is only shown on a
  6045. # higher level of operations. Single SQL queries cannot be analyzed this way.
  6046. # (boolean value)
  6047. #trace_sqlalchemy = false
  6048.  
  6049. #
  6050. # Enable python requests package profiling.
  6051. #
  6052. # Supported drivers: jaeger+otlp
  6053. #
  6054. # Default value is False.
  6055. #
  6056. # Possible values:
  6057. #
  6058. # * True: Enables requests profiling.
  6059. # * False: Disables requests profiling.
  6060. # (boolean value)
  6061. #trace_requests = false
  6062.  
  6063. #
  6064. # Secret key(s) to use for encrypting context data for performance profiling.
  6065. #
  6066. # This string value should have the following format: <key1>[,<key2>,...<keyn>],
  6067. # where each key is some random string. A user who triggers the profiling via
  6068. # the REST API has to set one of these keys in the headers of the REST API call
  6069. # to include profiling results of this node for this particular project.
  6070. #
  6071. # Both "enabled" flag and "hmac_keys" config options should be set to enable
  6072. # profiling. Also, to generate correct profiling information across all services
  6073. # at least one key needs to be consistent between OpenStack projects. This
  6074. # ensures it can be used from client side to generate the trace, containing
  6075. # information from all possible resources.
  6076. # (string value)
  6077. #hmac_keys = SECRET_KEY
  6078.  
  6079. #
  6080. # Connection string for a notifier backend.
  6081. #
  6082. # Default value is ``messaging://`` which sets the notifier to oslo_messaging.
  6083. #
  6084. # Examples of possible values:
  6085. #
  6086. # * ``messaging://`` - use oslo_messaging driver for sending spans.
  6087. # * ``redis://127.0.0.1:6379`` - use redis driver for sending spans.
  6088. # * ``mongodb://127.0.0.1:27017`` - use mongodb driver for sending spans.
  6089. # * ``elasticsearch://127.0.0.1:9200`` - use elasticsearch driver for sending
  6090. # spans.
  6091. # * ``jaeger://127.0.0.1:6831`` - use jaeger tracing as driver for sending
  6092. # spans.
  6093. # (string value)
  6094. #connection_string = messaging://
  6095.  
  6096. #
  6097. # Document type for notification indexing in elasticsearch.
  6098. # (string value)
  6099. #es_doc_type = notification
  6100.  
  6101. #
  6102. # This parameter is a time value parameter (for example: es_scroll_time=2m),
  6103. # indicating for how long the nodes that participate in the search will maintain
  6104. # relevant resources in order to continue and support it.
  6105. # (string value)
  6106. #es_scroll_time = 2m
  6107.  
  6108. #
  6109. # Elasticsearch splits large requests in batches. This parameter defines
  6110. # maximum size of each batch (for example: es_scroll_size=10000).
  6111. # (integer value)
  6112. #es_scroll_size = 10000
  6113.  
  6114. #
  6115. # Redissentinel provides a timeout option on the connections.
  6116. # This parameter defines that timeout (for example: socket_timeout=0.1).
  6117. # (floating point value)
  6118. #socket_timeout = 0.1
  6119.  
  6120. #
  6121. # Redissentinel uses a service name to identify a master redis service.
  6122. # This parameter defines the name (for example:
  6123. # ``sentinal_service_name=mymaster``).
  6124. # (string value)
  6125. #sentinel_service_name = mymaster
  6126.  
  6127. #
  6128. # Enable filter traces that contain error/exception to a separated place.
  6129. #
  6130. # Default value is set to False.
  6131. #
  6132. # Possible values:
  6133. #
  6134. # * True: Enable filter traces that contain error/exception.
  6135. # * False: Disable the filter.
  6136. # (boolean value)
  6137. #filter_error_trace = false
  6138.  
  6139.  
  6140. [store_type_location_strategy]
  6141.  
  6142. #
  6143. # From glance.api
  6144. #
  6145.  
  6146. # DEPRECATED:
  6147. # Preference order of storage backends.
  6148. #
  6149. # Provide a comma separated list of store names in the order in
  6150. # which images should be retrieved from storage backends.
  6151. # These store names must be registered with the ``stores``
  6152. # configuration option.
  6153. #
  6154. # NOTE: The ``store_type_preference`` configuration option is applied
  6155. # only if ``store_type`` is chosen as a value for the
  6156. # ``location_strategy`` configuration option. An empty list will not
  6157. # change the location order.
  6158. #
  6159. # Possible values:
  6160. # * Empty list
  6161. # * Comma separated list of registered store names. Legal values are:
  6162. # * file
  6163. # * http
  6164. # * rbd
  6165. # * swift
  6166. # * cinder
  6167. # * vmware
  6168. #
  6169. # Related options:
  6170. # * location_strategy
  6171. # * stores
  6172. #
  6173. # (list value)
  6174. # This option is deprecated for removal since Caracal.
  6175. # Its value may be silently ignored in the future.
  6176. # Reason:
  6177. # In Bobcat, a new weighing mechanism has been introduced, which makes the
  6178. # location strategy obsolete. This option is scheduled to be removed during the
  6179. # Dalmatian development cycle.
  6180. #store_type_preference =
  6181.  
  6182.  
  6183. [task]
  6184.  
  6185. #
  6186. # From glance.api
  6187. #
  6188.  
  6189. # Time in hours for which a task lives after, either succeeding or failing
  6190. # (integer value)
  6191. # Deprecated group/name - [DEFAULT]/task_time_to_live
  6192. #task_time_to_live = 48
  6193.  
  6194. #
  6195. # Task executor to be used to run task scripts.
  6196. #
  6197. # Provide a string value representing the executor to use for task
  6198. # executions. By default, ``TaskFlow`` executor is used.
  6199. #
  6200. # ``TaskFlow`` helps make task executions easy, consistent, scalable
  6201. # and reliable. It also enables creation of lightweight task objects
  6202. # and/or functions that are combined together into flows in a
  6203. # declarative manner.
  6204. #
  6205. # Possible values:
  6206. # * taskflow
  6207. #
  6208. # Related Options:
  6209. # * None
  6210. #
  6211. # (string value)
  6212. #task_executor = taskflow
  6213.  
  6214. #
  6215. # Absolute path to the work directory to use for asynchronous
  6216. # task operations.
  6217. #
  6218. # The directory set here will be used to operate over images -
  6219. # normally before they are imported in the destination store.
  6220. #
  6221. # NOTE: When providing a value for ``work_dir``, please make sure
  6222. # that enough space is provided for concurrent tasks to run
  6223. # efficiently without running out of space.
  6224. #
  6225. # A rough estimation can be done by multiplying the number of
  6226. # ``max_workers`` with an average image size (e.g 500MB). The image
  6227. # size estimation should be done based on the average size in your
  6228. # deployment. Note that depending on the tasks running you may need
  6229. # to multiply this number by some factor depending on what the task
  6230. # does. For example, you may want to double the available size if
  6231. # image conversion is enabled. All this being said, remember these
  6232. # are just estimations and you should do them based on the worst
  6233. # case scenario and be prepared to act in case they were wrong.
  6234. #
  6235. # Possible values:
  6236. # * String value representing the absolute path to the working
  6237. # directory
  6238. #
  6239. # Related Options:
  6240. # * None
  6241. #
  6242. # (string value)
  6243. #
  6244. # This option has a sample default set, which means that
  6245. # its actual default value may vary from the one documented
  6246. # below.
  6247. #work_dir = /work_dir
  6248.  
  6249.  
  6250. [taskflow_executor]
  6251.  
  6252. #
  6253. # From glance.api
  6254. #
  6255.  
  6256. #
  6257. # Set the taskflow engine mode.
  6258. #
  6259. # Provide a string type value to set the mode in which the taskflow
  6260. # engine would schedule tasks to the workers on the hosts. Based on
  6261. # this mode, the engine executes tasks either in single or multiple
  6262. # threads. The possible values for this configuration option are:
  6263. # ``serial`` and ``parallel``. When set to ``serial``, the engine runs
  6264. # all the tasks in a single thread which results in serial execution
  6265. # of tasks. Setting this to ``parallel`` makes the engine run tasks in
  6266. # multiple threads. This results in parallel execution of tasks.
  6267. #
  6268. # Possible values:
  6269. # * serial
  6270. # * parallel
  6271. #
  6272. # Related options:
  6273. # * max_workers
  6274. #
  6275. # (string value)
  6276. # Possible values:
  6277. # serial - <No description provided>
  6278. # parallel - <No description provided>
  6279. #engine_mode = parallel
  6280.  
  6281. #
  6282. # Set the number of engine executable tasks.
  6283. #
  6284. # Provide an integer value to limit the number of workers that can be
  6285. # instantiated on the hosts. In other words, this number defines the
  6286. # number of parallel tasks that can be executed at the same time by
  6287. # the taskflow engine. This value can be greater than one when the
  6288. # engine mode is set to parallel.
  6289. #
  6290. # Possible values:
  6291. # * Integer value greater than or equal to 1
  6292. #
  6293. # Related options:
  6294. # * engine_mode
  6295. #
  6296. # (integer value)
  6297. # Minimum value: 1
  6298. # Deprecated group/name - [task]/eventlet_executor_pool_size
  6299. #max_workers = 10
  6300.  
  6301. #
  6302. # Set the desired image conversion format.
  6303. #
  6304. # Provide a valid image format to which you want images to be
  6305. # converted before they are stored for consumption by Glance.
  6306. # Appropriate image format conversions are desirable for specific
  6307. # storage backends in order to facilitate efficient handling of
  6308. # bandwidth and usage of the storage infrastructure.
  6309. #
  6310. # By default, ``conversion_format`` is not set and must be set
  6311. # explicitly in the configuration file.
  6312. #
  6313. # The allowed values for this option are ``raw``, ``qcow2`` and
  6314. # ``vmdk``. The ``raw`` format is the unstructured disk format and
  6315. # should be chosen when RBD or Ceph storage backends are used for
  6316. # image storage. ``qcow2`` is supported by the QEMU emulator that
  6317. # expands dynamically and supports Copy on Write. The ``vmdk`` is
  6318. # another common disk format supported by many common virtual machine
  6319. # monitors like VMWare Workstation.
  6320. #
  6321. # Possible values:
  6322. # * qcow2
  6323. # * raw
  6324. # * vmdk
  6325. #
  6326. # Related options:
  6327. # * disk_formats
  6328. #
  6329. # (string value)
  6330. # Possible values:
  6331. # qcow2 - <No description provided>
  6332. # raw - <No description provided>
  6333. # vmdk - <No description provided>
  6334. #
  6335. # This option has a sample default set, which means that
  6336. # its actual default value may vary from the one documented
  6337. # below.
  6338. #conversion_format = raw
  6339.  
  6340.  
  6341. [vault]
  6342.  
  6343. #
  6344. # From castellan.config
  6345. #
  6346.  
  6347. # root token for vault (string value)
  6348. #root_token_id = <None>
  6349.  
  6350. # AppRole role_id for authentication with vault (string value)
  6351. #approle_role_id = <None>
  6352.  
  6353. # AppRole secret_id for authentication with vault (string value)
  6354. #approle_secret_id = <None>
  6355.  
  6356. # Mountpoint of KV store in Vault to use, for example: secret (string value)
  6357. #kv_mountpoint = secret
  6358.  
  6359. # Path relative to root of KV store in Vault to use. (string value)
  6360. #kv_path = <None>
  6361.  
  6362. # Version of KV store in Vault to use, for example: 2 (integer value)
  6363. #kv_version = 2
  6364.  
  6365. # Use this endpoint to connect to Vault, for example: "http://127.0.0.1:8200"
  6366. # (string value)
  6367. #vault_url = http://127.0.0.1:8200
  6368.  
  6369. # Absolute path to ca cert file (string value)
  6370. #ssl_ca_crt_file = <None>
  6371.  
  6372. # SSL Enabled/Disabled (boolean value)
  6373. #use_ssl = false
  6374.  
  6375. # Vault Namespace to use for all requests to Vault. Vault Namespaces feature is
  6376. # available only in Vault Enterprise (string value)
  6377. #namespace = <None>
  6378.  
  6379.  
  6380. [wsgi]
  6381.  
  6382. #
  6383. # From glance.api
  6384. #
  6385.  
  6386. #
  6387. # The number of threads (per worker process) in the pool for processing
  6388. # asynchronous tasks. This controls how many asynchronous tasks (i.e. for
  6389. # image interoperable import) each worker can run at a time. If this is
  6390. # too large, you *may* have increased memory footprint per worker and/or you
  6391. # may overwhelm other system resources such as disk or outbound network
  6392. # bandwidth. If this is too small, image import requests will have to wait
  6393. # until a thread becomes available to begin processing. (integer value)
  6394. # Minimum value: 1
  6395. #task_pool_threads = 16
  6396.  
  6397. #
  6398. # Path to the python interpreter to use when spawning external
  6399. # processes. If left unspecified, this will be sys.executable, which should
  6400. # be the same interpreter running Glance itself. However, in some situations
  6401. # (for example, uwsgi) sys.executable may not actually point to a python
  6402. # interpreter and an alternative value must be set. (string value)
  6403. #python_interpreter = <None>
  6404.  
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement