Hızlı Başlangıç: Azure CLI kullanarak Apache Cassandra kümesi için Azure Yönetilen Örneği oluşturma

Apache Cassandra için Azure Yönetilen Örneği, yönetilen açık kaynak Apache Cassandra veri merkezleri için otomatik dağıtım ve ölçeklendirme işlemleri sağlar. Bu hizmet hibrit senaryoları hızlandırmanıza ve devam eden bakımı azaltmanıza yardımcı olur.

Bu hızlı başlangıçta, Azure CLI komutlarını kullanarak Apache Cassandra için Azure Yönetilen Örneği ile bir küme oluşturma hakkında bilgi edinebilirsiniz. Ayrıca bir veri merkezi oluşturma ve veri merkezi içinde düğümlerin ölçeğini yukarı veya aşağı ölçeklendirme de gösterir.

Önkoşullar

  • Azure Cloud Shell'Da Bash ortamını kullanın.

    Cloud Shell’i yeni bir pencerede başlatma

  • Dilerseniz CLI başvuru komutlarını çalıştırmak için Azure CLI’yi yükleyebilirsiniz.

    • 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. Ek oturum açma seçenekleri için bkz. Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantıları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.

Önemli

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

Yönetilen örnek kümesi oluşturma

  1. Azure portalda oturum açma

  2. Azure CLI'de abonelik kimliğinizi ayarlayın:

    az account set -s <Subscription_ID>
    
  3. Ardından, kaynak grubu içinde ayrılmış bir alt ağa sahip bir Sanal Ağ oluşturun:

    az network vnet create -n <VNet_Name> -l eastus2 -g <Resource_Group_Name> --subnet-name <Subnet Name>
    

    Not

    Apache Cassandra için Azure Yönetilen Örneğinin dağıtımı için İnternet erişimi gerekir. İnternet erişiminin kısıtlanmış olduğu ortamlarda dağıtım başarısız oluyor. Yönetilen Cassandra'nın düzgün çalışması için gerekli olan aşağıdaki önemli Azure hizmetleri için sanal ağ içinde erişimi engellemeyemiyor olun:

    • Azure Storage
    • Azure KeyVault
    • Azure Sanal Makine Ölçek Kümeleri
    • Azure İzleme
    • Azure Active Directory
    • Azure Güvenlik
  4. Yönetilen örnek için gereken Sanal Ağa bazı özel izinler uygulama. , az role assignment create ve değerlerini uygun <subscriptionID> <resourceGroupName> değerlerle <vnetName> değiştirerek komutunu kullanın:

    az role assignment create \
      --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \
      --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \
      --scope /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>
    

    Not

    Önceki assignee role komutta yer alan ve değerleri sabit değerlerdir, bu değerleri komutta tam olarak belirtildiği gibi girin. Bunu yapmama, küme oluşturulurken hatalara neden olur. Bu komutu yürütürken herhangi bir hatayla karşılaşırsanız çalıştırma izinlerine sahip olamayabilirsiniz, lütfen izinler için yöneticinize ulaşabilirsiniz.

  5. Ardından az managed-cassandra cluster create komutunu kullanarak yeni oluşturduğunuz Sanal Ağ'da kümeyi oluşturun. Değişkenin değeri için aşağıdaki komutu delegatedManagementSubnetId çalıştırın:

    Not

    Aşağıda temin delegatedManagementSubnetId edilen değişkenin değeri, yukarıdaki komutta sağlanan --scope değeriyle tam olarak aynıdır:

    resourceGroupName='<Resource_Group_Name>'
    clusterName='<Cluster_Name>'
    location='eastus2'
    delegatedManagementSubnetId='/subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Network/virtualNetworks/<VNet name>/subnets/<subnet name>'
    initialCassandraAdminPassword='myPassword'
    
    az managed-cassandra cluster create \
      --cluster-name $clusterName \
      --resource-group $resourceGroupName \
      --location $location \
      --delegated-management-subnet-id $delegatedManagementSubnetId \
      --initial-cassandra-admin-password $initialCassandraAdminPassword \
      --debug
    
  6. Son olarak, az managed-cassandra datacenter create komutunu kullanarak, her düğüm için 4 P30 disk eklenmiş standart D8s v4 VM SKU'suz üç düğümle küme için bir veri merkezi oluşturun:

    dataCenterName='dc1'
    dataCenterLocation='eastus2'
    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 $delegatedManagementSubnetId \
      --node-count 3 \
      --sku $virtualMachineSKU \
      --disk-capacity $noOfDisksPerNode \
      --availability-zone false
    

    Not

    için --sku değer, aşağıdaki kullanılabilir SKUS'lardan seçilebilir:

    • 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

    ayrıca olarak --availability-zone ayarlanmış olduğunu da false unutmayın. Kullanılabilirlik bölgelerini etkinleştirmek için bunu olarak true ayarlayın. Kullanılabilirlik alanları, hizmetin kullanılabilirlik SLA'sı artar. Diğer ayrıntılar için buradaki SLA ayrıntılarının tamamını gözden geçirebilirsiniz.

    Uyarı

    Kullanılabilirlik alanları tüm bölgelerde desteklenmiyor. Kullanılabilirlik alanları'nın destekçisi olmadığını bir bölgeyi seçmeniz dağıtımlar başarısız olur. Desteklenen bölgeler için buraya bakın. Kullanılabilirlik alanlarının başarılı dağıtımı, verilen bölgedeki tüm bölgelerde işlem kaynaklarının kullanılabilirlik durumuna da tabidir. Seçtiğiniz SKU veya kapasite tüm bölgelerde kullanılamıyorsa dağıtımlar başarısız olabilir.

  7. Veri merkezi oluşturulduktan sonra, veri merkezinde düğümlerin ölçeğini veya ölçeğini ölçeklendirmek için az managed-cassandra datacenter update komutunu çalıştırın. Parametrenin değerini node-count istenen değerle değiştirme:

    resourceGroupName='<Resource_Group_Name>'
    clusterName='<Cluster Name>'
    dataCenterName='dc1'
    dataCenterLocation='eastus2'
    
    az managed-cassandra datacenter update \
      --resource-group $resourceGroupName \
      --cluster-name $clusterName \
      --data-center-name $dataCenterName \
      --node-count 9 
    

Bağlan kümenize

Apache Cassandra için Azure Yönetilen Örneği, genel IP adreslerine sahip düğümler oluşturmaz. Yeni oluşturduğunuz Cassandra kümesine bağlanmak için sanal ağın içinde başka bir kaynak oluşturmanız gerekir. Bu kaynak bir uygulama veya Apache'nın açık kaynak sorgu aracı CQLSH'nin yüklü olduğu bir sanal makine olabilir. Ubuntu sanal makinesi Resource Manager bir şablon kullanabilirsiniz. Dağıtıldıktan sonra, makineye bağlanmak için SSH kullanın ve aşağıdaki komutlarda gösterildiği gibi CQLSH'yi yükleyin:

# Install default-jre and default-jdk
sudo apt update
sudo apt install openjdk-8-jdk openjdk-8-jre

# Install the Cassandra libraries in order to get CQLSH:
echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
curl https://downloads.apache.org/cassandra/KEYS | sudo apt-key add -
sudo apt-get update
sudo apt-get install cassandra

# Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

# Connect to CQLSH (replace <IP> with the private IP addresses of the nodes in your Datacenter):
host=("<IP>" "<IP>" "<IP>")
cqlsh $host 9042 -u cassandra -p cassandra --ssl

Sorun giderme

Azure CLI kullanarak Sanal Ağınıza izinler uygularken 'e5007d2c-4b13-4a74-9b6a-605d99f03501' için graf veritabanında kullanıcı veya hizmet sorumlusu bulunamaz gibi bir hatayla karşılaşırsanız, aynı izni Azure portal'den el ile uygulayabilirsiniz. Bunu burada yapmayı öğrenin.

Not

Azure Cosmos DB rol ataması yalnızca dağıtım amacıyla kullanılır. Apache Cassandra için Azure Yönetilen Örneği'nin Azure Cosmos DB üzerinde arka uç bağımlılığı yoktur.

Kaynakları temizleme

Artık gerekli değilken komutunu kullanarak kaynak grubunu, yönetilen örneği az group delete ve tüm ilgili kaynakları kaldırabilirsiniz:

az group delete --name <Resource_Group_Name>

Sonraki adımlar

Bu hızlı başlangıçta, Azure CLI kullanarak Apache Cassandra için Azure Yönetilen Örneği oluşturma hakkında bilgi edindiniz. Artık kümeyle çalışmaya başlayabilirsiniz: