Decommission a hybrid region

You are currently viewing version 1.10 of the Apigee hybrid documentation.This version is end of life. You should upgrade to a newer version. For more information, seeSupported versions.

This guide explains the procedure to decommission a region in a multi region environment.

Please ensure there is no live traffic going to the region you plan to delete.

Decommission a hybrid region

  1. Set the kubernetes contexts to the region that needs to be decommissioned.

    List your current contexts to see the context name for each cluster:

    kubectl config get-contexts

    Set the context to the cluster and region you want to decommission:

    kubectl config use-contextCONTEXT_NAME

    WhereCONTEXT_NAME is the context name for the cluster and region.

    For example:

    kubectl config get-contextsCURRENT   NAME                                                   CLUSTER                                                AUTHINFO                                               NAMESPACE          gke_example-org-1_us-central1_example-cluster-1        gke_example-org-1_us-central1_example-cluster-1        gke_example-org-1_us-central1_example-cluster-1        apigee*         gke_example-org-1_us-central1_example-cluster-2        gke_example-org-1_us-central1_example-cluster-2        gke_example-org-1_us-central1_example-cluster-2        apigee          gke_example-org-1_us-west1_example-cluster-2           gke_example-org-1_us-west1_example-cluster-2           gke_example-org-1_us-west1_example-cluster-2           apigeekubectl config use-context gke_example-org-1_us-west1_example-cluster-2
  2. Delete the Apigee instance in the context you just selected with theapigeectl command:
    Apigeectl delete --all -f overrides.yaml
  3. Verify there are no pods remaining in the Apigee namespaces:
    kubectl get pods -n apigeekubectl get pods -n apigee-systemkubectl get pods -n cert-manager
  4. Set the context to other existing regions and make sure the cassandra datacenter is removed from the existing ring. The output should not show the removed data center details.
    kubectl exec apigee-cassandra-default-0 -n apigee  -- nodetool -uJMX_USER -pwJMX_PASSWORD status
    5. Note: If the entries of the deleted datacenter are still present in the Cassandranodetool output, see Stale references to deleted secondary region pods in Cassandra cluster.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.