Use o modo de manutenção num cluster de base de dados no Kubernetes

Selecione uma versão da documentação:

Esta página mostra como colocar a base de dados em modo de manutenção num cluster do Kubernetes.

Se a sua base de dados for executada num cluster do Kubernetes, pode colocar a base de dados em modo de manutenção desativando as sondas de atividade e as sondas de arranque, que são executadas na sua aplicação em contentor, para garantir que o pod da base de dados está em bom estado. O modo de manutenção ajuda a colocar um pod num estado de execução quando precisa de fazer uma atualização de manutenção ou reparar o pod.

Ative o modo de manutenção

  1. Verifique se existem sondas num pod de base de dados:

    1. Sonda de atividade:

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

      Substitua o seguinte:

      • NAMESPACE: o nome de um espaço de nomes usado para executar a sua base de dados, por exemplo, db.
      • DATABASE_POD_NAME: o nome do pod da base de dados, por exemplo, al-4017-dbcluster-sample-0.

      Segue-se um exemplo de saída com uma sondagem de atividade:

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

    2. Sonda de arranque:

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

      O exemplo seguinte mostra a saída de exemplo com uma sondagem de arranque:

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

  2. Defina mode como maintenance na secção spec do manifesto DBCluster:

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

    Substitua DB_CLUSTER_NAME pelo nome deste cluster de base de dados, por exemplo, my-db-cluster.

  3. Aplique o manifesto:

    kubectl apply -f DB_CLUSTER_YAML

    Substitua DB_CLUSTER_YAML pelo nome deste ficheiro de manifesto do cluster da base de dados, por exemplo, alloydb-omni-db-cluster.yaml.

  4. Para verificar se o modo de manutenção está ativado, execute os seguintes comandos:

    • Sonda de atividade:

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

    • Sonda de arranque:

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

    O resultado não contém os campos Liveness e Startup na secção spec do seu pod POD_NAME.

Desative o modo de manutenção

Para regressar ao comportamento padrão do cluster da base de dados com sondagens de vitalidade e de arranque em execução, use o seguinte comando para remover maintenance da secção spec do manifesto DBCluster:

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

Exemplos de resultados:

  • Com uma análise de vitalidade:

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

  • Com uma sonda de arranque:

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