Gestire azure Istanza gestita per le risorse di Apache Cassandra usando l'interfaccia della riga di comando di Azure (anteprima)

Questo articolo descrive i comandi comuni per automatizzare la gestione dei cluster azure Istanza gestita per Apache Cassandra tramite l'interfaccia della riga di comando di Azure.

Importante

Azure Istanza gestita per Apache Cassandra è attualmente in anteprima pubblica. Questa versione di anteprima viene messa a disposizione senza contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere Condizioni supplementari per l'utilizzo delle anteprime di Microsoft Azure.

Prerequisiti

Importante

Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.17.1 o successiva. Se si usa Azure Cloud Shell, la versione più recente è già installata.

Non è Istanza gestita possibile rinominare le risorse di Azure Istanza gestita per Apache Cassandra, in quanto ciò viola il funzionamento Azure Resource Manager con gli URI delle risorse.

Azure Istanza gestita per cluster Apache Cassandra

Le sezioni seguenti illustrano come gestire Azure Istanza gestita per i cluster Apache Cassandra, tra cui:

Creare un cluster di istanza gestita

Creare un cluster Istanza gestita Azure per Apache Cassandra usando il comando az managed-cassandra cluster create:

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 \

Eliminare un cluster di istanza gestita

Eliminare un cluster usando il comando az managed-cassandra cluster delete:

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

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

Ottenere i dettagli del cluster

Ottenere i dettagli del cluster usando il comando az managed-cassandra cluster show:

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

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

Ottenere lo stato del nodo del cluster

Ottenere i dettagli del cluster usando il comando az managed-cassandra cluster node-status:

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

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

Elencare i cluster in base al gruppo di risorse

Elencare i cluster in base al gruppo di risorse usando il comando az managed-cassandra cluster list:

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

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

Elencare i cluster in base all'ID sottoscrizione

Elencare i cluster in base all'ID sottoscrizione usando il comando az managed-cassandra cluster list:

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

az managed-cassandra cluster list

Data center dell'istanza gestita

Le sezioni seguenti illustrano come gestire azure Istanza gestita per data center Apache Cassandra, tra cui:

Creare un data center

Creare un data center usando il comando az managed-cassandra datacenter create:

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 

Eliminare un data center

Eliminare un data center usando il comando az managed-cassandra datacenter delete:

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

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

Ottenere i dettagli del data center

Ottenere i dettagli del data center usando il comando az managed-cassandra datacenter show:

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

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

Aggiornare o ridimensionare un data center

Aggiornare o ridimensionare un data center (per ridimensionare il valore nodeCount) usando il comando az managed-cassandra datacenter update:

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 

Aggiornare la configurazione di Cassandra

Modificare la configurazione di Cassandra in un data center usando il comando az managed-cassandra datacenter update. È necessario codificare in base 64 il frammento YAML usando uno strumento online. Sono supportate le impostazioni YAML seguenti:

  • 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

Ad esempio, il frammento YAML seguente:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

Quando viene codificato, il file YAML viene convertito in: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA== .

Vedere qui di seguito:

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

Ottenere i data center in un cluster

Ottenere i data center in un cluster usando il comando az managed-cassandra datacenter list:

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

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

Passaggi successivi