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.

Observação: antes de começar a restaurar uma única região, considere as seguintes etapas de pré-requisito aplicáveis:

Se você quiser preservar uma configuração atual para solução de problemas e análise de causa raiz (RCA, na sigla em inglês), exclua todos os componentes org e env do cluster do Kubernetes, exceto o controlador Apigee e depois retenha o cluster. O cluster vai ter o armazenamento de dados da Apigee (Cassandra) atual que pode ser usado para solução de problemas. Em seguida, crie um novo cluster do Kubernetes e restaure o Cassandra no novo cluster.
Se a instalação híbrida tiver sido configurada com várias organizações, solicite os arquivos de modificação para cada uma antes de prosseguir com a restauração em uma única região. Você pode adicionar a configuração de restauração conforme descrito na Etapa 3 a qualquer um dos arquivos de modificação. Não adicione a configuração de restauração a outro arquivo de substituição.

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_PATH"
    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_PATH` O caminho do bucket do Cloud Storage em que os dados de backup são armazenados no seguinte formato: `gs://BUCKET_NAME`. O `gs://` é obrigatório.
`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`. Observação: o backup não pode ser ativado durante a restauração.

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 nos namespaces da Apigee:

kubectl get pods -n apigee
kubectl get pods -n apigee-system

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
          
```
Instale todos os componentes híbridos, um por um, conforme descrito na Etapa 11 no manual de instalação. 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.

Importante: omita a flag ‑‑atomic de todos os comandos upgrade para clusters migrados.

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
```
Verifique todos os outros pods:
```
kubectl get pods -n apigee
```

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

Aplique a configuração backup com o seguinte comando:

helm upgrade datastore apigee-datastore/ \
  --namespace apigee \
  --atomic \
  -f overrides-restore.yaml