Como restaurar em uma única região

Nesta página, descrevemos como restaurar o Cassandra em uma única região.

Em uma implantação de região única, a Apigee híbrida é implantada em um único data center ou região. Se você tiver várias organizações da Apigee na implantação, o processo de restauração vai restaurar dados para todas as organizações. Em uma configuração de várias organizações, não é possível restaurar uma organização específica.

Como restaurar uma região de um backup

  1. Atualize os detalhes da restauração do Cassandra no arquivo 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
  ...

    Em que:

    Propriedade Descrição
    namespace

    YOUR_RESTORE_NAMESPACE

    Namespace para restauração. Use o namespace como no cluster original.
    cassandra:hostNetwork

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

    restore:enabled A restauração é desativada por padrão. É preciso definir essa propriedade como true.
    restore:serviceAccountPath

    SA_JSON_FILE_PATH

    O caminho no sistema de arquivos para a conta de serviço que você criou para o backup.
    restore:dbStorageBucket

    CLOUD_STORAGE_BUCKET_NAME

    O nome de um bucket do Google Cloud Storage que armazena arquivos de backup para serem usados na restauração de dados.
    restore:cloudProvider

    GCP

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

    TIMESTAMP

    O carimbo de data/hora do snapshot de backup a ser restaurado. Para verificar quais carimbos de data/hora podem ser usados, acesse dbStorageBucket e observe os arquivos presentes no bucket. Cada nome de arquivo contém um valor de carimbo de data/hora. Exemplo: backup_20210203213003_apigee-cassandra-default-0.tgz

    Onde 20210203213003 é o valor snapshotTimestamp que você usaria se quisesse restaurar os backups criados nesse momento.

    backup:enabled Defina essa propriedade como false caso ela tenha sido configurada anteriormente como true.

  2. Caso você não tenha um cluster limpo para começar, siga a documentação Desativar uma região híbrida para Helm para deixar sua instalação híbrida atual em um estado limpo (deixe o Gerenciador de certificados instalado). Isso traria o mesmo estado que se você tivesse seguido o Manual de configuração do ambiente de execução do Helm até o início da Etapa 11.

  3. Verifique se não há pods restantes no namespace da Apigee:

    kubectl get pods -n APIGEE_NAMESPACE

  4. Se você estiver usando o backup CSI, verifique se os volumesnapshots que quer usar no processo de restauração é exibido. Para isso, execute o seguinte comando:

    kubectl get volumesnapshot -n APIGEE_NAMESPACE

  5. Instale todos os componentes híbridos, um por um, conforme descrito na Etapa 10: instalar a Apigee híbrida usando o Helm . O pod apigee-cassandra-restore será criado quando você executar o comando para instalar o datastore, mas ele só entrará no estado running depois que você instalar o componente apigee-org.

Consulte Visão geral do backup do Cassandra para ver mais detalhes sobre o backup e a restauração do Cassandra.

Verifique o progresso do job de restauração e confirme se apigeeds e todos os outros pods estão ativos:

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

Após a conclusão bem-sucedida da restauração e da confirmação de que os componentes do ambiente de execução estão íntegros, recomendamos que você configure um backup no cluster:

  1. Remova a configuração restore do arquivo overrides-restore.yaml.
  2. Adicione a configuração backup ao arquivo 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