From cf8c46ab3f4ac62323d2c128b4c405e85ae4e739 Mon Sep 17 00:00:00 2001 From: Stephen Gordon Date: Sun, 10 Dec 2017 15:58:17 -0500 Subject: [PATCH] Document new `use-octavia` and `ignore-volume-az` options Document new `use-octavia` and `ignore-volume-az` options for the OpenStack cloud provider implementation. These were added as a result of these two PRs respectively: * https://github.com/kubernetes/kubernetes/pull/55393 * https://github.com/kubernetes/kubernetes/pull/53523 --- .../cluster-administration/cloud-providers.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/concepts/cluster-administration/cloud-providers.md b/docs/concepts/cluster-administration/cloud-providers.md index 739476217c..0a327c2ba1 100644 --- a/docs/concepts/cluster-administration/cloud-providers.md +++ b/docs/concepts/cluster-administration/cloud-providers.md @@ -151,6 +151,11 @@ file: values are `v1` or `v2`. Where no value is provided automatic detection will select the highest supported version exposed by the underlying OpenStack cloud. +* `use-octavia` (Optional): Used to determine whether to look for and use an + Octavia LBaaS V2 service catalog endpoint. Valid values are `true` or `false`. + Where `true` is specified and an Octaiva LBaaS V2 entry can not be found, the + provider will fall back and attempt to find a Neutron LBaaS V2 endpoint + instead. The default value is `false`. * `subnet-id` (Optional): Used to specify the id of the subnet you want to create your loadbalancer on. Can be found at Network > Networks. Click on the respective network to get its subnets. @@ -195,6 +200,12 @@ and should appear in the `[BlockStorage]` section of the `cloud.conf` file: provided by Cinder. The default value of `false` results in the discovery of the device path based on it's serial number and /dev/disk/by-id mapping and is the recommended approach. +* `ignore-volume-az` (Optional): Used to influence availability zone use when + attaching Cinder volumes. When Nova and Cinder have different availability + zones, this should be set to `true`. This is most commonly the case where + there are many Nova availability zones but only one Cinder availability zone. + The default value is `false` to preserve the behavior used in earlier + releases, but may change in the future. If deploying Kubernetes versions <= 1.8 on an OpenStack deployment that uses paths rather than ports to differentiate between endpoints it may be necessary