An opinionated way to deploy a Kubernetes cluster on top of an OpenStack cloud.
It is based on the following tools:
kubeadm
ansible
The following mandatory environment variables need to be set before calling ansible-playbook
:
OS_*
: standard OpenStack environment variables such asOS_AUTH_URL
,OS_USERNAME
, ...KEY
: name of an existing SSH keypair
The following optional environment variables can also be set:
NAME
: name of the Kubernetes cluster, used to derive instance names,kubectl
configuration and security group nameIMAGE
: name of an existing Ubuntu 16.04 imageEXTERNAL_NETWORK
: name of the neutron external network, defaults to 'public'FLOATING_IP_POOL
: name of the floating IP poolFLOATING_IP_NETWORK_UUID
: uuid of the floating IP network (required for LBaaSv2)NODE_MEMORY
: how many MB of memory should nodes have, defaults to 4GBNODE_FLAVOR
: allows to configure the exact OpenStack flavor name or ID to use for the nodes. When set, theNODE_MEMORY
setting is ignored.NODE_COUNT
: how many nodes should we provision, defaults to 3NODE_AUTO_IP
assign a floating IP to nodes, defaults to FalseNODE_DELETE_FIP
: delete floating IP when node is destroyed, defaults to TrueMASTER_BOOT_FROM_VOLUME
: boot the master instance on a volume for data persistence, defaults to TrueMASTER_TERMINATE_VOLUME
: delete the volume when master instance is destroy, defaults to TrueMASTER_VOLUME_SIZE
: size of the master volumeMASTER_MEMORY
: how many MB of memory should master have, defaults to 4 GBMASTER_FLAVOR
: allows to configure the exact OpenStack flavor name or ID to use for the master. When set, theMASTER_MEMORY
setting is ignored.INCLUDE_HELM
: installs helm to the cluster, defaults to FalseHELM_REPOS
: a list of additional helm repos to add, separated by semicolons. Example:charts* https://github.com/helm/charts;mycharts https://github.com/dev/mycharts
HELM_INSTALL
: a list of helm charts and their parameters to install, separated by semicolons. Example:mycharts/mychart;charts/somechart --name somechart --namespace somenamespace
Spin up a new cluster:
$ ansible-playbook site.yaml
Destroy the cluster:
$ ansible-playbook destroy.yaml
Upgrade the cluster:
The upgrade.yaml
playbook implements the upgrade steps described in https://kubernetes.io/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade-1-11/
After editing in group_vars/all.yaml
the kubernetes_version
and kubernetes_ubuntu_version
variables, you can run the following commands.
$ ansible-playbook upgrade.yaml
$ ansible-playbook site.yaml
- Ansible (tested with version 2.4 but probably also works with older ones)
- Shade library required by Ansible OpenStack modules (
python-shade
for Debian)
The following environment variables needs to be defined:
OS_AUTH_URL
OS_PASSWORD
OS_USERNAME
OS_DOMAIN_NAME
- François Deppierraz [email protected]
- Oli Schacher [email protected]
- Saverio Proto [email protected]
- @HaseHarald