Hızlı Başlangıç: Azure portalından Apache Cassandra için Azure Yönetilen Örneği oluşturma

Makale
11/15/2023

Apache Cassandra için Azure Yönetilen Örneği, saf açık kaynak Apache Cassandra kümeleri için tam olarak yönetilen bir hizmettir. Hizmet ayrıca her iş yükünün belirli gereksinimlerine bağlı olarak yapılandırmaların geçersiz kılınmasına olanak tanıyarak gerektiğinde maksimum esneklik ve denetim sağlar

Bu hızlı başlangıçta, Apache Cassandra kümesi için Azure Yönetilen Örneği oluşturmak üzere Azure portalının nasıl kullanılacağı gösterilmektedir.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Yönetilen örnek kümesi oluşturma

Azure Portal’ında oturum açın.
Arama çubuğunda Apache Cassandra için Yönetilen Örnek'i arayın ve sonucu seçin.
Apache Cassandra kümesi için Yönetilen Örnek Oluştur düğmesini seçin.
Apache Cassandra için Yönetilen Örnek Oluştur bölmesinde aşağıdaki ayrıntıları girin:
- Abonelik - Açılan listeden Azure aboneliğinizi seçin.
- Kaynak Grubu- Yeni bir kaynak grubu oluşturmak mı yoksa var olan bir kaynak grubunu kullanmak mı istediğinizi belirtin. Kaynak grubu, bir Azure çözümü için ilgili kaynakları bir arada tutan kapsayıcıdır. Daha fazla bilgi için Bkz . Azure Kaynak Grubuna genel bakış makalesi.
- Küme adı - Kümeniz için bir ad girin.
- Konum - Kümenizin dağıtılacağı konum.
- Cassandra sürümü - Dağıtılacak Apache Cassandra sürümü.
- Uzantı - Cassandra Lucene Dizini de dahil olmak üzere eklenecek uzantılar.
- İlk Cassandra yönetici parolası - Kümeyi oluşturmak için kullanılan parola.
- Cassandra yönetici parolasını onaylayın - Parolanızı yeniden girin.
- Sanal Ağ - Bir Çıkış Sanal Ağ ve Alt Ağ seçin veya yeni bir tane oluşturun.
- Rol atama - Sanal Ağ yönetilen Cassandra kümelerinin dağıtılması için özel izinler gerekir. Yeni bir Sanal Ağ oluşturuyorsanız veya izinler uygulanmadan var olan bir Sanal Ağ kullanıyorsanız bu kutuyu işaretli tutun. Azure SQL Yönetilen Örneği Cassandra kümelerini zaten dağıtmış olduğunuz bir Sanal ağ kullanıyorsanız bu seçeneğin işaretini kaldırın.
İpucu

VPN kullanıyorsanız başka bir bağlantı açmanız gerekmez.
Not

Apache Cassandra için Azure Yönetilen Örneği dağıtımı için İnternet erişimi gerekir. İnternet erişiminin kısıtlandığı ortamlarda dağıtım başarısız olur. Yönetilen Cassandra'nın düzgün çalışması için gerekli olan aşağıdaki önemli Azure hizmetlerine sanal ağınızdaki erişimi engellemediğinizden emin olun. Daha ayrıntılı bilgi için bkz . Gerekli giden ağ kuralları .
- Azure Storage
- Azure KeyVault
- Azure Sanal Makine Ölçek Kümeleri
- Azure İzleme
- Microsoft Entra Kimlik
- Azure Güvenlik
- Otomatik Çoğaltma - Kullanılacak otomatik çoğaltma biçimini seçin. Daha fazla bilgi edinin
- Zamanlama Olay Stratejisi - Küme tarafından zamanlanmış olaylar için kullanılacak strateji.
İpucu
- StopANY, düğüm için bile zamanlanmış bir düğüm olduğunda herhangi bir düğümü durdurma anlamına gelir.
- StopByRack, belirli bir Zamanlanmış Olay için belirli bir raftaki yalnızca durdurma düğümü anlamına gelir. Örneğin, farklı raflardaki düğümler için aynı anda iki veya daha fazla olay zamanlanırsa, yalnızca bir raftaki düğümler durdurulurken diğer raflardaki diğer düğümler gecikir.
Ardından Veri merkezi sekmesini seçin.
Aşağıdakileri ayrıntıları girin:
- Veri merkezi adı - Metin alanına bir veri merkezi adı yazın.
- Kullanılabilirlik alanı - Kullanılabilirlik alanlarının etkinleştirilmesini istiyorsanız bu kutuyu işaretleyin.
- SKU Boyutu - Kullanılabilir Sanal Makine SKU boyutları arasından seçim yapın.
Not

L serisi VM SKU'larının kullanımı aracılığıyla yazma yoluyla önbelleğe alma (Genel Önizleme) özelliğini kullanıma sunduk. Bu uygulama, özellikle yoğun okuma gerektiren iş yükleri için kuyruk gecikme sürelerini en aza indirmeyi ve okuma performansını artırmayı amaçlar. Bu belirli SKU'lar yerel olarak takılı disklerle donatılmıştır ve okuma işlemleri için çok daha fazla IOPS ve kuyruk gecikme süresini azaltır.

Önemli

Yazma önbelleği genel önizleme aşamasındadır. Bu özellik bir hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri Ek Kullanım Koşulları.
- Hayır disklerin sayısı - Her Cassandra düğümüne eklenecek p30 disk sayısını seçin.
- Hayır sayısı - Bu veri merkezine dağıtılacak Cassandra düğümlerinin sayısını seçin.
Uyarı

Kullanılabilirlik alanları tüm bölgelerde desteklenmez. Kullanılabilirlik alanlarının desteklenmediği bir bölge seçerseniz 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ı, belirtilen bölgedeki tüm bölgelerdeki işlem kaynaklarının kullanılabilirliğine de tabidir. Seçtiğiniz SKU veya kapasite tüm bölgelerde kullanılamıyorsa dağıtımlar başarısız olabilir.
Ardından Gözden Geçir ve Oluştur'u>seçin

Not

Kümenin oluşturulması 15 dakika kadar sürebilir.
Dağıtım tamamlandıktan sonra yeni oluşturulan yönetilen örnek kümesini görmek için kaynak grubunuzu denetleyin:
Küme düğümlerine göz atmak için küme kaynağına gidin ve bunları görüntülemek için Veri Merkezi bölmesini açın:

Veri merkezini ölçeklendirme

Tek bir veri merkeziyle bir küme dağıttığınız için, veri merkezini vurgulayıp düğmeyi Scale seçerek yatay veya dikey olarak ölçeklendirin:

Yatay ölçeklendirme

Düğümlerin ölçeğini genişletmek için kaydırıcıyı istediğiniz sayıya taşıyın veya yalnızca değeri düzenleyin. İşiniz bittiğinde öğesine tıklayın Scale.

Dikey ölçek

Düğümlerinizin ölçeğini daha güçlü bir SKU boyutuna genişletmek için açılan listeden Sku Size öğesini seçin. İşiniz bittiğinde öğesine tıklayın Scale.

Not

Ölçeklendirme işlemi için gereken süre çeşitli faktörlere bağlıdır ve bu işlem birkaç dakika sürebilir. Azure ölçeklendirme işleminin tamamlandığını size bildirirse bu, tüm düğümlerinizin Cassandra kademesine katıldığı anlamına gelmez. Düğümlerin tümü "iyi durumda" durumu görüntülendiğinde ve veri merkezi durumu "başarılı" olarak gösterildiğinde tam olarak devreye alınır.

Veri merkezi ekleme

Başka bir veri merkezi eklemek için Veri Merkezi bölmesindeki ekle düğmesine tıklayın:
Uyarı

Farklı bir bölgeye veri merkezi ekliyorsanız farklı bir sanal ağ seçmeniz gerekir. Ayrıca, bu sanal ağın yukarıda oluşturulan birincil bölgenin sanal ağına (ve yönetilen örnek kümesinde veri merkezleri barındıran diğer tüm sanal ağlara) bağlandığından da emin olmanız gerekir. Azure portalını kullanarak sanal ağları eşlemeyi öğrenmek için bu makaleye göz atın. Ayrıca, aşağıdaki CLI komutunu kullanarak yönetilen örnek kümesi dağıtmayı denemeden önce sanal ağınıza uygun rolü uyguladığınızdan emin olmanız gerekir.
```
    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>
```
Uygun alanları doldurun:
- Veri merkezi adı - Açılan listeden Azure aboneliğinizi seçin.
- Kullanılabilirlik alanı - Bu veri merkezinde kullanılabilirlik alanlarının etkinleştirilmesini istiyorsanız bu kutuyu işaretleyin.
- Konum - Veri merkezinizin dağıtılacağı konum.
- SKU Boyutu - Kullanılabilir Sanal Makine SKU boyutları arasından seçim yapın.
- Hayır disklerin sayısı - Her Cassandra düğümüne eklenecek p30 disk sayısını seçin.
- Hayır sayısı - Bu veri merkezine dağıtılacak Cassandra düğümlerinin sayısını seçin.
- Sanal Ağ - Çıkış Sanal Ağ ve Alt Ağ'ı seçin.
Uyarı

Veri merkezi eklerken yeni bir sanal ağ oluşturulmasına izin vermediğimize dikkat edin. Mevcut bir sanal ağı seçmeniz gerekir ve yukarıda belirtildiği gibi, veri merkezlerinin dağıtılacağı hedef alt ağlar arasında bağlantı olduğundan emin olmanız gerekir. Dağıtıma izin vermek için sanal ağa uygun rolü de uygulamanız gerekir (yukarıya bakın).
Veri merkezi dağıtıldığında, Veri Merkezi bölmesindeki tüm veri merkezi bilgilerini görüntüleyebilmeniz gerekir:
Veri merkezleri arasında çoğaltmayı sağlamak için cqlsh'ye bağlanın ve her anahtar alanında çoğaltma stratejisini küme genelindeki tüm veri merkezlerini içerecek şekilde güncelleştirmek için aşağıdaki CQL sorgusunu kullanın (sistem tabloları otomatik olarak güncelleştirilir):
```
ALTER KEYSPACE "ks" WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'dc': 3, 'dc2': 3};
```
Zaten veri bulunan bir kümeye veri merkezi ekliyorsanız, geçmiş verileri çoğaltmak için komutunu çalıştırmanız rebuild gerekir. Azure CLI'da, yeni veri merkezinin her düğümünde yürütmek nodetool rebuild için aşağıdaki komutu çalıştırın; öğesini düğümün IP adresiyle ve <olddc> mevcut veri merkezinizin adıyla değiştirin<new dc ip address>:
```
 az managed-cassandra cluster invoke-command \
   --resource-group $resourceGroupName \
   --cluster-name $clusterName \
   --host <new dc ip address> \
   --command-name nodetool --arguments rebuild="" "<olddc>"=""
```
Uyarı

Anahtar alanı çoğaltma değişiklikleri uygulanana kadar uygulama istemcilerinin yeni veri merkezine yazmasına izin vermemelisiniz. Aksi takdirde yeniden derleme çalışmaz ve ekibimizin sizin yerinize çalışabilmesi için bir destek isteği oluşturmanız repair gerekir.

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

Hizmet, portal aracılığıyla veya CLI komutlarını kullanarak bir veri merkezinde Cassandra YAML yapılandırmasının güncelleştirilmesini sağlar. Portalda ayarları güncelleştirmek için:

Ayarlar'ın altında bulun Cassandra Configuration . Yapılandırmasını değiştirmek istediğiniz veri merkezini vurgulayın ve Güncelleştir'e tıklayın:
Açılan pencerede, alan adlarını aşağıda gösterildiği gibi YAML biçiminde girin. Ardından Güncelleştir'e tıklayın.
Güncelleştirme tamamlandığında geçersiz kılınan değerler bölmede Cassandra Configuration gösterilir:

Not

Portalda yalnızca geçersiz kılınan Cassandra yapılandırma değerleri gösterilir.
Önemli

Sağladığınız Cassandra yaml ayarlarının dağıtmış olduğunuz Cassandra sürümü için uygun olduğundan emin olun. Cassandra v3.11 ayarları için buraya ve v4.0 için buraya bakın. Aşağıdaki YAML ayarlarının güncelleştirilmesi yasaktır:
- cluster_name
- seed_provider
- initial_token
- autobootstrap
- client_encryption_options
- server_encryption_options
- transparent_data_encryption_options
- audit_logging_options
- Doğrulayıcı
- 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

Cassandra sürümünü güncelleştirme

Önemli

Cassandra 4.1, 5.0 ve Anahtar Teslimi Sürüm Güncelleştirmeler genel önizleme aşamasındadır. Bu özellikler hizmet düzeyi sözleşmesi olmadan sağlanır ve üretim iş yükleri için önerilmez. Daha fazla bilgi için bkz. Microsoft Azure Önizlemeleri Ek Kullanım Koşulları.

Doğrudan portaldan veya Az CLI, Terraform veya ARM şablonları aracılığıyla yerinde ana sürüm yükseltmeleri gerçekleştirme seçeneğiniz vardır.

Update Genel Bakış sekmesinden paneli bulma
Açılan listeden Cassandra sürümünü seçin.

Uyarı

Sürümleri atlamayın. Yalnızca bir sürümden başka bir örnek 3.11'den 4.0'a, 4.0'dan 4.1'e güncelleştirmenizi öneririz.
Kaydetmek için güncelleştirmede seçeneğini belirleyin.

Anahtar teslimi çoğaltma

Cassandra 5.0, çok bölgeli kümeleri dağıtmaya yönelik kolaylaştırılmış bir yaklaşım sunar ve gelişmiş kolaylık ve verimlilik sunar. Anahtar teslimi çoğaltma işlevini kullanarak, çok bölgeli kümelerin ayarlanması ve yönetilmesi daha erişilebilir hale geldi ve dağıtılmış ortamlarda daha sorunsuz tümleştirme ve işlem olanağı sağlıyor. Bu güncelleştirme, geleneksel olarak çok bölgeli yapılandırmaları dağıtma ve koruma ile ilişkili karmaşıklıkları önemli ölçüde azaltarak kullanıcıların Cassandra'nın özelliklerini daha kolay ve etkili bir şekilde kullanmasına olanak tanır.

İpucu

Hiçbiri: Otomatik çoğaltma yok olarak ayarlanır.
SystemKeyspaces: Tüm sistem anahtar boşluklarını otomatik olarak çoğaltma (system_auth, system_traces, system_auth)
AllKeyspaces: Tüm anahtar boşluklarını otomatik olarak çoğaltın ve yeni anahtar alanları oluşturulup oluşturulmayacağını izleyin ve ardından otomatik çoğaltma ayarlarını otomatik olarak uygulayın.

Otomatik çoğaltma senaryoları

Yeni bir veri merkezi eklerken Cassandra'daki otomatik çoğaltma özelliği, eklenen veri merkezinde verilerin başarılı bir şekilde çoğaltılmasını sağlamak için sorunsuz bir şekilde yürütülür nodetool rebuild .
Veri merkezinin kaldırılması, belirli veri merkezinin anahtar boşluklarından otomatik olarak kaldırılmasını tetikler.

Şirket içinde barındırılanlar gibi dış veri merkezleri için, dış veri merkezi özelliğinin kullanımı aracılığıyla anahtar alanlara eklenebilirler. Bu, Cassandra'nın bu dış veri merkezlerini yeniden oluşturma işlemi için kaynak olarak birleştirmesini sağlar.

Uyarı

Otomatik çoğaltmayı AllKeyspaces olarak ayarlamak, anahtar alanları çoğaltmanızı içerecek şekilde değiştirir WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 } İstediğiniz topoloji bu değilse SystemKeyspaces'i kullanmanız, bunları kendiniz ayarlamanız ve Apache Cassandra için Azure Yönetilen Örneği kümesinde el ile çalıştırmanız nodetool rebuild gerekir.

Küme ayırmayı kaldırma

Üretim dışı ortamlarda, bunlar için ücret tahsil edilmemesi için kümedeki kaynakları duraklatabilir/ayırabilirsiniz (depolama için ücretlendirilmeye devam edebilirsiniz). Önce küme türünü olarak NonProduction, ardından deallocateolarak değiştirin.

Uyarı

Ayırma sırasında herhangi bir şema veya yazma işlemi yürütmeyin. Bu, veri kaybına ve nadir durumlarda destek ekibinden el ile müdahale gerektiren şema bozulmasına yol açabilir.

Sorun giderme

Azure CLI kullanarak Sanal Ağ izin uygularken 'e5007d2c-4b13-4a74-9b6a-605d99f03501' için graf veritabanında kullanıcı veya hizmet sorumlusu bulunamıyor gibi bir hatayla karşılaşırsanız, Aynı izni Azure portalından el ile uygulayabilirsiniz. Bunun nasıl yapıldığını burada öğ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'de arka uç bağımlılığı yoktur.

Kümenize Bağlan

Apache Cassandra için Azure Yönetilen Örneği genel IP adreslerine sahip düğümler oluşturmaz, bu nedenle yeni oluşturduğunuz Cassandra kümenize bağlanmak için sanal ağ içinde başka bir kaynak oluşturmanız gerekir. Bu bir uygulama veya Apache'nin açık kaynak sorgu aracı CQLSH yüklü bir Sanal Makine olabilir. Ubuntu Sanal Makinesi dağıtmak için şablon kullanabilirsiniz.

CQLSH'den Bağlan

Sanal makine dağıtıldıktan sonra makineye bağlanmak için SSH kullanın ve aşağıdaki komutları kullanarak 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://archive.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 a node in your Datacenter):
host=("<IP>")
initial_admin_password="Password provided when creating the cluster"
cqlsh $host 9042 -u cassandra -p $initial_admin_password --ssl

Bir uygulamadan Bağlan

CQLSH'de olduğu gibi, desteklenen Apache Cassandra istemci sürücülerinden birini kullanarak bir uygulamadan bağlanmak için SSL şifrelemesinin etkinleştirilmesi ve sertifika doğrulamasının devre dışı bırakılması gerekir. Java, .NET , Node.js ve Python kullanarak Apache Cassandra için Azure Yönetilen Örneği'ne bağlanma örneklerine bakın.

Küme düğümlerinizin I.P adreslerini uygun etki alanıyla eşlemediğiniz sürece sertifika doğrulaması çalışmayacağından sertifika doğrulamayı devre dışı bırakmanız önerilir. Herhangi bir uygulama için SSL sertifika doğrulaması yapmanızı zorunlu kılan bir iç ilkeniz varsa, her düğüm için konak dosyanızda gibi 10.0.1.5 host1.managedcassandra.cosmos.azure.com girdiler ekleyerek bunu kolaylaştırabilirsiniz. Bu yaklaşımı benimsediğinizde, düğümleri her ölçeklendirdiğinizde yeni girdiler eklemeniz de gerekir.

Java için, uygulamaların kuyruk gecikmesine duyarlı olduğu kurgusal yürütme ilkesini etkinleştirmenizi kesinlikle öneririz. Bunun nasıl çalıştığını ve ilkeyi nasıl etkinleştirebileceğinizi gösteren bir tanıtımı burada bulabilirsiniz.

Not

Çoğu durumda Apache Cassandra için Azure Yönetilen Örneği'ne bağlanmak için sertifikaların (rootCA, düğüm veya istemci, güven depoları vb.) yapılandırılması veya yüklenmesi gerekli olmamalıdır. SSL şifrelemesi, istemci tarafından kullanılan çalışma zamanının varsayılan güven deposu ve parolası kullanılarak etkinleştirilebilir (bkz . Java, .NET, Node.js ve Python örnekleri), çünkü Apache Cassandra sertifikaları için Azure Yönetilen Örneği bu ortam tarafından güvenilir olacaktır. Nadir durumlarda, sertifikaya güvenilmiyorsa, sertifikayı güven deposuna eklemeniz gerekebilir.

İstemci sertifikalarını yapılandırma (isteğe bağlı)

İstemci sertifikalarının yapılandırılması isteğe bağlıdır. Yukarıdaki adımlar uygulandığı sürece bir istemci uygulaması Apache Cassandra için Azure Yönetilen Örneği'ne bağlanabilir. Ancak tercih ederseniz, ayrıca kimlik doğrulaması için istemci sertifikaları oluşturabilir ve yapılandırabilirsiniz. Genel olarak, sertifika oluşturmanın iki yolu vardır:

Otomatik olarak imzalanan sertifikalar. Bu, her düğüm için özel ve genel (CA olmayan) bir sertifika anlamına gelir. Bu durumda tüm genel sertifikalara ihtiyacımız vardır.
Sertifika yetkilisi tarafından imzalanan sertifikalar. Bu otomatik olarak imzalanan bir CA, hatta genel bir CA olabilir. Bu durumda kök CA sertifikasına (SSL sertifikalarını üretim için hazırlama yönergelerine bakın) ve tüm aracılara (varsa) ihtiyacımız vardır.

İstemciden düğüme sertifika kimlik doğrulamasını veya karşılıklı Aktarım Katmanı Güvenliği'ni (mTLS) uygulamak istiyorsanız, sertifikaları Azure CLI aracılığıyla sağlamanız gerekir. Aşağıdaki komut, istemci sertifikalarınızı Cassandra Yönetilen Örnek kümeniz için güven deposuna yükler ve uygular (ayarları düzenlemeniz cassandra.yaml gerekmez). Uygulandıktan sonra, kümeniz bir istemci bağlandığında cassandra'nın sertifikaları doğrulamasını gerektirir (bkz require_client_auth: true . Cassandra client_encryption_options).

resourceGroupName='<Resource_Group_Name>'
clusterName='<Cluster Name>'

az managed-cassandra cluster update \
  --resource-group $resourceGroupName \
  --cluster-name $clusterName \
  --client-certificates /usr/csuser/clouddrive/rootCert.pem /usr/csuser/clouddrive/intermediateCert.pem

Kaynakları temizleme

Bu yönetilen örnek kümesini kullanmaya devam etmeyecekseniz, aşağıdaki adımları izleyerek silin:

Azure portalının sol tarafındaki menüden Kaynak grupları'nı seçin.
Listeden bu hızlı başlangıç için oluşturduğunuz kaynak grubunu seçin.
Kaynak grubuna Genel Bakış bölmesinde Kaynak grubunu sil'i seçin.
Sonraki pencerede, silinecek kaynak grubunun adını girin ve sil'i seçin.

Sonraki adımlar

Bu hızlı başlangıçta, Azure portalını kullanarak Apache Cassandra için Azure Yönetilen Örneği oluşturmayı öğrendiniz. Artık kümeyle çalışmaya başlayabilirsiniz:

Azure Databricks ile Yönetilen Apache Spark Kümesi Dağıtma