Správa spravované instance Azure pro prostředky Apache Cassandra pomocí Azure CLI

Tento článek popisuje běžné příkazy pro automatizaci správy spravované instance Azure pro clustery Apache Cassandra pomocí Azure CLI.

Požadavky

  • V nástroji použijte prostředí Bash Azure Cloud Shell.

    Spuštění služby Cloud Shell v novém okně

  • Pokud tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení jsou popsané v tématu Přihlášení pomocí Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

    • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Důležité

Tento článek vyžaduje Azure CLI verze 2.30.0 nebo novější. Pokud používáte Azure Cloud Shell, nejnovější verze je už nainstalovaná.

Správa spravované instance Azure pro prostředky Apache Cassandra se nedá přejmenovat, protože tato funkce je v rozporu s tím, jak Azure Resource Manager pracuje s identifikátory URI prostředků.

Spravovaná instance Azure pro clustery Apache Cassandra

Následující části demonstrují, jak spravovat spravovanou instanci Azure pro clustery Apache Cassandra, včetně těchto:

Vytvoření clusteru spravované instance

Vytvořte spravovanou instanci Azure pro cluster Apache Cassandra pomocí příkazu 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 \

Odstranění clusteru spravované instance

Odstraňte cluster pomocí příkazu AZ Managed-Cassandra cluster Delete :

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

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

Získat podrobnosti o clusteru

Podrobnosti o clusteru získáte pomocí příkazu AZ Managed-Cassandra cluster show :

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

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

Získat stav uzlu clusteru

Podrobnosti o clusteru získáte pomocí příkazu AZ Managed-Cassandra cluster-stavový příkaz:

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

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

Výpis clusterů podle skupiny prostředků

Seznam clusterů podle skupiny prostředků pomocí příkazu AZ Managed-Cassandra cluster list :

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

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

Vypsat clustery podle ID předplatného

Seznam clusterů podle ID předplatného pomocí příkazu AZ Managed-Cassandra cluster list :

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

az managed-cassandra cluster list

Datová centra spravované instance

Následující části demonstrují, jak spravovat spravovanou instanci Azure pro datacentra Apache Cassandra, včetně těchto:

Vytvoření datového centra

Pomocí příkazu AZ Managed-Cassandra datadatacenter Create vytvořte datacentrum:

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

Poznámka

Hodnotu pro --sku lze zvolit z následujících dostupných SKU:

  • 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

Všimněte si také, že --availability-zone je nastavena na false . Pokud chcete povolit zóny dostupnosti, nastavte tuto možnost na true . Zóny dostupnosti zvyšují smlouvu SLA pro dostupnost služby. Další podrobnosti najdete v podrobnostech o smlouvě SLA zde.

Upozornění

Zóny dostupnosti nejsou podporovány ve všech oblastech. Pokud vyberete oblast, kde se zóny dostupnosti nepodporují, nasazení se nezdaří. Podporované oblasti najdete tady . Úspěšné nasazení zón dostupnosti se vztahuje i na dostupnost výpočetních prostředků ve všech zónách v dané oblasti. Pokud vybraná SKU nebo kapacita není dostupná ve všech zónách, nasazení se nemusí zdařit.

Odstranění datového centra

Pomocí příkazu AZ Managed-Cassandra datacentra odstraňte datový datacentrum:

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

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

Upozornění

Pokud máte ve svém clusteru více datových center, musíte nejdřív odebrat všechny odkazy na datové centrum, které se snažíte odstranit v jakémkoli Nastavení strategie replikace v prostoru klíčů. Tento příkaz selže, pokud stále existují odkazy na datové centrum v jakémkoli prostoru v rámci clusteru.

Získat podrobnosti o datovém centru

Podrobnosti o datovém centru získáte pomocí příkazu 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 

Aktualizace nebo škálování datového centra

Aktualizujte nebo Škálujte datové centrum (Pokud chcete škálovat změnu hodnoty nodeCount) pomocí příkazu 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 

Aktualizovat konfiguraci Cassandra

Pomocí příkazu AZ Managed-Cassandra Datacenter Update změňte konfiguraci Cassandra v datovém centru. Fragment YAML můžete kódovat v kódování Base64 pomocí online nástroje. Podporují se následující nastavení YAML:

  • 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

Například následující fragment YAML:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

Při kódování je YAML převeden na: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA== .

Podívejte se na následující obrázek:

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

Získat datacentra v clusteru

Získejte datacentra v clusteru pomocí příkazu AZ Managed-Cassandra Datacenter list :

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

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

Další kroky