Eseguire la dismissione di un'organizzazione ibrida

Questo documento descrive i passaggi per ritirare un'organizzazione da un deployment ibrido. Il ritiro di un'organizzazione comporta l'eliminazione di tutti i dati correlati all'organizzazione in tutti i pod Cassandra in tutti i cluster Kubernetes.

Limitazioni

È possibile ritirare una sola organizzazione alla volta. Il ritiro simultaneo di più organizzazioni non è supportato.

Ottenere il nome dell'organizzazione

Alcuni comandi di queste istruzioni richiedono l'utilizzo di un nome dell'organizzazione formattato correttamente.

Per ottenere il nome dell'organizzazione da utilizzare nei comandi in questa pagina:

  1. Recupera il nome dell'organizzazione dal file overrides.yaml dell'organizzazione.
  2. Se il nome dell'organizzazione contiene trattini ("-"), sostituiscili con trattini bassi ("_").

Istruzioni

Segui queste istruzioni per ritirare un'organizzazione da un deployment ibrido.

  1. Esegui il backup dell'organizzazione
    1. Se non è già abilitata, abilita i backup nel deployment ibrido. Nelle configurazioni multiregionali, utilizza il deployment ibrido che opera nella regione principale. Consulta la panoramica del backup di Cassandra per informazioni sui backup ibridi.
    2. Attiva un job di backup ibrido utilizzando il seguente comando: 

      kubectl create job -n apigee --from=cronjob/apigee-cassandra-backup BACKUP_JOB_NAME

      BACKUP_JOB_NAME può essere qualsiasi nome di contenitore valido.

    3. Una volta completato il job di backup, utilizza le istruzioni "Controllare lo stato del job di backup" e "Controllare i log di backup" in Monitoraggio dei backup per verificare che il backup sia stato eseguito correttamente.

  2. (Facoltativo) Se hai configurato Apigee Telemetry (metriche e logger) nell'organizzazione da eliminare, segui questi passaggi per riconfigurarli in modo che i dati di metriche e log si applichino a una nuova organizzazione/progetto.
    1. Esegui questo comando per l'organizzazione a cui vuoi inviare i dati. Assicurati di utilizzare il file overrides.yaml per l'organizzazione. Ad esempio, se l'organizzazione da ritirare è "test-dev", il file overrides.yaml deve contenere un campo dell'organizzazione org: test-dev.

      Helm

      helm upgrade telemetry apigee-telemetry/ \
  --namespace apigee \
  --atomic \
  -f OVERRIDES_FILE.yaml

      apigeectl

      $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE.yaml --telemetry
    2. Esegui questo comando, assicurandoti di utilizzare l'organizzazione/il progetto corretti: 
      kubectl -n apigee get apigeetelemetry apigee-telemetry -oyaml | grep `gcpProjectID:`
  3. Elimina le risorse Kubernetes dell'organizzazione dal deployment ibrido.

    Helm

    1. Verifica che il contesto attuale sia quello corretto per il cluster Kubernetes di origine: 
      kubectl config current-context

      Se necessario, imposta il contesto Kubernetes.

      Elenca i contesti attuali per visualizzare il nome del contesto per ogni cluster: 

      kubectl config get-contexts

      Imposta il contesto sul cluster e sulla regione che vuoi ritirare: 

      kubectl config use-context CONTEXT_NAME

      dove CONTEXT_NAME è il nome del contesto per il cluster e la regione.

      Ad esempio: 

          kubectl config get-contexts
    CURRENT   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           apigee

    kubectl config use-context gke_example-org-1_us-west1_example-cluster-2
    2. Elimina l'host virtuale.

      Ripeti questa operazione per ogni gruppo di ambienti:

      helm -n apigee delete ENV_GROUP_NAME
    3. Elimina gli ambienti. Ripeti l'operazione per ogni ambiente: 
      helm -n apigee delete ENV_NAME
    4. Elimina l'organizzazione Apigee. 
      helm -n apigee delete ORG_NAME

    apigeectl

    Assicurati di utilizzare il file overrides.yaml per l'organizzazione. Ad esempio, se l'organizzazione da ritirare è "test-dev", il file overrides.yaml deve contenere un campo dell'organizzazione org: test-dev.

    Per i deployment ibridi multiregionali, esegui questi comandi su ogni deployment ibrido in ogni regione.

    kubectl config current-context # Verify the current context is the correct context for the hybrid deployment
apigeectl check-ready -f overrides.yaml # Check the deployment status
apigeectl delete --settings virtualhost -f overrides.yaml
apigeectl check-ready -f overrides.yaml # Check the deployment status
apigeectl delete --all-envs -f overrides.yaml
apigeectl check-ready -f overrides.yaml # Check the deployment status
apigeectl delete --org -f overrides.yaml
apigeectl check-ready -f overrides.yaml # Check the deployment status
  4. Elimina i dati dell'organizzazione dalla distribuzione ibrida. Una volta completato questo passaggio, tutti i dati dell'organizzazione non saranno più presenti nella distribuzione ibrida.
    1. Esegui l'accesso al pod apigee-cassandra-default-0: 
      kubectl exec -it -n apigee apigee-cassandra-default-0 -- /bin/bash
    2. Esegui questo comando. Copia l'elenco di tutti i nomi visualizzati nell'output. Avrai bisogno di questo elenco in un secondo momento. 
      find /opt/apigee/data/apigee-cassandra/ -iname '*ORG_NAME_hybrid' -type d -maxdepth 2 -printf "%f\n"

      Consulta Recupera il nome dell'organizzazione per istruzioni su come trovare e preparare il ORG_NAME.

      Esci dal pod apigee-cassandra-default-0.

    3. Crea un pod client di debug Cassandra come descritto in Crea un contenitore client per il debug. Passa al passaggio successivo dopo aver ricevuto un prompt cqlsh.
    4. Esegui questi comandi nel prompt cqlsh: 
      desc keyspaces;

      Assicurati che questo comando non restituisca errori.

      Per ogni nome nell'elenco creato in precedenza da apigee apigee-cassandra-default-0, esegui i seguenti comandi:

      drop keyspace ;

      Esci dal pod client di debug di Cassandra.

    5. Esegui un riavvio in sequenza di tutti i pod Cassandra. Il riavvio dei pod Cassandra può essere eseguito in qualsiasi ordine, purché venga riavviato un solo pod Cassandra alla volta. Per i deployment multiregionali, esegui un riavvio graduale di tutti i pod Cassandra in ogni regione ibrida.

      Esegui il comando seguente e verifica che lo stato sia "Running":

      kubectl get apigeeds -n apigee

      Riavvia un singolo pod Cassandra con il seguente comando:

      kubectl delete pod -n apigee CASSANDRA_POD_NAME

      Attendi che il pod raggiunga lo stato Running utilizzando:

      kubectl get pods -n apigee

      Riavvia il pod Cassandra successivo.

    6. Dopo aver eseguito i comandi cqlsh, esegui i seguenti comandi su tutti i pod Cassandra nel deployment ibrido. Per i deployment ibridi multiregionali, esegui i comandi su tutti i pod Cassandra in tutte le regioni ibride. 
      kubectl exec -it -n apigee CASSANDRA_POD_NAME -- /bin/bash
       
      find /opt/apigee/data/apigee-cassandra/ -iname '*ORG_NAME_hybrid' -type d -maxdepth 2

      Consulta Recupera il nome dell'organizzazione per istruzioni su come trovare e preparare il ORG_NAME.

      find /opt/apigee/data/apigee-cassandra/ -iname '*ORG_NAME_hybrid' -type d -maxdepth 2 -exec rm -rf {} +

    7. Esci dal pod Cassandra.