Como restaurar em várias regiões

Nesta página, descrevemos como restaurar o Cassandra em várias regiões.

Em uma implantação multirregional, a Apigee híbrida é implantada em vários locais geográficos em diferentes data centers. É importante observar que, se você tiver várias organizações da Apigee na implantação, o processo de restauração restaura dados para todas as organizações. Em uma configuração de várias organizações, a restauração de apenas uma organização específica não é compatível.

Como restaurar o Cassandra

Em uma implantação multirregional, há duas maneiras possíveis de recuperar uma região com falha. Este tópico descreve as seguintes abordagens:

• Recuperar regiões com falha: descreve as etapas para recuperar regiões com falha com base em uma região íntegra.
• Restaurar regiões com falha: descreve as etapas para restaurar regiões com falha de um backup. Essa abordagem só será necessária se todas as regiões híbridas forem afetadas.

Recuperar regiões com falha

Para recuperar as regiões com falha de uma região íntegra, siga estas etapas:

1. Redirecione o tráfego da API das regiões afetadas para a boa região de trabalho. Planeje a capacidade de acordo com o tráfego desviado de regiões com falha.
2. Desativar a região afetada. Para cada região afetada, siga as etapas descritas em Desativar uma região híbrida. Aguarde a conclusão da desativação antes de passar para a próxima etapa.
3. Restaure a região afetada. Para restaurar, crie uma nova região, conforme descrito em Implantação multirregional no GKE, GKE On-Prem e AKS.

Como restaurar de um backup

O backup do Cassandra pode residir no Cloud Storage ou em um servidor remoto com base na sua configuração. Para restaurar o Cassandra de um backup, execute as seguintes etapas:

1. Exclua a implantação da Apigee híbrida de todas as regiões:

   apigeectl delete -f overrides.yaml

2. Restaure a região desejada de um backup. Para mais informações, consulte Como restaurar uma região a partir de um backup.

3. Remova as referências de regiões excluídas e adicione as referências de regiões restauradas nos metadados KeySpaces.
4. Use a opção nodetool status para receber o nome da região.

   kubectl exec -n apigee -it apigee-cassandra-default-0 -- bash
         nodetool  -u APIGEE_JMX_USER -pw APIGEE_JMX_PASSWORD status |grep -i Datacenter

   onde:

   • APIGEE_JMX_USER é o nome de usuário do usuário das operações JMX do Cassandra. Usado para autenticar e se comunicar com a interface do Cassandra JMX. Confira cassandra:auth:jmx:username.
   • APIGEE_JMX_PASSWORD é a senha do usuário das operações JMX do Cassandra. Confira cassandra:auth:jmx:password.
5. Atualize a replicação KeySpaces.
   1. Crie um contêiner de cliente e conecte-se ao cluster do Cassandra por meio da interface CQL.
   2. Veja a lista de keyspaces do usuário na interface CQL:

      cqlsh CASSANDRA_SEED_HOST -u APIGEE_DDL_USER -p APIGEE_DDL_PASSWORD
            --ssl -e "select keyspace_name from system_schema.keyspaces;"|grep -v system

      onde:

      • CASSANDRA_SEED_HOST é o host de multirregião do Cassandra. Para a maioria das instalações multirregionais, use o endereço IP de um host na sua primeira região. Consulte Configurar a Apigee híbrida para várias regiões e cassandra:externalSeedHost.
      • APIGEE_DDL_USER e APIGEE_DDL_PASSWORD são o nome de usuário e a senha de administrador do usuário da Linguagem de definição de dados (DDL, na sigla em inglês) do Cassandra. Os valores padrão são "ddl_user" e "iloveapis123".

        Consulte cassandra.auth.ddl.password na referência das propriedades de configuração e opções de linha de comando na documentação do Apache Cassandra cqlsh.

   3. Para cada keyspace, execute o seguinte comando na interface CQL para atualizar as configurações de replicação:

      ALTER KEYSPACE KEYSPACE_NAME WITH replication = {'class': 'NetworkTopologyStrategy', 'REGION_NAME':3};

      em que:

      • KEYSPACE_NAME é o nome do espaço de chave listado na saída da etapa anterior.
      • REGION_NAME é o nome da região obtido na Etapa 4.