Skip to main content
After you install a data plane cluster, you must register it with the Astro Private Cloud control plane so that the APC 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 the deployment orchestrator.
  • 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 deployment orchestrator, fetches the data plane’s metadata from its /metadata endpoint, and checks the metadata before it creates the cluster. If a metadata field is missing or invalid, registration fails and names the field. See Troubleshoot data plane registration.
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. After registration, the data plane keeps the control plane’s copy of its metadata current over DP-Link. The registration override can’t set the values that the data plane supplies, such as chart.version. See Data plane metadata sync.