From 4d15b60b5b62414177705d27ea076dec1593d4c9 Mon Sep 17 00:00:00 2001 From: Stephen Gordon Date: Wed, 22 Nov 2017 14:51:03 -0500 Subject: [PATCH] Add OpenStack provider `search-order` parameter Add the OpenStack provider `search-order` parameter which is used to influence the retrieval of instance metadata. See also: https://github.com/kubernetes/kubernetes/pull/52628 https://github.com/kubernetes/kubernetes/issues/52378 --- .../cluster-administration/cloud-providers.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/concepts/cluster-administration/cloud-providers.md b/docs/concepts/cluster-administration/cloud-providers.md index 739476217c..7b31be5cd7 100644 --- a/docs/concepts/cluster-administration/cloud-providers.md +++ b/docs/concepts/cluster-administration/cloud-providers.md @@ -213,6 +213,28 @@ provider configuration: bs-version=v2 ``` +#### Metadata +These configuration options for the OpenStack provider pertain to metadata and +should appear in the `[Metadata]` section of the `cloud.conf` file: + +* `search-order` (Optional): This configuration key influences the way that the + provider retrieves metadata relating to the instance(s) in which it runs. The + default value of `configDrive,metadataService` results in the provider + retrieving metadata relating to the instance from the config drive first if + available and then the metadata service. Alternative values are: + * `configDrive` - Only retrieve instance metadata from the configuration + drive. + * `metadataService` - Only retrieve instance metadata from the metadata + service. + * `metadataService,configDrive` - Retrieve instance metadata from the metadata + service first if available, then the configuration drive. + + Influencing this behavior may be desirable as the metadata on the + configuration drive may grow stale over time, whereas the metadata service + always provides the most up to date view. Not all OpenStack clouds provide + both configuration drive and metadata service though and only one or the other + may be available which is why the default is to check both. + #### Router These configuration options for the OpenStack provider pertain to routing and should appear in the `[Route]` section of the `cloud.conf` file: