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

  • Artigo

O configurador do 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.

Importante

A ferramenta Client Configurator está em pré-visualização pública. Esse recurso é fornecido sem um contrato de nível de serviço e não é recomendado para cargas de trabalho de produção. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

Pré-requisitos

  • Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no 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 Entrar com a CLI do Azure.

    • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o 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 superior. Se você estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.

  • 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 o artigo Conectar uma rede local ao Azure .

  • A instalação do Python é necessária. Você pode verificar se o python está instalado executando python --version no seu terminal.

  • Verifique se a Instância Gerenciada do Azure e o cluster Cassandra local estão localizados na mesma rede virtual. Caso contrário, é necessário estabelecer emparelhamento de rede ou outros meios de conectividade (por exemplo, rota expressa).

  • O nome do cluster para o cluster gerenciado e o cluster local deve ser o mesmo. * No arquivo cassandra.yaml, 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

  • Transfira e navegue até à pasta do configurador do cliente.
  • Configure um ambiente virtual para executar o script python:
python3 -m venv env
source env/bin/activate
python3 -m pip install -r requirements.txt
  • Entrar na CLI do Azure az login
  • Execute o script python dentro da 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>

Nota

  • subscription-id: ID da assinatura do Azure.
  • cluster-resource-group: grupo de recursos no qual o cluster reside.
  • cluster-name: nome do cluster da Instância Gerenciada do Azure.
  • initial-password: Senha para sua Instância Gerenciada do Azure para cluster Apache Cassandra.
  • vnet-resource-group: O grupo de recursos anexado à rede virtual.
  • vnet-name: Nome da rede virtual conectada ao cluster.
  • subnet-name: O nome do IP endereçado alocado ao cluster Cassandra.
  • local: onde o cluster está implantado.
  • seed-nodes: os nós seed dos datacenters existentes em seu cluster Cassandra local ou auto-hospedado.
  • mi-dc-name: o nome do data center do cluster da Instância Gerenciada do Azure.
  • dc-name: O nome do data center do cluster local.
  • sku: O tamanho da SKU da máquina virtual.

  • O script Python produz um arquivo tar chamado install_certs.tar.gz. * Descompacte esta pasta em /etc/cassandra/ cada nó.

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

  • 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 ao cluster da Instância Gerenciada do Azure.
    • Em seguida, ele solicita que o usuário reinicie Cassandra. Screenshot of the result of running the script.

  • Quando 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 ONU (Up/Normal).

  • Na sua Instância Gerenciada do Azure para Apache Cassandra, você pode selecionar AllKeyspaces para alterar as configurações de replicação em seu esquema Keyspace e iniciar o processo de migração para o cluster Cassandra Managed Instance.

    Screenshot of selecting all key spaces.

Gorjeta

A configuração de replicação automática deve ser habilitada por meio de um modelo arm. O modelo de braço deve incluir:

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

Aviso

Isso alterará toda a sua definição de keyspaces para incluir WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Se essa não for a topologia desejada, será necessário ajustá-la e executá-la nodetool rebuild manualmente no cluster Cassandra Managed Instance. Saiba mais sobre a replicação automática

  • Atualizar e monitorar o progresso da replicação de dados selecionando o Data Center painel

    Screenshot showing replication progress.

[!INFO]

Próximos passos

Neste guia de início rápido, você aprendeu como criar um cluster híbrido usando a Instância Gerenciada do Azure para o Apache Cassandra Client Configurator. Agora você pode começar a trabalhar com o cluster.

Saiba como migrar para a Instância Gerenciada do Azure para Apache Cassandra usando o Apache Spark e um proxy de gravação dupla