Cluster lifecycle¶
Create a cluster, watch it become ready, change its description and tags, and delete it. Node pools, access, exposure, and Elastic IPs have their own pages.
Who can do this: a member can open the list and the cluster. A super_admin can create, edit, and delete.
The screenshots are the demo organization. Examples use organization acme and cluster payments-prod.
Creating a cluster¶
+ New Cluster is a three-step wizard: general information, node pools, then review. The name and application reachability (Where can your applications be reached?) cannot be changed after create. The wizard has no control-plane option. A name already in use, an unknown version or machine type, or missing prepaid credit is shown on the form. Contact your Door account team for credit.
Step-by-step with screenshots: Getting started. The five setup steps and what each phase allows: What DKS is.
Creating a cluster with Maya¶
With the organization selected, open Maya and ask, for example:
Create a cluster named payments-prod in Abidjan, Kubernetes 1.32.4, one pool workers on c5.xlarge with two nodes.
Approve the confirmation card. The confirmation card and progress messages look like the ones on the Maya page. The progress card follows the same five steps until the cluster is ready or failed. Read-only questions ("list my clusters", "what phase is payments-prod?") do not show that card.
Following progress in the console¶
While the cluster is still being created, the console keeps you on the provisioning screen. When it is Ready, open the cluster. Overview shows version, zone, network (VPN / Direct Connect for a private application network, otherwise Internet), capacity, and age.
Overview for cp-canary-in in the demo organization. The badge Ready means the cluster is provisioned; Network: VPN / Direct Connect means its applications are on a private network.
You can download access from Control plane ready onward. Adding pools, Elastic IPs, and firewall rules waits until the status is Ready.
Updating a cluster in the console¶
Open the cluster, then Settings. The name is read-only. Edit the description and tags, then save. Tags replace the whole list.
Updating a cluster with Maya¶
Set tags on payments-prod to prod, payments.
Maya applies the change and confirms it in the chat. Maya can change tags and the description. It cannot rename the cluster or change application reachability after create.
Deleting a cluster in the console¶
On Settings, open Danger zone and click Delete. The dialog says the control plane and all workers are destroyed and cannot be undone. Confirm.
If Door hub environments are still attached, the dialog offers a forced delete. Use it only when you intend to remove those environments with the cluster.
The cluster leaves the default list while it is deleting. When it is gone, the name can be used again.
Deleting a cluster with Maya¶
Delete cluster payments-prod.
Approve the confirmation card. The confirmation card and progress messages look like the ones on the Maya page. The progress card follows the delete. A member is refused.
When creation fails¶
The provisioning screen and Overview show the failure message. Delete the cluster from Settings and create it again, or contact your Door account team with the cluster id. The name is free again after the cluster is gone.
Next
Field names, status codes, and request bodies are in the API reference.