Adding a New Region to an Existing Deployment

You can add a new region to an already deployed setup using the airctl. This allows you to expand your environment without redeploying the entire system.

Steps to Add a New Region

1. Update the Configuration File:

Edit the airctl-config.yaml file and append the new region name under the duRegion field. Example:

Bash

# cat /opt/pf9/airctl/conf/airctl-config.yaml | grep -i region
duRegion: Infra RegionOne NewRegion

1. Run the add-Region Command:

Bash

airctl add-region --config /opt/pf9/airctl/conf/airctl-config.yaml

1. Verify the Region Addition:

Once the command completes, verify that the new region has been successfully added. You should now see the newly added region reflected in both the state file and the airctl status output.

Bash

airctl status --config /opt/pf9/airctl/conf/airctl-config.yaml

Here is the sample output.

Bash

------------- deployment details ---------------
fqdn:                airctl-1-4108764-426.platform9.localnet
region:              airctl-1-4108764-426
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-2561
-------- region service status ----------
desired services:     30
ready services:       30


------------- deployment details ---------------
fqdn:                airctl-1-4108764-426-regionone.platform9.localnet
region:              airctl-1-4108764-426-regionone
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-2561
-------- region service status ----------
desired services:     77
ready services:       77

------------- deployment details ---------------
fqdn:                airctl-1-4108764-426-newregion.platform9.localnet
region:              airctl-1-4108764-426-newregion
deployment status:   ready
region health:       ✅ Ready
version:              PCD 2025.10-2561
-------- region service status ----------
desired services:     77
ready services:       77

Bash

# cat .airctl/state.yaml
...
regions:
    - name: Infra
      fqdn: airctl-1-4108764-426.platform9.localnet
      dbHostname: percona-db-pxc-db-haproxy.foo.svc.cluster.local
      dbPassword: *********
    - name: RegionOne
      fqdn: airctl-1-4108764-426-regionone.platform9.localnet
      dbHostname: percona-db-pxc-db-haproxy.foo-regionone.svc.cluster.local
      dbPassword: *********
    - name: NewRegion
      fqdn: airctl-1-4108764-426-newregion.platform9.localnet
      dbHostname: percona-db-pxc-db-haproxy.foo-regionone.svc.cluster.local
      dbPassword: *********

This process ensures a seamless addition of new regions to your deployment while maintaining consistency across configuration and runtime state.