Utilizzare la modalità di manutenzione su un cluster di database in Kubernetes

Se il tuo database viene eseguito in un cluster Kubernetes, puoi metterlo in modalità di manutenzione disattivando i probe di attività e i probe di avvio, che vengono eseguiti sull'applicazione containerizzata, per assicurarti che il pod del database sia in uno stato integro. La modalità di manutenzione ti consente di impostare un pod in stato di esecuzione quando devi eseguire un aggiornamento di manutenzione o riparare il pod.

Attiva la modalità di manutenzione

1. Verifica che i probe esistano in un pod del database:

   1. Probe di attività:

      kubectl get po -n NAMESPACE DATABASE_POD_NAME  -o jsonpath='{.spec.containers[?(@.name=="database")].livenessProbe}'

      Sostituisci quanto segue:

      • NAMESPACE: il nome di uno spazio dei nomi utilizzato per eseguire il database, ad esempio db.
      • DATABASE_POD_NAME: il nome del pod del database, ad esempio al-4017-dbcluster-sample-0.

      Di seguito è riportato un output di esempio con un probe di attività:

      {"failureThreshold":3,"httpGet":{"path":"/healthz?","port":8090,"scheme":"HTTP"},"periodSeconds":10,"successThreshold":1,"timeoutSeconds":3}
      

   2. Probe di avvio:

      kubectl get po -n NAMESPACE DATABASE_POD_NAME -o jsonpath='{.spec.containers[?(@.name=="database")].startupProbe}'

      Di seguito è riportato un output di esempio con un probe di avvio:

      {"exec":{"command":["/usr/lib/postgresql/15/bin/psql","-hlocalhost","-Ualloydbadmin","-c","SELECT 1"]},"failureThreshold":180,"periodSeconds":10,"successThreshold":1,"timeoutSeconds":1}
      

2. Imposta mode su maintenance nella sezione spec del manifest di DBCluster:

   apiVersion: alloydbomni.dbadmin.goog/v1
   kind: DBCluster
   metadata:
     name: DB_CLUSTER_NAME
     namespace: NAMESPACE
   spec:
     allowExternalIncomingTraffic: false
     isDeleted: false
     mode: maintenance
     primarySpec:
     ...
   

   Sostituisci DB_CLUSTER_NAME con il nome di questo cluster di database, ad esempio my-db-cluster.

3. Applica il manifest:

   kubectl apply -f DB_CLUSTER_YAML

   Sostituisci DB_CLUSTER_YAML con il nome del file manifest di questo cluster di database, ad esempio alloydb-omni-db-cluster.yaml.

4. Per verificare che la modalità di manutenzione sia abilitata, esegui i seguenti comandi:

   • Probe di attività:

     kubectl get po -n NAMESPACE DATABASE_POD_NAME  -o jsonpath='{.spec.containers[?(@.name=="database")].livenessProbe}'

   • Probe di avvio:

     kubectl get po -n NAMESPACE DATABASE_POD_NAME  -o jsonpath='{.spec.containers[?(@.name=="database")].startupProbe}'

   L'output non contiene i campi Liveness e Startup nella sezione spec del pod POD_NAME.

Disattiva la modalità di manutenzione

Per ripristinare il comportamento standard del cluster di database con i probe di attività e di avvio in esecuzione, utilizza il seguente comando per rimuovere maintenance dalla sezione spec del manifest di DBCluster:

kubectl patch dbclusters.alloydbomni.dbadmin.goog DB_CLUSTER_NAME -p '{"spec":{"mode":""}}' --type=merge -n DB_CLUSTER_NAMESPACE --type=merge

Esempi di output:

• Con un probe di attività:

  {"failureThreshold":3,"httpGet":{"path":"/healthz?","port":8090,"scheme":"HTTP"},"periodSeconds":10,"successThreshold":1,"timeoutSeconds":3}
  

• Con un probe di avvio:

  {"exec":{"command":["/usr/lib/postgresql/15/bin/psql","-hlocalhost","-Ualloydbadmin","-c","SELECT 1"]},"failureThreshold":180,  "periodSeconds":10,"successThreshold":1,"timeoutSeconds":1}