Esta página foi traduzida pela API Cloud Translation.

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.

Nota: antes de começar a restaurar uma única região, considere se os seguintes passos prévios são aplicáveis:

Se quiser preservar uma configuração existente para resolução de problemas e análise da causa principal (RCA), deve: Eliminar todos os componentes org e env do cluster do Kubernetes Exceto o controlador do Apigee e, em seguida, manter o cluster. O cluster vai conter o arquivo de dados do Apigee existente (Cassandra), que pode usar para a resolução de problemas. Crie um novo cluster do Kubernetes e, em seguida, restaure o Cassandra no novo cluster.
Se a instalação híbrida tiver sido configurada com várias organizações, obtenha os ficheiros de substituições para cada organização antes de prosseguir com a restauração numa única região. Pode adicionar a configuração de restauro, conforme descrito no passo 3, a qualquer um dos ficheiros de substituições. Não adicione a configuração de restauro a nenhum outro ficheiro de substituições.

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

Na sua configuração, a cópia de segurança do Cassandra pode residir no Cloud Storage ou num servidor remoto. Em qualquer dos casos, siga os passos abaixo para restaurar:

Valide a versão híbrida.
```
apigeectl version
```
Certifique-se de que a versão é a mesma que criou os ficheiros de cópia de segurança no armazenamento.
Sugestão: execute todos os comandos apigeectl com a flag --dry-run=true primeiro para verificar se existem erros do apigeectl.
Confirme que o cluster do Kubernetes para o qual está a restaurar não tem uma instalação híbrida do Apigee anterior. Se estiver a restaurar para o cluster existente, use os seguintes comandos para eliminar a instalação do Apigee hybrid existente:
```
apigeectl delete -f overrides.yaml
kubectl -n apigee get apigeedatastore,apigeeredis,apigeetelemetry,org,env,arc # The output should be empty.
apigeectl delete --all -f overrides.yaml
```

Abra o ficheiro overrides.yaml e defina as propriedades restore para os valores pretendidos:

Cloud Storage

Parâmetros

namespace: YOUR_RESTORE_NAMESPACE # Use the 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: true
    serviceAccountPath: "SA_JSON_FILE_PATH"
    dbStorageBucket: "CLOUD_STORAGE_BUCKET_PATH"
    cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
    schedule: "SCHEDULE"

Exemplo

namespace: apigee
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    cloudProvider: "GCP"
    snapshotTimestamp: "20201001183903"
  ...
  backup:
    enabled: true
    serviceAccountPath: "/Users/myhome/.ssh/my_cassandra_backup.json"
    dbStorageBucket: "gs://myname-cassandra-backup"
    cloudProvider: "GCP"
    schedule: "0 2 * * *"
  ...

Onde:

Propriedade	Descrição
`namespace`	`YOUR_RESTORE_NAMESPACE` Namespace para a restauração. Use o espaço de nomes como 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_PATH` O caminho do contentor do Cloud Storage onde os dados da cópia de segurança estão armazenados no seguinte formato: `gs://BUCKET_NAME`. O campo `gs://` é obrigatório.
`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`	A cópia de segurança está desativada por predefinição. Tem de definir esta propriedade como `true`.
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` O caminho no seu sistema de ficheiros para o ficheiro JSON da conta de serviço que foi transferido quando executou `./tools/create-service-account`
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_PATH` O caminho do contentor do Cloud Storage neste formato: `gs://BUCKET_NAME`. O campo `gs://` é obrigatório.
`backup:cloudProvider`	`GCP` A propriedade `cloudProvider: "GCP"` é obrigatória.
`backup:schedule`	`SCHEDULE` A hora em que a cópia de segurança começa, especificada na sintaxe crontab padrão. Predefinição: `0 2 * * ` Nota:* evite agendar uma cópia de segurança que comece pouco tempo depois de aplicar a configuração da cópia de segurança ao cluster. Quando aplica a configuração da cópia de segurança, o Kubernetes recria os nós do Cassandra. Se a cópia de segurança for iniciada antes do reinício dos nós (possivelmente, vários minutos), a cópia de segurança falha.

Armazenamento não na nuvem

Parâmetros

namespace: YOUR_RESTORE_NAMESPACE # Use the namespace as in your original cluster.
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    keyFile: "PATH_TO_PRIVATE_KEY_FILE"
    server: "BACKUP_SERVER_IP"
    storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
    cloudProvider: "HYBRID"  # required verbatim "HYBRID" (all caps)
    snapshotTimestamp: "TIMESTAMP"
  ...
  backup:
    enabled: true
    keyFile: "PATH_TO_PRIVATE_KEY_FILE"
    server: "BACKUP_SERVER_IP"
    storageDirectory: "/home/apigee/BACKUP_DIRECTORY"
    cloudProvider: "HYBRID" # required verbatim "HYBRID" (all caps)
    schedule: "SCHEDULE"

Exemplo

namespace: apigee
cassandra:
  hostNetwork: false
  ...
  restore:
    enabled: true
    keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
    server: "34.56.78.90"
    storageDirectory: "/home/apigee/cassbackup"
    cloudProvider: "HYBRID"
    snapshotTimestamp: "20201001183903"
  ...
  backup:
    enabled: true
    keyFile: "/Users/exampleuser/apigee-hybrid/hybrid-files/service-accounts/private.key"
    server: "34.56.78.90"
    storageDirectory: "/home/apigee/cassbackup"
    cloudProvider: "HYBRID"
    schedule: "0 2 * * *"
  ...

Onde:

Propriedade	Descrição
`namespace`	`YOUR_RESTORE_NAMESPACE` Namespace para a restauração. Use o espaço de nomes como 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:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` O caminho no seu sistema de ficheiros local para o ficheiro de chave privada de SSH (denominado `ssh_key` no passo em que criou o par de chaves SSH).
`restore:server`	`BACKUP_SERVER_IP` O endereço IP do seu servidor de reserva.
`restore:storageDirectory`	`BACKUP_DIRECTORY` O nome do diretório de cópia de segurança no servidor de cópia de segurança. Tem de ser um diretório em `home/apigee` (o diretório de cópia de segurança chama-se `cassandra_backup` no passo em que criou o diretório de cópia de segurança).
`restore:cloudProvider`	`HYBRID` A propriedade `cloudProvider: "HYBRID"` é 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`	A cópia de segurança está desativada por predefinição. Tem de definir esta propriedade como `true`.
`backup:keyFile`	`PATH_TO_PRIVATE_KEY_FILE` O caminho no seu sistema de ficheiros local para o ficheiro de chave privada de SSH (denominado `ssh_key` no passo em que criou o par de chaves SSH).
`backup:server`	`BACKUP_SERVER_IP` O endereço IP do seu servidor de reserva.
`backup:storageDirectory`	`BACKUP_DIRECTORY` O nome do diretório de cópia de segurança no servidor de cópia de segurança. Tem de ser um diretório em `home/apigee` (o diretório de cópia de segurança tem o nome `cassandra_backup` no passo em que criou o diretório de cópia de segurança).
`backup:cloudProvider`	`HYBRID` A propriedade `cloudProvider: "HYBRID"` é obrigatória.
`backup:schedule`	`SCHEDULE` A hora em que a cópia de segurança começa, especificada na sintaxe crontab padrão. Predefinição: `0 2 * * ` Nota:* evite agendar uma cópia de segurança que comece pouco tempo depois de aplicar a configuração da cópia de segurança ao cluster. Quando aplica a configuração da cópia de segurança, o Kubernetes recria os nós do Cassandra. Se a cópia de segurança for iniciada antes do reinício dos nós (possivelmente, vários minutos), a cópia de segurança falha.

Nota: o Apigee restaura o Cassandra a partir de uma cópia de segurança do Cloud Storage ou de uma cópia de segurança do servidor remoto com base na configuração backup no ficheiro overrides.yaml.

Crie uma nova implementação de tempo de execução híbrido. Esta ação cria um novo cluster do Cassandra e começa a restaurar os dados da cópia de segurança no cluster:

${APIGEECTL_HOME}/apigeectl init  -f overrides/overrides.yaml

${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

${APIGEECTL_HOME}/apigeectl apply -f overrides/overrides.yaml --restore

${APIGEECTL_HOME}/apigeectl check-ready -f overrides/overrides.yaml

Verifique o progresso da tarefa de restauro e confirme que apigeeds e todos os outros pods estão ativos:
- Para verificar apigeeds:
```
kubectl get apigeeds -n apigee
```
- Para verificar todos os outros pods:
```
kubectl get pods -n apigee
```

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:

Remova a configuração restore do ficheiro overrides-restore.yaml.
Adicione a configuração backup ao ficheiro overrides-restore.yaml.
Aplique a configuração backup com o seguinte comando:
```
./apigeectl apply -f ../overrides-restore.yaml
```