Partilhar via

Guia de início rápido: criar uma instância gerenciada do Azure para cluster Apache Cassandra usando a CLI do Azure

A Instância Gerenciada do Azure para Apache Cassandra é um serviço totalmente gerenciado para clusters Apache Cassandra de código aberto puro. O serviço também permite que as configurações sejam substituídas, dependendo das necessidades específicas de cada carga de trabalho, para máxima flexibilidade e controle.

Este guia de início rápido demonstra como usar os comandos da CLI do Azure para criar um cluster com a Instância Gerenciada do Azure para Apache Cassandra. Ele também mostra como criar um datacenter e dimensionar nós para cima ou para baixo dentro do datacenter.

Pré-requisitos

Importante

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.

Criar um cluster de instância gerenciado

  1. Inicie sessão no portal Azure.

  2. Defina sua ID de assinatura na CLI do Azure:

    az account set --subscription <Subscription_ID>

  3. Crie uma rede virtual com uma sub-rede dedicada no seu grupo de recursos:

    az network vnet create --name <VNet_Name> --location eastus2 \
  --resource-group <Resource_Group_Name> --subnet-name <Subnet Name>

    A implantação de uma instância da Instância Gerenciada do Azure para Apache Cassandra requer acesso à Internet. A implantação falha em ambientes onde o acesso à Internet é restrito. Certifique-se de que não está a bloquear o acesso na sua rede virtual aos seguintes serviços do Azure que são necessários para que a Instância Gerida do Azure para Apache Cassandra funcione corretamente:

    • Storage do Azure
    • Azure Key Vault
    • Conjuntos de Escalabilidade do Azure para Máquinas Virtuais
    • Azure Monitor
    • Microsoft Entra ID
    • Microsoft Defender para a Cloud

  4. Aplique essas permissões específicas à rede virtual. A instância gerenciada os exige. Use o comando e substitua az role assignment create<subscriptionID>, <resourceGroupName>e <vnetName> com os valores apropriados:

    az role assignment create \
  --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \
  --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \
  --scope /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>

    Os assignee valores e role são valores fixos. Insira esses valores exatamente como mencionado no comando. Não fazer isso leva a erros quando você cria o cluster. Se você encontrar algum erro ao executar esse comando, talvez não tenha permissões para executá-lo. Entre em contato com o administrador do Azure para obter permissões.

  5. Crie o cluster em sua rede virtual recém-criada usando o comando az managed-cassandra cluster create . Execute o seguinte comando com o valor da delegatedManagementSubnetId variável. (O valor de delegatedManagementSubnetId é o mesmo nome da rede virtual para a qual as permissões foram aplicadas.)

    resourceGroupName='<Resource_Group_Name>'
clusterName='<Cluster_Name>'
location='eastus2'
delegatedManagementSubnetId='/subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Network/virtualNetworks/<VNet name>/subnets/<subnet name>'
initialCassandraAdminPassword='myPassword'
cassandraVersion='5.0' # set to 4.0 for a Cassandra 4.0 cluster

az managed-cassandra cluster create \
  --cluster-name $clusterName \
  --resource-group $resourceGroupName \
  --location $location \
  --delegated-management-subnet-id $delegatedManagementSubnetId \
  --initial-cassandra-admin-password $initialCassandraAdminPassword \
  --cassandra-version $cassandraVersion \
  --debug

  6. Crie um datacenter para o cluster com três máquinas virtuais (VMs). Utilize a seguinte configuração:

    • Tamanho da VM: Standard E8s v5
    • Discos de dados: 4 discos P30 conectados a cada uma das VMs implantadas

    Depois que todas as informações estiverem disponíveis, use o comando az managed-cassandra datacenter create :

    dataCenterName='dc1'
dataCenterLocation='eastus2'
virtualMachineSKU='Standard_D8s_v4'
noOfDisksPerNode=4

az managed-cassandra datacenter create \
  --resource-group $resourceGroupName \
  --cluster-name $clusterName \
  --data-center-name $dataCenterName \
  --data-center-location $dataCenterLocation \
  --delegated-subnet-id $delegatedManagementSubnetId \
  --node-count 3 \
  --sku $virtualMachineSKU \
  --disk-capacity $noOfDisksPerNode \
  --availability-zone false

    Escolha o valor para --sku entre os seguintes tamanhos de VM disponíveis:

    • Standard_E8s_v5
    • Standard_E16s_v5
    • Standard_E20s_v5
    • Standard_E32s_v5

    Por padrão, --availability-zone é definido como false. Para habilitar zonas de disponibilidade, defina-o como true. As zonas de disponibilidade ajudam a aumentar a disponibilidade do serviço. Para mais informações, consulte Acordos de nível de serviço para serviços online.

    As zonas de disponibilidade não são suportadas em todas as regiões do Azure. As implantações falham se você selecionar uma região onde as zonas de disponibilidade não são suportadas. Para regiões com suporte, consulte a lista de regiões do Azure.

    A implantação bem-sucedida de zonas de disponibilidade está sujeita à disponibilidade de recursos de computação em todas as zonas da região selecionada. As implantações falham se o tamanho da VM que você escolheu não estiver disponível na região selecionada.

  7. Depois que o datacenter for criado, você poderá executar o comando az managed-cassandra datacenter update para reduzir ou aumentar a escala do cluster. Altere o node-count valor do parâmetro para o valor desejado:

    resourceGroupName='<Resource_Group_Name>'
clusterName='<Cluster Name>'
dataCenterName='dc1'
dataCenterLocation='eastus2'

az managed-cassandra datacenter update \
  --resource-group $resourceGroupName \
  --cluster-name $clusterName \
  --data-center-name $dataCenterName \
  --node-count 9

Conectar-se ao cluster

A Instância Gerenciada do Azure para Apache Cassandra não cria nós com endereços IP públicos. Para se conectar ao seu novo cluster Cassandra, você deve criar outro recurso dentro da mesma rede virtual. Este recurso pode ser um aplicativo ou uma VM com Cassandra Query Language Shell (CQLSH) instalado. CQLSH é uma ferramenta de consulta de código aberto Apache.

Você pode usar um modelo do Azure Resource Manager para implantar uma VM do Ubuntu.

Devido a alguns problemas conhecidos com versões do Python, recomendamos que você use uma imagem do Ubuntu 22.04 que vem com o Python3.10.12 ou um ambiente virtual Python para executar o CQLSH.

Conecte-se a partir do CQLSH

Depois que a VM for implantada, use o Secure Shell para se conectar à máquina e instalar o CQLSH. Use os seguintes comandos:

# Install default-jre and default-jdk
sudo apt update
sudo apt install openjdk-8-jdk openjdk-8-jre

Verifique quais versões do Cassandra ainda são suportadas e selecione a versão que você precisa. Recomendamos que você use uma versão estável.

Instale as bibliotecas Cassandra para obter CQLSH. Siga os passos oficiais da documentação da Cassandra.

Conectar a partir de uma aplicação

Assim como no CQLSH, quando você usa um dos drivers de cliente Apache Cassandra suportados para se conectar a partir de um aplicativo, a criptografia Transport Layer Security/Secure Sockets Layer (TLS/SSL) deve ser habilitada e a verificação de certificado deve ser desabilitada. Para exemplos, consulte Java, .NET,Node.jse Python.

Recomendamos que você desabilite a verificação de certificado porque ela não funciona, a menos que você mapeie os endereços IP dos nós do cluster para o domínio apropriado. Se uma política interna exigir que você execute a verificação do certificado TLS/SSL para qualquer aplicativo, adicione entradas como 10.0.1.5 host1.managedcassandra.cosmos.azure.com no arquivo hosts para cada nó para facilitar essa configuração. Se assumir esta abordagem, também precisará adicionar novas entradas sempre que expandir capacidade dos nós.

Para Java, recomendamos que você habilite a política de execução especulativa onde os aplicativos são sensíveis à latência de cauda. Para obter uma demonstração que ilustra como essa abordagem funciona e como habilitar a política, consulte Implementar política de execução especulativa.

Normalmente, não é necessário configurar certificados (como rootCA, , nodeclientou truststore) para se conectar à Instância Gerenciada do Azure para Apache Cassandra. A criptografia TLS/SSL usa o armazenamento confiável padrão e a senha de tempo de execução escolhida pelo cliente. Para código de exemplo, consulte Java, .NET,Node.jse Python). Os certificados são confiáveis por padrão. Caso contrário, adicione-os ao repositório confiável.

Configurar certificados de cliente (opcional)

A configuração de certificados de cliente é opcional. Um aplicativo cliente pode se conectar à Instância Gerenciada do Azure para Apache Cassandra depois de seguir as etapas anteriores. Se preferir, você também pode criar e configurar certificados de cliente para autenticação. Em geral, há duas maneiras de criar certificados:

  • Certificados autoassinados: Certificados privados e públicos sem Autoridade de Certificação (CA) em cada nó. Neste caso, todos os certificados públicos são necessários.
  • Certificados assinados por uma autoridade de certificação: Certificados emitidos por uma autoridade de certificação autoassinada ou pública. Para essa configuração, você precisa do certificado de autoridade de certificação raiz e de todos os certificados intermediários, se aplicável. Para obter mais informações, consulte Preparar certificados SSL para produção.

Para implementar a autenticação de certificado entre cliente e nó ou a Mutual TLS (Segurança de Camada de Transporte), forneça os certificados utilizando o Azure CLI. O comando a seguir carrega e aplica os certificados de cliente ao repositório de confiança da Instância Gerenciada do Azure do cluster Apache Cassandra. Não é necessário modificar as cassandra.yaml configurações. Depois que os certificados são aplicados, o cluster exige que Cassandra verifique os certificados durante as conexões de cliente. Para obter mais informações, consulte require_client_auth: true em Cassandra client_encryption_options.

resourceGroupName='<Resource_Group_Name>'
clusterName='<Cluster Name>'

az managed-cassandra cluster update \
  --resource-group $resourceGroupName \
  --cluster-name $clusterName \
  --client-certificates /usr/csuser/clouddrive/rootCert.pem /usr/csuser/clouddrive/intermediateCert.pem

Resolução de Problemas

Se encontrar um erro ao aplicar permissões à sua rede virtual utilizando a CLI do Azure, pode aplicar a mesma permissão manualmente a partir do portal do Azure. Um exemplo desse erro é "Não é possível encontrar o usuário ou a entidade de serviço no banco de dados gráfico para e5007d2c-4b13-4a74-9b6a-605d99f03501." Para obter mais informações, consulte Usar o portal do Azure para adicionar a entidade de serviço do Azure Cosmos DB.

A atribuição de função do Azure Cosmos DB é usada apenas para fins de implantação. A Instância Gerenciada do Azure para Apache Cassandra não tem dependências de back-end no Azure Cosmos DB.

Clean up resources (Limpar recursos)

Quando o recurso não for mais necessário, use o az group delete comando para remover o grupo de recursos, a instância gerenciada e todos os recursos relacionados:

az group delete --name <Resource_Group_Name>

Próximo passo

Neste início rápido, você aprendeu como criar uma Instância Gerenciada do Azure para cluster Apache Cassandra usando a CLI do Azure. Agora você pode começar a trabalhar com o cluster:

Implantar um cluster Apache Spark gerenciado com o Azure Databricks

  • Last updated on