Guia de início rápido: configurar um cluster híbrido com a Instância Gerenciada do Azure para Apache Cassandra usando o Configurador de Cliente

O Configurador de Cliente do Azure é uma ferramenta projetada para ajudá-lo a configurar um cluster híbrido e simplificar o processo de migração para a Instância Gerenciada do Azure para Apache Cassandra. Se você tiver datacenters locais ou estiver operando em um ambiente auto-hospedado, poderá usar a Instância Gerenciada do Azure para Apache Cassandra para incorporar perfeitamente outros datacenters em seu cluster enquanto os mantém efetivamente.

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

• Este artigo requer a CLI do Azure versão 2.30.0 ou posterior. Se você estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.

• Use uma rede virtual do Azure com conectividade com seu ambiente auto-hospedado ou local. Para obter mais informações sobre como conectar ambientes locais ao Azure, consulte Conectar uma rede local ao Azure.

• É necessária uma instalação do Python. Para verificar se o Python está instalado, execute python --version no seu terminal.

• Verifique se a Instância Gerenciada do Azure para cluster Apache Cassandra e o cluster Cassandra local estão localizados na mesma rede virtual. Se não, precisas estabelecer emparelhamento de rede ou outro meio de conectividade. Por exemplo, use o Azure ExpressRoute.

• O nome do cluster para o cluster gerenciado e o cluster local deve ser o mesmo.

  cassandra.yaml No arquivo, verifique se a porta de armazenamento está definida como 7001 e se o nome do cluster é o mesmo que o cluster gerenciado:

  cluster_name: managed_cluster-name
  storage_port: 7001
  

  UPDATE system.local SET cluster_name = 'managed_cluster-name' where key='local';
  

Instalação

1. Faça o download e vá para a pasta do configurador do cliente.

2. Configure um ambiente virtual para executar o script Python:

   python3 -m venv env
   source env/bin/activate
   python3 -m pip install -r requirements.txt
   

3. Entre na CLI az login do Azure.

4. Execute o script Python na pasta do cliente com informações do cluster existente (local):

   python3 client_configurator.py --subscription-id <subcriptionId> --cluster-resource-group <clusterResourceGroup> --cluster-name <clusterName> --initial-password <initialPassword> --vnet-resource-group <vnetResourceGroup> --vnet-name <vnetName> --subnet-name <subnetName> --location <location> --seed-nodes <seed1 seed2 seed3> --mi-dc-name <managedInstanceDataCenterName> --dc-name <onPremDataCenterName> --sku <sku>
   

   Parâmetro	Descrição
   subscription-ID	Id de subscrição do Azure
   cluster-resource-group	Grupo de recursos onde o cluster reside
   cluster-name	Instância Gerenciada do Azure para nome do cluster Apache Cassandra
   initial-password	Senha para sua instância gerenciada do Azure para cluster Apache Cassandra
   vnet-resource-group	Grupo de recursos anexado à rede virtual
   vnet-name	Nome da rede virtual conectada ao cluster
   subnet-name	Nome do IP endereçado atribuído ao cluster Cassandra
   location	Onde o cluster é implantado
   seed-nodes	Nós de propagação dos datacenters existentes em seu cluster Cassandra local ou auto-hospedado
   mi-dc-name	Nome do datacenter da sua Instância Gerenciada do Azure para cluster Apache Cassandra
   dc-name	Nome do centro de dados do cluster local
   sku	Tamanho da camada de produto da máquina virtual

5. O script Python produz um arquivo tar chamado install_certs.tar.gz. Descompacte esta pasta para /etc/cassandra/ em cada um dos nós:

   sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra
   

6. Dentro da /etc/cassandra/ pasta, execute sudo ./install_certs.sh.

   • Certifique-se de que o script é executável executando sudo chmod +x install_certs.sh.

   • O script instala e aponta Cassandra para os novos certificados necessários para se conectar à Instância Gerenciada do Azure para cluster Apache Cassandra.

   • Em seguida, ele solicita que o usuário reinicie Cassandra.

     

7. Após o Cassandra terminar de reiniciar em todos os nós, verifique nodetool status. Ambos os datacenters devem aparecer na lista, com os seus nós em estado UN (Up/Normal).

8. Na sua instância da Instância Gerida do Azure para Apache Cassandra, pode então selecionar AllKeyspaces para alterar as configurações de replicação no seu esquema de keyspace e iniciar o processo de migração para o cluster do Azure Managed Instance para Cassandra.

9. Habilite a autoReplicate configuração usando um modelo do Azure Resource Manager (modelo ARM). O modelo ARM deve incluir:

   "properties":{
   ...
   "externalDataCenters": ["dc-name-1","dc-name-2"],
   "autoReplicate": "AllKeyspaces",
   ...
   }
   

   Todas as suas definições de keyspaces mudam para incluir WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Se essa topologia não for a desejada, ajuste-a e execute nodetool rebuild manualmente na Instância Gerenciada do Azure para cluster Apache Cassandra.

   Saiba mais sobre a replicação automática.

10. Atualize e monitore o progresso da replicação de dados selecionando o painel Data Center .

    

Próximo passo