Improved documentation
1 file changed
tree: a01de1793df943b25ecdcdd7c89bd51b19fea4dd
  1. .gitignore
  2. Dockerfile
  3. LICENSE-2.0
  4. Makefile
  6. cloudstack.go
  7. cloudstack_instances.go
  8. cloudstack_loadbalancer.go
  9. cloudstack_test.go
  10. cmd/
  11. deployment.yaml
  12. go.mod
  13. go.sum
  14. service.yaml
  15. vendor/

Cloudstack Cloud Controller Manager

A Cloud Controller Manager to facilitate Kubernetes deployments on Cloudstack.

Based on the old Cloudstack provider in Kubernetes that will be removed soon.


There are several notable differences to the old Kubernetes CloudStack cloud provider that need to be taken into account when migrating to the standalone controller.

Load Balancer

Load balancer rule names now include the protocol in addition to the LB name and service port. This was added to distinguish tcp, udp and tcp-proxy services operating on the same port. Without this change, it would not be possible to map a service that runs on both TCP and UDP port 8000, for example.

:warning: If you have existing rules, remove them before the migration, and add them back afterwards.

If you don‘t do this, you will end up with duplicate rules for the same service, which won’t work.


When kubelet still contained cloud provider code, node metadata was fetched from the DHCP server running on the Virtual Router.

This is no longer possible with the standalone cloud controller, so all metadata now comes from the Cloudstack API. Some metadata may be missing or wrong, please file bugs when this happens to you.

Node Labels

It is recommended to launch kubelet with the following parameter:

This will treat the node as ‘uninitialized’ and cause the CCM to apply metadata labels from CloudStack automatically.

Supported labels are:

  • (= the instance name)
  • (= the compute offering)
  • (= the zone)
  • (also = the zone)

It is also possible to trigger this process manually by issuing the following command:

kubectl taint nodes <my-node-without-labels>


All dependencies are vendored. You need GNU make, git and Go 1.11 to build cloudstack-ccm.

It's still possible to build with Go 1.10, but you need to remove the option -mod vendor from the cloudstack-ccm compilation target in the Makefile.

go get
cd ${GOPATH}/src/

To build the cloudstack-cloud-controller-manager container, please use the provided Docker file:

docker build . -t swisstxt/cloudstack-cloud-controller-manager:latest


Prebuilt containers are posted on Docker Hub.


If you intend to deploy the CCM in a Kubernetes cluster, please see deployment.yaml for an example configuration. The comments explain how to configure Cloudstack API access.


This CCM supports TCP, UDP and TCP-Proxy LoadBalancer deployments.

For UDP and Proxy Protocol support, CloudStack 4.6 or later is required.

Since kube-proxy does not support the Proxy Protocol or UDP, you should connect this directly to containers, for example by deploying a DaemonSet and setting hostNetwork: true.

See service.yaml for an example Service deployment and part of a suitable configuration for an ingress controller.


You need a local instance of the CloudStack Management Server or a ‘real’ one to connect to. The CCM supports the same cloudstack.ini configuration file format used by the cs tool, so you can simply point it to that.

./cloudstack-ccm --cloud-provider external-cloudstack --cloud-config ~/.cloudstack.ini --master k8s-apiserver

Replace k8s-apiserver with the host name of your Kubernetes development clusters's API server.

If you don't have a ‘real’ CloudStack installation, you can also launch a local simulator instance instead. This is very useful for dry-run testing.


© 2018 SWISS TXT AG and the Kubernetes authors.

See LICENSE-2.0 for permitted usage.