Azure CLI kullanarak Apache Cassandra için Azure Yönetilen Örneği kaynaklarını yönetme
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 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 true
ayarlayı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
Önemli
Sağladığınız Cassandra YAML ayarlarının Cassandra sürümünüz için uygun olduğundan emin olun. Cassandra v3.11 ayarlarına ve Cassandra v4.0 ayarlarına bakın. Aşağıdaki YAML ayarlarını güncelleştirmenize izin verilmiyor:
cluster_name
seed_provider
initial_token
autobootstrap
client_encryption_options
server_encryption_options
transparent_data_encryption_options
audit_logging_options
authenticator
authorizer
role_manager
storage_port
ssl_storage_port
native_transport_port
native_transport_port_ssl
listen_address
listen_interface
broadcast_address
hints_directory
data_file_directories
commitlog_directory
cdc_raw_directory
saved_caches_directory
endpoint_snitch
partitioner
rpc_address
rpc_interface
Kümedeki veri merkezlerini alma
az managed-cassandra datacenter list komutunu kullanarak kümedeki veri merkezlerini alın:
resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
az managed-cassandra datacenter list \
--resource-group $resourceGroupName \
--cluster-name $clusterName