Início Rápido: criar uma Instância Gerenciada do Azure para o cluster do Apache Cassandra no portal do Azure

A Instância Gerenciada do Azure para Apache Cassandra fornece operações automatizadas de implantação e dimensionamento para datacenters open-source gerenciados do Apache Cassandra, acelerando cenários híbridos e reduzindo a manutenção contínua.

Este guia de início rápido demonstra como usar o portal do Azure para criar uma Instância Gerenciada do Azure para o cluster do Apache Cassandra.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Criar um cluster de instância gerenciada

  1. Entre no portal do Azure.

  2. Na barra de pesquisa, procure Instância Gerenciada para o Apache Cassandra e selecione o resultado.

    Captura de tela da pesquisa da Instância Gerenciada de SQL do Azure para Apache Cassandra.

  3. Clique no botão Criar Instância Gerenciada para o cluster do Apache Cassandra.

    Crie o cluster.

  4. No painel Criar Instância Gerenciada para o Apache Cassandra, insira os seguintes detalhes:

    • Assinatura – na lista suspensa, selecione sua assinatura do Azure.
    • Grupo de recursos – especifique se deseja criar um novo grupo de recursos ou usar um existente. Um grupo de recursos é um contêiner que mantém os recursos relacionados a uma solução do Azure. Para obter mais informações, confira o artigo de visão geral do Grupo de Recursos do Azure.
    • Nome do cluster – insira um nome para o cluster.
    • Local – local em que o cluster será implantado.
    • Senha inicial do administrador do Cassandra – senha usada para criar o cluster.
    • Confirmar senha de administrador do Cassandra – insira novamente sua senha.
    • Rede Virtual: selecione uma Rede Virtual ou Sub-rede existente ou crie uma.
    • Atribuir funções: as Redes Virtuais exigem permissões especiais para permitir que clusters do Cassandra gerenciados sejam implantados. Mantenha essa caixa marcada se você estiver criando uma Rede Virtual ou usando uma Rede Virtual existente sem permissões aplicadas. Se estiver usando uma Rede virtual em que você já implantou clusters do Cassandra de Instância Gerenciada de SQL do Azure, desmarque essa opção.

    Preencha o formulário de criação do cluster.

    Observação

    A implantação de um Instância Gerenciada do Azure para Apache Cassandra requer acesso à Internet. A implantação falha em ambientes em que o acesso à Internet é restrito. Verifique se você não está bloqueando o acesso na sua VNet aos serviços essenciais do Azure a seguir que são necessários para que o Cassandra Gerenciado funcione corretamente. Confira Regras de rede de saída necessárias para obter informações mais detalhadas.

    • Armazenamento do Azure
    • Azure KeyVault
    • Conjuntos de Dimensionamento de Máquinas Virtuais do Azure
    • Monitoramento do Azure
    • Azure Active Directory
    • Segurança do Azure
  5. Em seguida, selecione a guia Data center.

  6. Insira os seguintes detalhes:

    • Nome do Data Center – Digite um nome de data center no campo de texto.
    • Zona de disponibilidade: marque essa caixa de seleção se deseja habilitar as zonas de disponibilidade.
    • Tamanho do SKU: escolha entre os tamanhos de SKU de Máquina Virtual disponíveis.
    • Não. de discos – Escolha o número de discos p30 a serem anexados a cada nó do Cassandra.
    • Não. de nós – Escolha o número de nós do Cassandra que serão implantados nesse datacenter.

    Resumo da revisão para criar o datacenter.

    Aviso

    Não há suporte para zonas de disponibilidade em todas as regiões. As implantações falharão se você selecionar uma região em que não haja suporte para as zonas de disponibilidade. Confira aqui para ver as regiões com suporte. A implantação bem-sucedida de zonas de disponibilidade também está sujeita à disponibilidade de recursos de computação em todas as zonas na região determinada. As implantações poderão falhar se o SKU selecionado ou a capacidade não estiver disponível em todas as zonas.

  7. Em seguida, selecione Examinar + criar>Criar

    Observação

    Pode levar até 15 minutos para o cluster ser criado.

    Resumo da revisão para criar o cluster.

  8. Depois de concluir a implantação, verifique o grupo de recursos para ver o cluster de instância gerenciada recém-criado:

    Página de visão geral após a criação do cluster.

  9. Para procurar os nós de cluster, navegue até o recurso de cluster e abra o painel Data Center para exibi-los:

    Captura de tela dos nós de data center.

Dimensionar um datacenter

  1. Agora que implantou um cluster com apenas um data center, você pode expandir ou reduzir verticalmente os nós, realçando o data center e selecionando o botão Scale:

    Captura de tela da escala dos nós de data center.

  2. Em seguida, mova o controle deslizante para o número desejado ou apenas edite o valor. Quando terminar, clique em Scale.

    Captura de tela da seleção do número de nós de data center.

    Observação

    O período de tempo necessário para que os nós sejam dimensionados depende de vários fatores e pode levar vários minutos. Quando o Azure notifica que a operação de escala foi concluída, isso não significa que todos os nós tenham ingressado no anel do Cassandra. Os nós estarão totalmente prontos quando todos exibirem um status de "íntegro" e o status do datacenter for "bem-sucedido".

Adicionar um datacenter

  1. Para adicionar outro datacenter, clique no botão adicionar no painel do Data Center:

    Captura de tela de como adicionar um data center.

    Aviso

    Se você estiver adicionando um datacenter em outra região, precisará selecionar uma rede virtual diferente. Você também precisará garantir que essa rede virtual tenha conectividade com a rede virtual da região primária criada acima (e quaisquer outras redes virtuais que estejam hospedando datacenters no cluster de instância gerenciada). Acesse este artigo para saber como emparelhar redes virtuais usando portal do Azure. Você também precisa verificar se aplicou a função apropriada à sua rede virtual antes de tentar implantar um cluster de instância gerenciada usando o comando da CLI abaixo.

        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>
    
  2. Preencha os campos apropriados:

    • Nome do datacenter: na lista suspensa, selecione sua assinatura do Azure.
    • Zona de disponibilidade: marque essa caixa de seleção se deseja habilitar as zonas de disponibilidade nesse datacenter.
    • Local: local em que o datacenter será implantado.
    • Tamanho do SKU: escolha entre os tamanhos de SKU de Máquina Virtual disponíveis.
    • Não. de discos – Escolha o número de discos p30 a serem anexados a cada nó do Cassandra.
    • Não. de nós – Escolha o número de nós do Cassandra que serão implantados nesse datacenter.
    • Rede Virtual: selecione um Rede Virtual de saída e uma sub-rede.

    Adicionar data center.

    Aviso

    Observe que não permitimos a criação de uma nova rede virtual ao adicionar um datacenter. Você precisa escolher uma rede virtual existente e, conforme mencionado acima, precisa garantir que haja conectividade entre as sub-redes de destino em que os datacenters serão implantados. Você também precisa aplicar a função apropriada à VNet para permitir a implantação (veja acima).

  3. Quando o datacenter for implantado, você poderá exibir todas as suas informações no painel Data Center:

    Exibir os recursos de cluster.

Atualizar a configuração do Cassandra

O serviço permite atualizar a configuração do Cassandra YAML em um data center por meio do portal ou usando comandos da CLI. Para atualizar as configurações no portal:

  1. Localize Cassandra Configuration nas configurações. Destaque o data center cuja configuração você deseja alterar e clique em atualizar:

    Captura de tela do data center selecionado para atualizar a configuração.

  2. Na janela que será aberta, insira os nomes de campo no formato YAML, conforme mostrado abaixo. Em seguida, clique em Atualizar.

    Captura de tela da atualização da configuração do data center do Cassandra.

  3. Quando a atualização for concluída, os valores substituídos serão mostrados no painel Cassandra Configuration:

    Captura de tela da configuração atualizada do Cassandra.

    Observação

    Somente os valores de configuração do Cassandra substituídos são mostrados no portal.

    Importante

    Verifique se as configurações do Cassandra YAML que você forneceu são apropriadas para a versão implantada do Cassandra. Veja aqui as configurações do Cassandra v3.11 e a versão v4.0 aqui. As configurações do YAML a seguir não têm permissão para serem atualizadas:

    • cluster_name
    • seed_provider
    • initial_token
    • autobootstrap
    • client_ecncryption_options
    • server_encryption_options
    • transparent_data_encryption_options
    • audit_logging_options
    • autenticador
    • autorizador
    • role_manager
    • storage_port
    • ssl_storage_port
    • native_transport_port
    • native_transport_port_ssl
    • listen_address
    • listen_interface
    • broadcast_address
    • hints_directory
    • data_file_directories
    • commitlog_directory
    • cdc_raw_directory
    • saved_caches_directory

Solução de problemas

Se você encontrar um erro ao aplicar permissões à Rede Virtual usando a CLI do Azure, como Não é possível localizar o usuário ou entidade de serviço no banco de dados de grafo para 'e5007d2c-4b13-4a74-9b6a-605d99f03501' , poderá aplicar a mesma permissão manualmente no portal do Azure. Saiba como fazer isso aqui.

Observação

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

Como se conectar ao cluster

A Instância Gerenciada do Azure para o Apache Cassandra não cria nós com endereços IP públicos, portanto, para se conectar ao seu cluster recém-criado do Cassandra, você precisará criar outro recurso dentro da VNet. Esse recurso pode ser um aplicativo ou uma máquina virtual com a ferramenta de consulta open-source CQLSH do Apache instalada. Você pode usar um modelo para implantar uma máquina virtual do Ubuntu. Depois de implantada, use o SSH para se conectar à máquina e instale o CQLSH usando os comandos abaixo:

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

# Install the Cassandra libraries in order to get CQLSH:
echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
curl https://downloads.apache.org/cassandra/KEYS | sudo apt-key add -
sudo apt-get update
sudo apt-get install cassandra

# Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

# Connect to CQLSH (replace <IP> with the private IP addresses of a node in your Datacenter):
host=("<IP>")
initial_admin_password="Password provided when creating the cluster"
cqlsh $host 9042 -u cassandra -p $initial_admin_password --ssl

Limpar os recursos

Caso não vá continuar usando esse cluster da instância gerenciada, exclua-o seguindo estas etapas:

  1. No menu à esquerda do portal do Azure, selecione Grupos de recursos.
  2. Na lista, selecione o grupo de recursos criado neste início rápido.
  3. Na página Visão geral do grupo de recursos, selecione Excluir grupo de recursos.
  4. Na próxima janela, insira o nome do grupo de recursos a ser excluído e selecione Excluir.

Próximas etapas

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