Início Rápido: Configurar um cluster híbrido com a Instância Gerenciada do Azure para Apache Cassandra usando o Configurador do 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 atualmente 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 diretamente outros datacenters em seu cluster, mantendo-os efetivamente.

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Este artigo requer a CLI do Azure versão 2.30.0 ou posterior. Se você está usando o Azure Cloud Shell, a última versão 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.

• Uma instalação do Python é necessária. Para verificar se o Python está instalado, execute python --version em seu terminal.

• Verifique se o cluster da Instância Gerenciada do Azure para Apache Cassandra e o cluster do Cassandra local estão localizados na mesma rede virtual. Caso contrário, você precisa estabelecer o 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 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. Baixe 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 logindo Azure.

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

   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 assinatura do Azure
   cluster-resource-group	Grupo de recursos em que o cluster reside
   cluster-name	Nome do cluster da Instância Gerenciada do Azure para Apache Cassandra
   initial-password	Senha para sua Instância Gerenciada do Azure para o cluster Apache Cassandra
   vnet-resource-group	Grupo de recursos anexado à rede virtual
   vnet-name	Nome da rede virtual anexada ao cluster
   subnet-name	Nome associado ao endereço de IP alocado para o cluster Cassandra
   location	Onde o cluster é implantado
   seed-nodes	Nós de semente dos datacenters existentes no seu cluster Cassandra local ou auto-hospedado
   mi-dc-name	Nome do datacenter da Instância Gerenciada do Azure para cluster do Apache Cassandra
   dc-name	Nome do datacenter 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. Desempacotar essa pasta em /etc/cassandra/ em cada nó:

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

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

   • Verifique se o script é executável executando sudo chmod +x install_certs.sh.

   • O script instala e direciona o Cassandra para os novos certificados necessários para conectar-se à Azure Managed Instance no cluster do Apache Cassandra.

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

     

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

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

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

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

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

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

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

    

Próxima etapa