Create Single Node BareOS Cluster

This article describes the creation of a single node on-premises Kubernetes cluster using PMK.

We recommend reading What is BareOS for an understanding of BareOS and BareOS Cluster Architecture before proceeding with this document.

The PMK one-click cluster creation wizard allows you to create a single node PMK cluster very quickly. The single cluster node becomes both the master and worker node for the cluster, and has etcd deployed on that node.

Pre-requisites

• You will need a virtual machine or a physical server with a supported version of Linux operating system installed.
• Follow the Operating System Requirements and Hardware Requirements for the node you want to create the cluster with.

Create BareOS Single Node Cluster Using UI

To create a single node PMK cluster:

• Navigate to the PMK UI Infrastructure -> Clusters - > Create Cluster and choose 'create cluster' to launch the cluster creation wizard.
• Select BareOS Virtual Machine or BareOS Physical Servers option depending on where you are creating your BareOS cluster.
• Click on the 'One-click Cluster' button in the wizard
• Give the cluster a memorable name like 'my-cluster'
• Choose your Kubernetes version (if you are unsure which version to pick then always choose the latest)
• The 'Select a node' section of the wizard will initially be empty. This is because you need to download and install the Platform9 CLI on your node so it can connect to the PMK management plane and show up in your wizard.
• To achieve this, download and install the PMK CLI on your node by running the following command on the node.

bash <(curl -sL https://pmkft-assets.s3-us-west-1.amazonaws.com/pf9ctl_setup)

• The command will install the CLI
• Now run the config set command to configure the CLI to connect to and use your PMK deployment.

pf9ctl config set

Platform9 Account URL: <Your PMK Account URL>

Username: <Your PMK User name>

Password: <Your PMK password>

Region [RegionOne]: <leave blank for default>

Tenant [service]: <leave blank for default>

• Now run the CLI prep-node command to prepare the node with required pre-requisites.

pf9ctl prep-node

• The prep-node command will perform prerequisite checks for your node. If any checks fail, you will receive an output similar to the following.

✓ Loaded Config Successfully

✓ Missing package(s) installed successfully

✓ Removal of existing CLI

✓ Existing Platform9 Packages Check

✓ Required OS Packages Check

✓ SudoCheck

✓ CPUCheck

x DiskCheck - At least 30 GB of total disk space and 15 GB of free space is needed on host. Disk Space found: 2 GB

x MemoryCheck - At least 12 GB of memory is needed on host. Total memory found: 4 GB

✓ PortCheck

✓ Existing Kubernetes Cluster Check

​

✓ Completed Pre-Requisite Checks successfully

​

Optional pre-requisite check(s) failed. Do you want to continue? (y/n)

Failed to prepare node. See /root/pf9/log/pf9ctl-20210330.log or use --verbose for logs

• If the prep-node command succeeds, you are now ready to create your single node cluster using PMK UI.
• Navigate back to the PMK UI one click cluster creation wizard. Your node should now show up in the wizard.
• Give you cluster a name. And select Kubernetes version for your cluster. If you are unclear about this, we recommend selecting the highest listed numeric version.
• ClickComplete to finalize and deploy the cluster!
• You PMK Cluster is now deployed.
• Following is a description of the input properties, their default values set as part of the one-click cluster creation wizard, and their meaning, for your information only.

Create Single Node BareOS Cluster Using REST API

You can also create a single node BareOS Kubernetes cluster using the PMK (Qbert) REST API.