Published: June 30, 2019
Updated: January 07, 2023
Tags: OpenStack, Rancher, Kubernetes
3 min read

Adding OpenStack Cloud Provider To Rancher Cluster

A follow-up to blog post Deploying Rancher On OpenStack

Tested on Rancher 2.2.4

Rancher Cloud Providers

Rancher cloud providers are similar to Kubernetes cloud providers [1].
Kubernetes cloud provider is a resource that allows you to leverage your cloud infrastructure to supply additional infrastructure resources (storage/network) to your Kubernetes cluster.

While Kubernetes supports various cloud providers, Rancher Kubernetes Engine supports the following [2]:

  • AWS
  • Azure
  • OpenStack
  • vSphere
  • Custom cloud provider

Adding OpenStack Cloud Provider

As of now, Rancher does not have an option in GUI to configure an OpenStack cloud provider.
Details must be manually added to the YAML configuration.

Cloud providers can be added during and after cluster deployment.

An OpenStack cloud provider will allow Kubernetes to access Cinder(block storage) for persistent volumes, Octavia for layer 7 load balancing, and Neutron for load balancing.

Cluster Configuration

In a cluster configuration, there is an option to view and edit the YAML cluster definition:
Cluster configuration
YAML section will be shown:
Cluter YAML

OpenStack Cloud Provider YAML

A cloud provider is defined by YAML:

# Sample OpenStack cloud provider config
  name: "openstack"
      ignore-volume-az: true
      trust-device-path: false
      auth-url: "XXXXX" # Keystone Auth URL
      domain-id: "XXXXX" # Identity v3 domain ID
      tenant-id: "XXXX" # Project ID
      username: "XXXX" # OpenStack Username
      password: "XXXX" # OpenStack Password
      request-timeout: 0

To add an OpenStack cloud provider to the Rancher Kubernetes cluster, add the following section to the cluster definition (refer to documentation [3] for a complete list of options):
Modified cluster YAML

Cluster Update/Creation

After configuring YAML, your cluster will be deployed/updated:
Cluster update
Wait until the cluster is deployed/updated:
Rancher Cluster

Verifying OpenStack Cloud Provider

At this point, we only configured Kubernetes to access OpenStack.
Additional configuration must be done to utilize OpenStack resources which is out of the scope of this blog post.

Node Label

Once an OpenStack cloud provider is set, nodes will receive an additional label
Rancher cluster nodes

cloud-config File

Cloud providers are stored in the /etc/kubernetes/cloud-config file on Kubernetes nodes and will contain the configuration needed by Kubernetes to communicate with OpenStack:

auth-url  = XXXX
username  = XXXX
password  = XXXX
tenant-id = XXXX
domain-id = XXXX


ignore-volume-az = true




Cloud providers grant additional resources to Kubernetes clusters.

OpenStack is a supported cloud provider that extends the storage and network capabilities of the Kubernetes cluster.

By YAML cluster definition, additional cloud providers may be added during/post Rancher Kubernetes cluster deployment.

  1. Kubernetes Documentation - Cloud Providers ↩︎

  2. Rancher Documentation - Cloud Providers ↩︎

  3. Rancher Documentation - OpenStack Cloud Provider ↩︎