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
-
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 comofalse
.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 comotrue
. -
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.
-
Verifique se não há pods restantes no namespace da Apigee:
kubectl get pods -n APIGEE_NAMESPACE
-
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
-
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 odatastore
, mas ele só entrará no estadorunning
depois que você instalar o componenteapigee-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:
- Verificar
apigeeds
:kubectl get apigeeds -n APIGEE_NAMESPACE
- 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:
- Remova a configuração
restore
do arquivooverrides-restore.yaml
. - Adicione a configuração
backup
ao arquivooverrides-restore.yaml
. - Aplique a configuração
backup
com o seguinte comando:helm upgrade datastore apigee-datastore/ \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides-restore.yaml