Gerir a exemplo gerida do Azure para os recursos de Apache Cassandra utilizando o Azure CLI (Preview)

Este artigo descreve comandos comuns para automatizar a gestão do seu Azure Managed Instance para aglomerados Apache Cassandra usando Azure CLI.

Importante

Azure Managed Instance for Apache Cassandra está atualmente em pré-visualização pública. Esta versão de pré-visualização é disponibiliza sem um contrato de nível de serviço e não é recomendada para cargas de trabalho de produção. Algumas funcionalidades poderão não ser suportadas ou poderão ter capacidades limitadas. Para obter mais informações, veja Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure.

Pré-requisitos

  • Utilize o ambiente Bash em Azure Cloud Shell.

    Iniciar Cloud Shell numa nova janela

  • Se preferir, instale o CLI do Azure para executar comandos de referência de CLI.

    • 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 obter mais opções de início de sessão, veja Iniciar sessão com o CLI do Azure.

    • Quando lhe for pedido, instale as extensões do CLI do Azure durante a 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.

Importante

Este artigo requer a versão Azure CLI 2.17.1 ou superior. Se estiver a utilizar o Azure Cloud Shell, a versão mais recente já está instalada.

Gerir a Azure Managed Instance para os recursos da Apache Cassandra não pode ser renomeado, uma vez que isto viola a forma como o Azure Resource Manager funciona com URIs de recursos.

Azure Managed Instance para aglomerados Apache Cassandra

As seguintes secções demonstram como gerir a instância gerida do Azure para os agrupamentos Apache Cassandra, incluindo:

Criar um cluster de instâncias gerido

Crie um Azure Managed Instance para o aglomerado Apache Cassandra utilizando o cluster az gerido-cassandra criar comando:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
location='West US'
delegatedManagementSubnetId='/subscriptions/<subscription id>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/management'
initialCassandraAdminPassword='myPassword'

# You can override the cluster name if the original name is not legal for an Azure resource.
# overrideClusterName='ClusterNameIllegalForAzureResource'
# the default Cassandra version is v3.11

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

Eliminar um cluster de instâncias gerido

Eliminar um cluster utilizando o comando de eliminação do agrupamento az gerido-cassandra:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

az managed-cassandra cluster delete \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName

Obtenha os detalhes do cluster

Obtenha detalhes do cluster utilizando o comando de show de cluster az gerido-cassandra:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

az managed-cassandra cluster show \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName

Obtenha o estado do nó de cluster

Obtenha detalhes do cluster utilizando o comando de nó de nó de aglomerado gerido az:

clusterName='cassandra-hybrid-cluster'
resourceGroupName='MyResourceGroup'

az managed-cassandra cluster node-status \
    --cluster-name $clusterName \
    --resource-group $resourceGroupName

Listar os clusters por grupo de recursos

Listar os clusters por grupo de recursos utilizando o comando da lista de agrupamentos az gerido-cassandra:

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

az managed-cassandra cluster list\
    --resource-group $resourceGroupName

List clusters por ID de subscrição

Listar os clusters por ID por assinatura utilizando o comando da lista de agrupamentos az gerido-cassandra:

# set your subscription id
az account set -s <subscription id>

az managed-cassandra cluster list

Os datacenters de instância geridos

As seguintes secções demonstram como gerir a exemplo gerida do Azure para os centros de dados Apache Cassandra, incluindo:

Criar um datacenter

Crie um datacenter utilizando o datacenter gerido az-cassandra criar comando:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus2'
delegatedSubnetId='/subscriptions/<Subscription_ID>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/dc1-subnet'

az managed-cassandra datacenter create \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --data-center-location $dataCenterLocation \
    --delegated-subnet-id $delegatedSubnetId \
    --node-count 3 

Eliminar um datacenter

Eliminar um datacenter utilizando o comando de eliminação de datacenter gerido az-cassandra:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter delete \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName 

Obtenha detalhes do datacenter

Obtenha detalhes do datacenter utilizando o comando do datacenter gerido az:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter show \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName 

Atualizar ou escalar um datacenter

Atualizar ou escalar um datacenter (para escalar o valor do nodeCount) utilizando o comando de atualização do datacenter gerido az:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus'

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

Atualizar a configuração de Cassandra

Altere a configuração de Cassandra num datacenter utilizando o comando de atualização do datacenter gerido az. Terá de codificar o fragmento YAML com uma ferramenta online. As seguintes definições DE YAML são suportadas:

  • column_index_size_in_kb
  • compaction_throughput_mb_per_sec
  • read_request_timeout_in_ms
  • range_request_timeout_in_ms
  • aggregated_request_timeout_in_ms
  • write_request_timeout_in_ms
  • internode_compression
  • batchlog_replay_throttle_in_kb

Por exemplo, o seguinte fragmento YAML:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

Quando codificado, o YAML é convertido para: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA== .

Veja abaixo.

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus'
yamlFragment='Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA=='

az managed-cassandra datacenter update \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --base64-encoded-cassandra-yaml-fragment $yamlFragment

Obtenha os datacenters em um cluster

Obtenha centros de dados num cluster utilizando o comando da lista de datacenter gerido az:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

az managed-cassandra datacenter list \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName

Passos seguintes