Platform AdministrationManage data plane clusters

Register a data plane cluster

After you install a data plane cluster, you must register it with the Astro Private Cloud control plane so that the Houston API can schedule Airflow Deployments.

Only a system admin can register a data plane cluster.

Prerequisites

  • The data plane Kubernetes cluster is up and reachable from the control plane network.
  • Astronomer data plane components are installed and healthy on the data plane, including Commander.
  • You know the base domain for the data plane ingress. For example, finance-dataplane-us-east-1.example.company.com.

Required fields

  • Name: A unique identifier for the data plane cluster across the control plane. Names must be unique; pick a stable, human‑readable value. For example, finance-dataplane-us-east-1.
  • Base domain: The base DNS domain served by the data plane ingress, in the format https://<domainPrefix>.<base_domain>. For example, finance-dataplane-us-east-1.example.company.com. This domain resolves to the data plane’s ingress endpoints.
  • Cluster override: (Optional) Provide initial overrides to customize the cluster’s Deployment configuration. See Cluster override.

Register in the UI

Shows the process of registering a cluster through the UI

1

Open Clusters page

In the APC UI, open the Clusters page.

2

Add a new cluster

Click + Cluster to start registering your cluster.

3

Enter cluster details

Enter a unique Name, the data plane Base domain in the https://<domainPrefix>.<base_domain> format, and optionally set Cluster override.

4

Register the cluster

Click Register Cluster to save your cluster information. The control plane validates connectivity to the data plane Commander.

5

Verify

Check the list of clusters on the Clusters page. If you successfully registered your cluster, it appears in the list with a Healthy status.

Now you can proceed to create Airflow Deployments in this data plane.