No description or website provided.
Clone or download
flaper87 and k8s-ci-robot Recommend using v1.12.1 (#60)
* Update kubeadm's config to alpha3

* Update kubelet version to 1.12.1

We had 1.9.4 in our templates. It's time to update the kubelet version.

This will require users of minikube <30 to also add `--minikube
kubernetes-version=v1.12.1` to their `clusterctl` command.

* Recommend using v1.12.1

Deployments using v1.10.0 are broken unless
`--feature-gates=CustomResourceSubresources=true` is passed to the
cluster creation and `.spec.subresources.status` is added to the CRD

Rather than doing that and forcing the use of an older version of k8s,
let's take this opportunity to update the minimum required version to
the latest available.
Latest commit c9ff8fb Oct 17, 2018

Kubernetes cluster-api-provider-openstack Project

This repository hosts a concrete implementation of an OpenStack provider for the cluster-api project.

Community, discussion, contribution, and support

Learn how to engage with the Kubernetes community on the community page.

You can reach the maintainers of this project at:

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.

Getting Started


  1. Install kubectl (see here).

  2. Install minikube, version 0.30.0 or greater.

  3. Install a driver for minikube. For Linux, we recommend kvm2. For MacOS, we recommend VirtualBox.

  4. An appropriately configured Go development environment

  5. Build the clusterctl tool

    git clone $GOPATH/src/
    cd $GOPATH/src/
    go build

Cluster Creation

  1. Create the cluster.yaml, machines.yaml, provider-components.yaml, and addons.yaml files if needed:

    cd examples/openstack
    cd ../..

    **Note: **When generating provider-components.yaml, you need input your openstack cloud provider information, which include:

    • user-name
    • domain-name
    • project-id
    • region-name
    • auth-url
    • password

    You can get those information from your cloud provider.

  2. Create a cluster:

    clusterctl create cluster --minikube kubernetes-version=v1.12.1 --provider openstack -c examples/openstack/out/cluster.yaml -m examples/openstack/out/machines.yaml -p examples/openstack/out/provider-components.yaml

To choose a specific minikube driver, please use the --vm-driver command line parameter. For example to use the kvm2 driver with clusterctl you woud add --vm-driver kvm2, for linux, if you haven't installed any driver, you can add --vm-driver none.

Additional advanced flags can be found via help.

clusterctl create cluster --help

Interacting with your cluster

Once you have created a cluster, you can interact with the cluster and machine resources using kubectl:

kubectl --kubeconfig=kubeconfig get clusters
kubectl --kubeconfig=kubeconfig get machines
kubectl --kubeconfig=kubeconfig get machines -o yaml

Cluster Deletion

This guide explains how to delete all resources that were created as part of your openstack Cluster API Kubernetes cluster.

  1. Delete all of the node Machines in the cluster. Make sure to wait for the corresponding Nodes to be deleted before moving onto the next step. After this step, the master node will be the only remaining node.

    kubectl --kubeconfig=kubeconfig delete machines -l set=node
    kubectl --kubeconfig=kubeconfig get nodes
  2. Delete the master machine.

    kubectl --kubeconfig=kubeconfig delete machines -l set=master
  3. Delete the ssh keypair that were created for your cluster machine.

    rm -rf $HOME/.ssh/openstack_tmp*