Hantera Azure Managed Instance för Apache Cassandra-resurser med Hjälp av Azure CLI

Artikel
11/23/2021
4 minuter för att läsa

I den här artikeln beskrivs vanliga kommandon för att automatisera hanteringen av azure-hanterade instanser för Apache Cassandra-kluster med Hjälp av Azure CLI.

Förutsättningar

Använd bash-miljön i Azure Cloud Shell.
Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Viktigt

Den här artikeln kräver Azure CLI version 2.30.0 eller senare. Om du använder Azure Cloud Shell är den senaste versionen redan installerad.

Det går inte att byta namn på Hantera Azure Managed Instance för Apache Cassandra-resurser eftersom det strider mot Azure Resource Manager fungerar med resurs-URI:er.

Azure Managed Instance för Apache Cassandra-kluster

Följande avsnitt visar hur du hanterar Azure Managed Instance för Apache Cassandra-kluster, inklusive:

Skapa ett hanterat instanskluster
Ta bort ett hanterat instanskluster
Hämta klusterinformationen
Hämta status för klusternoden
Lista kluster efter resursgrupp
Lista kluster efter prenumerations-ID

Skapa ett hanterat instanskluster

Skapa en Azure Managed Instance för Apache Cassandra-kluster med kommandot 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 \

Ta bort ett hanterat instanskluster

Ta bort ett kluster med kommandot az managed-cassandra cluster delete:

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

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

Hämta klusterinformationen

Hämta klusterinformation med kommandot az managed-cassandra cluster show:

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

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

Hämta status för klusternoden

Hämta klusterinformation med hjälp av kommandot az managed-cassandra cluster node-status:

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

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

Lista klustren efter resursgrupp

Lista kluster efter resursgrupp med hjälp av kommandot az managed-cassandra cluster list:

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

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

Lista kluster efter prenumerations-ID

Lista kluster efter prenumerations-ID med hjälp av kommandot az managed-cassandra cluster list:

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

az managed-cassandra cluster list

Datacenter för hanterade instanser

Följande avsnitt visar hur du hanterar Azure Managed Instance för Apache Cassandra-datacenter, inklusive:

Skapa ett datacenter
Ta bort ett datacenter
Hämta information om datacenter
Hämta datacenter i ett kluster
Uppdatera eller skala ett datacenter
Uppdatera Cassandra-konfigurationen

Skapa ett datacenter

Skapa ett datacenter med kommandot az managed-cassandra datacenter create:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus2'
delegatedSubnetId='/subscriptions/<SubscriptionID>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/dc1-subnet'
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 $delegatedSubnetId \
    --node-count 3 
    --sku $virtualMachineSKU \
    --disk-capacity $noOfDisksPerNode \
    --availability-zone false

Anteckning

Värdet för kan --sku väljas från följande tillgängliga SKU:er:

Standard_E8s_v4
Standard_E16s_v4
Standard_E20s_v4
Standard_E32s_v4
Standard_DS13_v2
Standard_DS14_v2
Standard_D8s_v4
Standard_D16s_v4
Standard_D32s_v4

Observera också att --availability-zone är inställt på false . Om du vill aktivera tillgänglighetszoner anger du detta till true . Tillgänglighetszoner ökar tjänstens tillgänglighets-SLA. Mer information finns i den fullständiga SLA-informationen här.

Varning

Tillgänglighetszoner stöds inte i alla regioner. Distributioner misslyckas om du väljer en region där tillgänglighetszoner inte stöds. Se här för regioner som stöds. En lyckad distribution av tillgänglighetszoner beror också på tillgängligheten av beräkningsresurser i alla zoner i den angivna regionen. Distributioner kan misslyckas om den SKU som du har valt, eller kapaciteten, inte är tillgänglig i alla zoner.

Ta bort ett datacenter

Ta bort ett datacenter med kommandot 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

Varning

Om du har fler än ett datacenter i klustret måste du först ta bort alla referenser till det datacenter som du försöker ta bort i eventuella strategiinställningar för nyckelutrymmesreplikering. Det här kommandot misslyckas om det fortfarande finns referenser till datacentret i alla nyckelutrymmen i klustret.

Hämta information om datacenter

Hämta datacenterinformation med hjälp av kommandot 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

Uppdatera eller skala ett datacenter

Uppdatera eller skala ett datacenter (för att skala om nodeCount-värdet) med hjälp av kommandot az managed-cassandra datacenter update:

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

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

Uppdatera Cassandra-konfigurationen

Ändra Cassandra-konfigurationen på ett datacenter med hjälp av kommandot az managed-cassandra datacenter update. Du måste base64-koda YAML-fragmentet med hjälp av ett onlineverktyg. Följande YAML-inställningar stöds:

column_index_size_in_kb
allocate_tokens_for_keyspace
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
request_timeout_in_ms
internode_compression
batchlog_replay_throttle_in_kb

Till exempel följande YAML-fragment:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

När YAML kodas konverteras den till: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA== .

Se nedan:

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

Hämta datacenter i ett kluster

Hämta datacenter i ett kluster med kommandot az managed-cassandra datacenter list:

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

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