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.
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
- Odstranění clusteru spravované instance
- Získat podrobnosti o clusteru
- Získat stav uzlu clusteru
- Vypíše clustery podle skupiny prostředků.
- Vypsat clustery podle ID předplatného
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
- Odstranění datového centra
- Získat podrobnosti o datovém centru
- Získat datacentra v clusteru
- Aktualizace nebo škálování datového centra
- Aktualizovat konfiguraci Cassandra
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
