Restaurar numa única região

Esta página descreve como restaurar o Cassandra numa única região.

Numa implementação de região única, o Apigee hybrid é implementado num único centro de dados ou numa região. Se tiver várias organizações do Apigee na sua implementação, o processo de restauro restaura os dados de todas as organizações. Numa configuração com várias organizações, não pode restaurar uma organização específica.

Restaurar uma região a partir de uma cópia de segurança

  1. Atualize os detalhes de restauro do Cassandra no ficheiro overrides.yaml:

    namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_NAME"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: false
  ...

    Onde:

    Propriedade Descrição
    namespace

    YOUR_RESTORE_NAMESPACE

    Espaço de nomes para a restauro. Use o mesmo espaço de nomes que no cluster original.
    cassandra:hostNetwork

    hostNetwork é obrigatório e deve ser sempre definido como false.

    restore:enabled O restauro está desativado por predefinição. Tem de definir esta propriedade como true.
    restore:serviceAccountPath

    SA_JSON_FILE_PATH

    O caminho no seu sistema de ficheiros para a conta de serviço que criou para a cópia de segurança.
    restore:dbStorageBucket

    CLOUD_STORAGE_BUCKET_NAME

    O nome de um contentor do Google Cloud Storage que armazena arquivos de cópias de segurança a serem usados para o restauro de dados.
    restore:cloudProvider

    GCP

    A propriedade cloudProvider: "GCP" é obrigatória.
    restore:snapshotTimestamp

    TIMESTAMP

    A data/hora do instantâneo da cópia de segurança a restaurar. Para verificar que datas/horas podem ser usadas, aceda ao dbStorageBucket e consulte os ficheiros presentes no contentor. Cada nome de ficheiro contém um valor de carimbo de data/hora. Por exemplo, backup_20210203213003_apigee-cassandra-default-0.tgz

    Em que 20210203213003 é o valor snapshotTimestamp que usaria se quisesse restaurar as cópias de segurança criadas nesse momento.

    backup:enabled Deve definir esta propriedade como false caso tenha sido definida anteriormente como true.

  2. Caso não tenha um cluster limpo para começar, siga a documentação Desative uma região híbrida para o Helm para colocar a sua instalação híbrida existente num estado limpo (pode deixar o Cert Manager instalado). Isto leva a um estado igual como se tivesse seguido o manual de configuração do tempo de execução do Helm até ao início do passo 11.

  3. Verifique se não restam pods no espaço de nomes do Apigee:

    kubectl get pods -n APIGEE_NAMESPACE

  4. Se estiver a usar a cópia de segurança da CSI, certifique-se de que consegue ver os volumesnapshots que quer usar para o processo de restauro executando o seguinte comando:

    kubectl get volumesnapshot -n APIGEE_NAMESPACE

  5. Instale todos os componentes híbridos um a um, conforme descrito no Passo 10: instale o Apigee Hybrid com o Helm . Tenha em atenção que o pod apigee-cassandra-restore é criado assim que executar o comando para instalar o datastore, mas só passa para o estado running depois de instalar o componente apigee-org.

Consulte a vista geral da cópia de segurança do Cassandra para ver mais detalhes sobre a cópia de segurança e o restauro do Cassandra.

Verifique o progresso da tarefa de restauro e confirme que apigeeds e todos os outros pods estão ativos:

  1. Verifique apigeeds: 
    kubectl get apigeeds -n APIGEE_NAMESPACE
  2. Verifique todos os outros pods: 
    kubectl get pods -n APIGEE_NAMESPACE

Após a conclusão com êxito do restauro e a confirmação de que os componentes de tempo de execução estão em bom estado, recomendamos que configure uma cópia de segurança no cluster:

  1. Remova a configuração restore do ficheiro overrides-restore.yaml.
  2. Adicione a configuração backup ao ficheiro overrides-restore.yaml.
  3. Aplique a configuração backup com o seguinte comando: 
    helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides-restore.yaml