cloudsoft.io

Kubernetes Cluster Tutorial

Introduction

This tutorial is focused on deploying a production ready Kubernetes cluster.

Overview

The production ready Kubernetes cluster is comprised of the following components:

Pre-requisites

This tutorial assumes you have completed the getting started section of this website and have installed the Cloudsoft AMP CLI.

Kubernetes cluster

This Kubernetes cluster contains a manager and a configurable number of workers. It requires a pre-existing discovery mechanism and references to a CA server entity. The cluster has an AutoScalerPolicy and will scale up due to high CPU usage. It also has a replacer policy that will detect the failure and replace the failed worker.

etcd Cluster

Used as a discovery backend for the Kubernetes cluster.

CA Server

This is used to provide TLS certificates for the Kubernetes cluster. This component is designed to be easily replaced. It is strongly recommended that this component is replaced with a production grade CA server of your choice.

Instructions

Setup a cloud location

Firstly, we need to setup a location to deploy the Kubernetes cluster to. We recommend the following settings:

  • use at least 2GB RAM
  • use a CentOS 7 based image

Please note that we recommend the official Centos 7 images (AWS, OpenStack). Images from other providers may be less functional or incompatible. For Amazon make sure you’ve accepted the Marketplace Terms and Conditions for the image before using it.

The following catalog items should enable you to quickly get started on some popular clouds. Download the .bom file of the relevant cloud, add your credentials, and then run:

br add-catalog <CLOUD-PROVIDER>-example-location.bom

From your AMP Install, head to the AMP Welcome page. In the quick deploy section select “Kubernetes cluster with a master node and worker nodes” and select the location that that we setup in the previous step Select the location that that we setup in the previous step. You can also change some configuration options such as the minimum and maximum number of nodes. Once you are happy with the configuration, press “Deploy” and your Kubernetes cluster will be created.

See the location example for IBM BlueBox and AWS for extra config that may be required.

From your AMP Install, head to the Home tab. Click on “Add application” and select “Kubernetes cluster with a master node and worker nodes”, then click on “Next”. Select the location that that we setup in the previous step. You can also change some configuration options such as the minimum and maximum number of nodes. Once you are happy with the configuration, press “Deploy” and your Kubernetes cluster will be created.

See the location example for IBM BlueBox and AWS for extra config that may be required.

To interact with the Kubernetes cluster, log in into the Kubernetes Dashboard (URL will be available as “main uri” sensor into the AMP console)

What’s next?

Jump into the documentation to learn more about kubernetes support in Clocker and have an in-depth overview.