The Generic provider for Managed Kubernetes allows Linux-based servers to be converted into worker nodes of a Kubernetes cluster, irrespective of their deployment in public clouds (such as AWS, Azure, GCP, Hetzner, etc.) or in private cloud / on-premises environments. Once integrated, these servers join a Kubernetes cluster as worker nodes, enabling the deployment of Kubernetes workloads through the Kubernetes API.
server requirements
:
generic-mk8s-template.yaml
YAML manifest if needed.This example creates a Generic cluster with the following configurations:
gcp-us-east1
location. Placing worker nodes close to the control plane is recommended for optimal performance.Default
rule, allowing public access to the Kubernetes API. It is advisable to restrict API access to a known IP range for security purposes.general
node pool.Create the Cluster: Deploy the generic-mk8s-example
cluster by applying the manifest.
cpln apply -f generic-mk8s-template.yaml --org YOUR_ORG_HERE
.generic-mk8s-template.yaml
file using the cpln apply >_
option in the upper right corner.Wait until the cluster is initialized.
Obtain the Join Script:
Using the CLI:
a. Save the Join Script to a file: Execute the command cpln mk8s join generic-mk8s-example --type join-script --options nodePoolName=general > join_general.sh
Using the UI:
a. Navigate to the Control Plane Console: Visit the Control Plane Console.
b. Access the Dashboard: In the Control Plane Console, navigate to Kubernetes
in the left sidebar panel, click on the generic-mk8s-example
cluster, and go to Node Pools
. Click on More
on the right side of the general
Node Pool and select Generate Join Script
.
Copy and Execute the Script on the Server: Connect to the remote server and execute the Join Script. After the execution, the server should be joined to the cluster as a node under the general
node pool. Repeat these steps for all necessary servers.
cpln mk8s kubeconfig generic-mk8s-example -f /tmp/generic-mk8s-example-conf
.kubectl
: Use the obtained kubeconfig file by running export KUBECONFIG=/tmp/generic-mk8s-example-conf
for the current shell session.Kubernetes
in the left sidebar panel and click on Open
under Dashboard
for the cluster generic-mk8s-example
.The Generic provider for Managed Kubernetes allows Linux-based servers to be converted into worker nodes of a Kubernetes cluster, irrespective of their deployment in public clouds (such as AWS, Azure, GCP, Hetzner, etc.) or in private cloud / on-premises environments. Once integrated, these servers join a Kubernetes cluster as worker nodes, enabling the deployment of Kubernetes workloads through the Kubernetes API.
server requirements
:
generic-mk8s-template.yaml
YAML manifest if needed.This example creates a Generic cluster with the following configurations:
gcp-us-east1
location. Placing worker nodes close to the control plane is recommended for optimal performance.Default
rule, allowing public access to the Kubernetes API. It is advisable to restrict API access to a known IP range for security purposes.general
node pool.Create the Cluster: Deploy the generic-mk8s-example
cluster by applying the manifest.
cpln apply -f generic-mk8s-template.yaml --org YOUR_ORG_HERE
.generic-mk8s-template.yaml
file using the cpln apply >_
option in the upper right corner.Wait until the cluster is initialized.
Obtain the Join Script:
Using the CLI:
a. Save the Join Script to a file: Execute the command cpln mk8s join generic-mk8s-example --type join-script --options nodePoolName=general > join_general.sh
Using the UI:
a. Navigate to the Control Plane Console: Visit the Control Plane Console.
b. Access the Dashboard: In the Control Plane Console, navigate to Kubernetes
in the left sidebar panel, click on the generic-mk8s-example
cluster, and go to Node Pools
. Click on More
on the right side of the general
Node Pool and select Generate Join Script
.
Copy and Execute the Script on the Server: Connect to the remote server and execute the Join Script. After the execution, the server should be joined to the cluster as a node under the general
node pool. Repeat these steps for all necessary servers.
cpln mk8s kubeconfig generic-mk8s-example -f /tmp/generic-mk8s-example-conf
.kubectl
: Use the obtained kubeconfig file by running export KUBECONFIG=/tmp/generic-mk8s-example-conf
for the current shell session.Kubernetes
in the left sidebar panel and click on Open
under Dashboard
for the cluster generic-mk8s-example
.