Getting started with Kubernetes.md

Getting started with Kubernetes in Flexiant Concerto

Flexiant Concerto's integration with Kubernetes allows you to deploy and maintain Kubernetes clusters using the Flexiant Concerto UI and CLI interface.

This guide concerns how to use the Flexiant Concerto UI to create a Kubernetes cluster; for information about how to use the CLI to accomplish this, see the CLI documentation.

Table of Contents

• Setup
  • Pre-requisites
  • Creating a Kubernetes cluster
  • Adding nodes to a cluster
  • Uploading config files
• Contact
• Contribute

Setup

Pre-requisites

Before setting up Kubernetes, we will need a Flexiant Concerto account.

You can create a free account in less than a minute following the steps in Flexiant Concerto login page.

Once your account have been provisioned, add a cloud provider. After doing this, ensure that beta features are activated and listed as one of the top menu tabs options. If that is not the case, enable beta features by doing the following:

1. Navigate the menus to Settings > User Details.

2. Select the Enable beta features check box.

   

3. Click the Change button.

4. Refresh the page. After the page reloads, the Beta tab is displayed to the right of the Settings tab.

Creating a Kubernetes cluster

To create a Kubernetes cluster:

1. Click on the Beta tab.

2. Click on the Kubernetes sub-tab.

3. Click the Create Cluster button.

   

4. Enter the following information:

   • Name - the name to give the cluster. This must be given in lower case characters without spaces, as it will form part of the cluster's hostname.
   • Domain - if you have more than one domain, select which one you want to create the cluster in. This is appended to the Name value to form the cluster's hostname.
   • SSH profile - if you have more than one SSH profile, select which one you want to use.

5. Click the Add Cluster button.

Adding nodes to a cluster

Once your cluster is created, you should add nodes to it. Nodes are used to run pods, which in turn contain containers that run applications or services.

To add nodes to a cluster:

1. Click on the Beta tab.
2. Click on the Kubernetes sub-tab.
3. Click on the name of the cluster you want to add nodes to.
4. Add a master node by doing the following:
   1. Click the + button in the Master section.
   2. Select the server plan you wan to use for the master node.
   3. Click the Create Master button.
5. Once your master node is operational, create nodes by doing the following:
   1. Click the + button in the Nodes section.
   2. Select the server plan you want to use for the node.
   3. Click the Add Node button.
   4. Repeat these steps until you have the required number of nodes in your cluster.

Uploading config files

Kubernetes allows the configuration of pods and replication controllers to be defined in a .json or .yaml file. Once your Kubernetes cluster is operational, these files can be uploaded to your cluster using the Flexiant Concerto UI.

To upload configuration files:

1. Click on the Beta tab.

2. Click on the Kubernetes sub-tab.

3. Click on the name of the cluster you want to upload configuration files to.

4. Click on the Kubectl menu at the top of the page.

   

5. Click the + button on the right hand side of the page.

   

6. Click the Upload Kube file button.

7. Select the file to upload and click the Open button.

Contact

We have included most common use cases here. If you feel a use case is missing, open an issue or contact us at contact@flexiant.com.

Contribute

To contribute:

• Find an open issue, or report a new one. Include proper information about the environment, at least: operating system, CLI version, steps to reproduce the issue and related issues. Avoid writing multi-issue reports, and make sure that the issue is unique.
• Fork the repository to your account
• Commit scoped chunks, adding concise and clear comments
• Remember to add tests to your contributed code
• Push changes to the forked repository
• Submit the PR to Concerto CLI
• Let the maintainers give you the LGTM.

Please, use gofmt, golint, go vet, and follow go style advices