Retira una organización híbrida

En este documento, se describen los pasos para retirar una organización de una implementación híbrida. Retirar una organización implica borrar todos los datos relacionados con esta en todos los Pods de Cassandra de todos los clústeres de Kubernetes.

Limitaciones

Solo se puede retirar una organización a la vez. No se admite el retiro de servicio múltiple de organizaciones de forma simultánea.

Obtén el nombre de la organización

Algunos comandos de estas instrucciones requieren que uses un nombre de organización adecuado.

Para obtener el nombre de la organización y usarlo en los comandos de esta página, haz lo siguiente:

Recupera el nombre de la organización del archivo overrides.yaml de la organización.
Si el nombre de la organización contiene guiones ("-"), reemplázalos por guiones bajos ("_").

Instrucciones

Sigue estas instrucciones para retirar una organización de una implementación híbrida.

Crea una copia de seguridad de la organización:
1. Si aún no está habilitada, habilita las copias de seguridad en la implementación híbrida. En las configuraciones multirregionales, usa la implementación híbrida que opera en la región principal. Consulta Descripción general de la copia de seguridad de Cassandra para obtener información sobre las copias de seguridad híbridas.
2. Activa un trabajo de copia de seguridad híbrida con el siguiente comando:
```
kubectl create job -n APIGEE_NAMESPACE --from=cronjob/apigee-cassandra-backup BACKUP_JOB_NAME
```
  BACKUP_JOB_NAME puede ser cualquier nombre de contenedor válido.
3. Una vez que se complete el trabajo de copia de seguridad, usa las instrucciones “Verifica el estado del trabajo de copia de seguridad” y “Verifica los registros de la copia de seguridad” en Supervisa las copias de seguridad para verificar que la copia de seguridad se haya realizado correctamente.
(Opcional) Si configuraste la telemetría de Apigee (métricas y registro) en la organización que se borrará, sigue estos pasos para volver a configurarla a fin de que las métricas y los datos de registro se apliquen a una organización o proyecto nuevo.

Ejecuta este comando para la organización a la que deseas enviar los datos. Asegúrate de usar el archivo overrides.yaml para la organización. Por ejemplo, si la organización que se retirará de servicio es "test-dev", el archivo overrides.yaml debe contener un campo de organización org: test-dev.
```
helm upgrade telemetry apigee-telemetry/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE.yaml
```
Nota: Si ves un error que dice Error: UPGRADE FAILED: "ORG_NAME" has no deployed releases, reemplaza upgrade por install y vuelve a intentar aplicar el comando.

Ejecuta este comando y asegúrate de usar la organización o el proyecto correcto:

kubectl -n APIGEE_NAMESPACE get apigeetelemetry apigee-telemetry -oyaml | grep `gcpProjectID:`

Borra los recursos de Kubernetes de la organización de la implementación híbrida.

Verifica que el contexto actual sea el contexto correcto para el clúster de Kubernetes de origen:

kubectl config current-context

Si es necesario, configura el contexto de Kubernetes.

Enumera tus contextos actuales para ver el nombre de contexto de cada clúster:

kubectl config get-contexts

Configura el contexto en el clúster y la región que deseas retirar:

kubectl config use-context CONTEXT_NAME

En el ejemplo anterior, CONTEXT_NAME es el nombre del contexto del clúster y la región.

Por ejemplo:

    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

Borra el host virtual.
Repite esto para cada grupo de entorno:
```
helm -n APIGEE_NAMESPACE delete ENV_GROUP_NAME
```
Borra los entornos. Repite esto para cada entorno:
```
helm -n APIGEE_NAMESPACE delete ENV_NAME
```

Borra la organización de Apigee.

helm -n APIGEE_NAMESPACE delete ORG_NAME

Borra los datos de la organización de la implementación híbrida. Una vez que se complete este paso, todos los datos de la organización desaparecerán de la implementación híbrida.
1. Ejecuta el pod apigee-cassandra-default-0:
```
kubectl exec -it -n APIGEE_NAMESPACE apigee-cassandra-default-0 -- /bin/bash
```
2. Ejecuta el siguiente comando. Copia la lista de todos los nombres que se muestran en el resultado. Esta lista será necesaria más adelante.
```
find /opt/apigee/data/apigee-cassandra/ -iname '*ORG_NAME_hybrid' -type d -maxdepth 2 -printf "%f\n"
```
  Consulta Obtén el nombre de la organización para obtener instrucciones sobre cómo encontrar y preparar el ORG_NAME.
  
  Sal del pod apigee-cassandra-default-0.
3. Crea un pod de cliente de depuración de Cassandra como se describe en Crea un contenedor de cliente para la depuración. Continúa con el siguiente paso después de recibir un mensaje cqlsh.
4. Ejecuta los siguientes comandos en el mensaje de cqlsh:
```
desc keyspaces;
```
  Asegúrate de que este comando no muestre errores.
  
  Para cada nombre de la lista creada antes desde apigee apigee-cassandra-default-0, ejecuta los siguientes comandos:
```
drop keyspace KEYSPACE_NAME;
```
  Sal del pod de cliente de depuración de Cassandra.
5. Realiza un reinicio progresivo de todos los pods de Cassandra. El reinicio de los pods de Cassandra se puede realizar en cualquier orden, siempre y cuando solo se reinicie un pod de Cassandra a la vez. Para implementaciones multirregionales, realiza un reinicio progresivo en todos los pods de Cassandra en cada región híbrida.
  Ejecuta el siguiente comando y verifica que el estado muestre “Running”:
```
kubectl get apigeeds -n APIGEE_NAMESPACE
```
  Reinicia un solo Pod de Cassandra con el siguiente comando:
```
kubectl delete pod -n APIGEE_NAMESPACE CASSANDRA_POD_NAME
```
  Espera a que el Pod alcance el estado Running mediante el siguiente comando:
```
kubectl get pods -n APIGEE_NAMESPACE
```
  Reinicia el siguiente Pod de Cassandra.
6. Después de ejecutar los comandos de cqlsh, ejecuta los siguientes comandos en todos los pods de Cassandra en la implementación híbrida. Para implementaciones híbridas multirregionales, ejecuta los comandos en todos los pods de Cassandra en todas las regiones híbridas.
```
kubectl exec -it -n APIGEE_NAMESPACE CASSANDRA_POD_NAME -- /bin/bash
```
```
find /opt/apigee/data/apigee-cassandra/ -iname '*ORG_NAME_hybrid' -type d -maxdepth 2
```
  Consulta Obtén el nombre de la organización para obtener instrucciones sobre cómo encontrar y preparar el ORG_NAME.
```
find /opt/apigee/data/apigee-cassandra/ -iname '*ORG_NAME_hybrid' -type d -maxdepth 2 -exec rm -rf {} +
```
7. Sal del pod de Cassandra.