Cluster Management Quick Start

This guide walks you through creating a Kubernetes cluster and setting up your first namespace.

---

Create a Cluster

1. From the Aegis dashboard, click the Container app.

2. In the left menu, select Cluster Management.

3. Click the Create Cluster button in the top-right corner.

4. Fill in the required fields:

   Field	Description
   Name	Unique cluster name
   Kubernetes Version	Select the version to install
   Tenant	Select the owning tenant
   External Network	Select the network for outbound traffic
   Tenant Network / Subnet	Select the network for node IP assignment
   Control Plane Flavor	Select the Control Plane node spec

5. Once all three sections in the Summary panel are checked, click Create.

6. Return to the cluster list. When the Status turns green (Active), the cluster is ready.

---

Create a Namespace

1. Click the cluster name to open its detail view.
2. Select Namespaces from the left menu.
3. Click Create Namespace.
4. Enter a name and click Create.

   Naming rules: lowercase letters, digits, and -. Max 63 characters. Must start and end with a letter or digit.

5. When the new namespace shows Running status in the list, it is ready to use.

---

Verify kubectl Access

1. On the cluster detail page, click Download KubeConfig in the top-right corner.

2. Run the following command in your local terminal:

   export KUBECONFIG=~/Downloads/<cluster-name>.yaml
   kubectl get namespaces

3. If the namespace you created appears in the output, your connection is working correctly.

---

Next steps

• Deploy Workloads →
• Detailed guides →