A Kubernetes cluster with Heat
These Heat templates will deploy a Kubernetes cluster that supports automatic scaling based on CPU load.
The cluster uses Flannel to provide an overlay network connecting pods deployed on different minions.
These templates will work with the Kilo version of Heat. They may work with Juno as well as soon as #1402894 is resolved.
These templates will work with either CentOS Atomic Host or Fedora 21 Atomic.
You can enable the VXLAN backend for flannel by setting the "flannel_use_vxlan" parameter to "true", but I have run into kernel crashes using that backend with CentOS 7. It seems to work fine with Fedora 21.
You can enable docker registry v2 by setting the "registry_enabled" parameter to "true".
Creating the stack
Creating an environment file
local.yaml with parameters specific to
parameters: ssh_key_name: testkey external_network: public dns_nameserver: 192.168.200.1 server_image: centos-7-atomic-20150101 registry_enabled: true registry_username: username registry_password: password registry_domain: domain registry_trust_id: trust_id registry_auth_url: auth_url registry_region: region registry_container: container
And then create the stack, referencing that environment file:
heat stack-create -f kubecluster.yaml -e local.yaml my-kube-cluster
You must provide values for:
If you enable docker registry v2, you must provide values for:
Interacting with Kubernetes
You can get the ip address of the Kubernetes master using the
heat output-show command:
$ heat output-show my-kube-cluster kube_masters "192.168.200.86"
You can ssh into that server as the
$ ssh email@example.com
And once logged in you can run
$ kubectl get minions NAME LABELS STATUS 10.0.0.4 <none> Ready
You can log into your minions using the
minion user as well. You
can get a list of minion addresses by running:
$ heat output-show my-kube-cluster kube_minions [ "192.168.200.182" ]
You can get the docker registry v2 address: $ heat output-show my-kube-cluster registry_address localhost:5000
The templates install an example Pod and Service description into
/etc/kubernetes/examples. You can deploy this with the following
$ kubectl create -f /etc/kubernetes/examples/web.service $ kubectl create -f /etc/kubernetes/examples/web.pod
This will deploy a minimal webserver and a service. You can use
kubectl get pods and
kubectl get services to see the results of
Copyright 2014 Lars Kellogg-Stedman firstname.lastname@example.org
Licensed under the Apache License, Version 2.0 (the "License"); you may not use these files except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Please submit bugs and pull requests via the GitHub repository at https://github.com/larsks/heat-kubernetes/.
When submitting pull requests:
Please ensure that each pull request contains a single commit and contains only related changes. Put unrelated changes in multiple pull requests.
Please avoid conflating new features with stylistic/formatting/cleanup changes.