Creating Kubernetes Cluster on Platform9 Managed OpenStack
Platform9 Managed Kubernetes supports creation of Kubernetes clusters on Platform9 Managed OpenStack through the Platform9 Clarity UI.
Before you can create a Kubernetes cluster atop an OpenStack cloud, ensure that the following OpenStack resources that are to be used by the Kubernetes cluster are present on Platform9 Managed OpenStack.
- Flavors to be used for master nodes and worker nodes
- Provider networks (KVM only)
- Security groups
Additionally, the following must have been created with Platform9 Managed Kubernetes, before creating the cluster.
- Cloud provider details related to the OpenStack cloud
Follow the steps given below to create a Kubernetes cluster on an OpenStack cloud, with Platform9 Clarity UI.
- Click Kubernetes>Infrastructure>Clusters>Add Cluster.
- Select the Cloud Provider.
- Enter the name for the cluster in Name.
- Select the Region for the cluster.
- Select KVM as Region Type.
- Click Next.
- Enter image name in Image.
- Select Master Node Instance Flavor.
- Select Worker Node Instance Flavor.
- Select Number of Master Nodes.
Note: Currently, multi-master clusters are not supported. Hence, a single master Kubernetes cluster is created even if you specify the number of master nodes as more than one.
- Enter Number of Worker Nodes.
- Select the Disable Workloads on Master Nodes check box, if you wish to disable deployment of workloads on master nodes. This is a recommended step to maintain the stability of the cluster.
- Click Next.
- Enter the network information, based on the table given below.
Field Description Network Select the network to deploy the cluster on. Security Group The security group or groups for the cluster. Enter a comma-separated list of security groups if you are using more than one group. Containers CIDR The IP range that Kubernetes uses to configure the Pods (Docker containers) deployed by Kubernetes Services CIDR The IP range that Kubernetes uses to configure services deployed by Kubernetes HTTP Proxy Select the check box if you want to use an HTTP proxy server for the cluster. If you select this check box, you must specify the IP address and port number of the HTTP proxy server in the text area that appears below the HTTP proxy check box, in the <scheme>://<username>:<password>@<host>:<port> format. The <username>: <password>@ is optional in the HTTP proxy string.
- Click Next.
Enter the advanced configuration details, based on the table given below.
Warning: You must have an in-depth knowledge of the Kubernetes API to be able to correctly use the Advanced API configuration option. If the advanced APIs are inappropriately configured, it could lead to the cluster working incorrectly or the cluster being inaccessible.
Field Description SSH Key Select an SSH key to be associated with the nodes. The SSH key can be used to access the nodes for debugging purpose. Privileged Select the check box to enable the cluster to run privileged containers. Advanced API Configuration Select the check box to configure the APIs to be used by the cluster. If you do not have adequate knowledge of Kubernetes APIs, it is recommended to avoid selecting this check box. When this check box is not selected, the GA and beta APIs (that is the stable APIs) for the currently installed Kubernetes version are enabled. Default API groups and versions This option is visible only if you select the Advanced API Configuration check box. Select the Default API groups and versions option to enable on the cluster, the default APIs based on the Kubernetes installation in your environment. All API groups and versions This option is visible only if you select the Advanced API Configuration check box. Select All API groups and versions option to enable on the cluster, all alpha, beta, and GA versions of Kubernetes APIs that have been published till date. Custom API groups and versions This option is visible only if you select the Advanced API Configuration check box. Select Custom API groups and versions option to specify one or more API versions that you wish to enable and/or disable. Enter the API versions in the text area following the Custom API groups and versions option. For example, to enable Kubernetes v1 APIs, enter the expression,
api/v1=true. Similarly, to disable Kubernetes v2 APIs, enter the expression,
api/v2=false. If you want to enable and/or disable multiple versions, you could enter comma-separated expressions, such as,
- Select the Enable Application Catalog check box, if you want to deploy applications using the Kubernetes package manager, Helm, on the cluster. This is an optional step.
- Click Next.
- Review the cluster configuration, and then click Create Cluster.
The cluster is created on the specified OpenStack cloud.
You can deploy your applications on the Kubernetes cluster.
July 30, 2018