Hello-World AWS Cluster
Creating your first Kubox cluster
Overview
This walkthrough offers a hands-on guide to creating your first Kubox cluster. During the process, it will provision AWS cloud resources, including a Virtual Private Network (VPC), Subnets, Routing Tables, Load Balancer, Virtual Machines (using Spot Instances by default), and more. Successfully completing this guide will verify your permissions, and the final step will clean up all resources, ensuring no residual costs.
Steps
Verify AWS CLI is configured and authenticated
If you are new to AWS cloud and need to configure the AWS CLI see Set up an AWS account and create a User
Verify the current context and identity
Create a cluster configuration file
The cluster configuration file defines the metadata and the type of virtual machines and their role in the Kubernetes cluster.
The role can be one of the three control-plane
, worker
and gpu
.
Region: Please change the aws region in the cluster.yaml
as required.
Initialise a cluster folder
The command will create a folder with core helm charts and Kubernetes manifests that will be installed.
After the command has you completed you can inspect the folder ./cluster
in the current directory.
Create the cluster
This command will create the AWS resources including Virtual Machines and bootstrap etcd and Kubernetes.
Flux will be installed with default toolkit components. However, Flux is not bootstrapped and a sync with Git is not established.
If you have get errors during creation see troubleshooting guide.
Verify cluster
A kubeconfig file will be generated as part of the cluster creation process.
Connect to the kubernetes cluster using kubectl
Delete cluster