Azure CLI kullanarak Apache Cassandra için Azure Yönetilen Örneği kaynaklarını yönetme

Makale
03/13/2024

Bu makalede, Azure CLI kullanarak Apache Cassandra kümeleri ve veri merkezleri için Azure Yönetilen Örneğinizin yönetimini otomatikleştirmeye yönelik yaygın komutlar açıklanmaktadır.

Önkoşullar

Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.
CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.
- Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.
- İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.
- Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Bu makale, Azure CLI sürüm 2.30.0 veya üzerini gerektirir. Azure Cloud Shell kullanıyorsanız en son sürüm zaten yüklüdür.

Önemli

Apache Cassandra kaynakları için Azure Yönetilen Örneğini Yönet'i yeniden adlandıramazsınız. Bu kaynakların yeniden adlandırılması, Azure Resource Manager'ın kaynak URI'leriyle çalışma biçimini ihlal eder.

Kümeleri yönetme

Aşağıdaki bölümlerde Apache Cassandra kümeleri için Azure Yönetilen Örneği'nin nasıl yönetileceğini gösterilmektedir:

Küme oluşturma
Küme silme
Küme ayrıntılarını alma
Küme düğümü durumunu alma
Kümeleri kaynak grubuna göre listeleme
Abonelik kimliğine göre kümeleri listeleme

Küme oluşturma

az managed-cassandra cluster create komutunu kullanarak Apache Cassandra için Azure Yönetilen Örneği oluşturun :

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 \

Küme silme

az managed-cassandra cluster delete komutunu kullanarak kümeyi silin :

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

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

Küme ayrıntılarını alma

az managed-cassandra cluster show komutunu kullanarak küme ayrıntılarını alın:

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

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

Küme düğümü durumunu alma

az managed-cassandra cluster node-status komutunu kullanarak küme düğümlerinin durumunu alın:

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

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

Kümeleri kaynak grubuna göre listeleme

az managed-cassandra cluster list komutunu kullanarak kümeleri kaynak grubuna göre listeleyin :

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

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

Abonelik kimliğine göre kümeleri listeleme

az managed-cassandra cluster list komutunu kullanarak kümeleri abonelik kimliğine göre listeleyin :

# Set your subscription ID
az account set -s <subscriptionID>

az managed-cassandra cluster list

Veri merkezlerini yönetme

Aşağıdaki bölümlerde Apache Cassandra veri merkezleri için Azure Yönetilen Örneği'nin nasıl yönetileceğini gösterilmektedir:

Veri merkezi oluşturma
Veri merkezini silme
Veri merkezi ayrıntılarını alma
Kümedeki veri merkezlerini alma
Veri merkezini güncelleştirme veya ölçeklendirme
Cassandra yapılandırmasını alma
Cassandra yapılandırmasını güncelleştirme

Veri merkezi oluşturma

az managed-cassandra datacenter create komutunu kullanarak bir veri merkezi oluşturun :

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

Aşağıdaki kullanılabilir sanal makine (VM) seçeneklerinden değerini --sku seçin:

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
Standard_L8s_v3
Standard_L16s_v3
Standard_L32s_v3
Standard_L8as_v3
Standard_L16as_v3
Standard_L32as_v3

Şu anda Apache Cassandra için Azure Yönetilen Örneği, VM aileleri arasında geçişi desteklememektedir. Örneğin, şu anda bir Standard_DS13_v2 VM'niz varsa ve Standard_DS14_v2 gibi daha büyük bir VM'ye yükseltmek istiyorsanız, bu seçenek kullanılamaz. Ancak yükseltme isteğinde bulunmak için bir destek bileti açabilirsiniz.

Önceki komutta olarak --availability-zone ayarlanır false. Kullanılabilirlik alanlarını etkinleştirmek için bu değeri olarak trueayarlayın. Kullanılabilirlik alanları, hizmetin kullanılabilirliği için hizmet düzeyi sözleşmesini (SLA) artırır. Daha fazla bilgi için SLA ayrıntılarının tamamını gözden geçirin.

Uyarı

Apache Cassandra için Azure Yönetilen Örneği tüm bölgelerde kullanılabilirlik alanlarını desteklemez. Kullanılabilirlik alanlarının desteklenmediği bir bölge seçerseniz dağıtımlar başarısız olur. Desteklenen bölgelerin listesine bakın.

Kullanılabilirlik alanlarının başarılı dağıtımı, bir bölgedeki tüm bölgelerdeki işlem kaynaklarının kullanılabilirliğine de tabidir. Vm veya seçtiğiniz kapasite tüm bölgelerde kullanılamıyorsa dağıtımlar başarısız olabilir.

Veri merkezini silme

az managed-cassandra datacenter delete komutunu kullanarak veri merkezini silin :

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

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

Uyarı

Kümenizde birden fazla veri merkezi varsa, önce herhangi bir anahtar alanı çoğaltma stratejisi ayarında silmeye çalıştığınız veri merkezine yönelik başvuruları kaldırmanız gerekir. Kümenizdeki anahtar alanları hala veri merkezine başvuruda bulunursa bu komut başarısız olur.

Veri merkezi ayrıntılarını alma

az managed-cassandra datacenter show komutunu kullanarak veri merkezi ayrıntılarını alın:

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

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

Veri merkezini güncelleştirme veya ölçeklendirme

az managed-cassandra datacenter update komutunu kullanarak veri merkezini güncelleştirin veya ölçeklendirin:

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

Veri merkezini ölçeklendirmek için değeri değiştirin --node-count .

Cassandra yapılandırmasını alma

az managed-cassandra cluster invoke-command komutunu kullanarak düğümün geçerli YAML yapılandırmasını alın:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
commandName='get-cassandra-yaml'
 
az managed-cassandra cluster invoke-command \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --host <ip address> \
    --command-name 'get-cassandra-yaml'

Aşağıdaki komutları kullanarak çıkışı daha okunabilir hale getirebilirsiniz:

$output = az managed-cassandra cluster invoke-command \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --host <ip address> \
    --command-name 'get-cassandra-yaml' \
    | ConvertFrom-Json
$output.commandOutput

Cassandra yapılandırmasını güncelleştirme

az managed-cassandra datacenter update komutunu kullanarak bir veri merkezinde Cassandra yapılandırmasını değiştirin. Çevrimiçi bir araç kullanarak YAML parçasını Base64 ile kodlamanız gerekir.

Örneğin, aşağıdaki YAML parçasını göz önünde bulundurun:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

Kodlandığında YAML şu şekilde dönüştürülür: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA==.

az managed-cassandra datacenter update Kodlanmış YAML parçasının olduğu komut aşağıdadır:

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