Mulai cepat: Mengonfigurasi kluster hibrid dengan Azure Managed Instance for Apache Cassandra menggunakan Client Configurator
Konfigurasi Klien Azure adalah alat yang dirancang untuk membantu Anda mengonfigurasi kluster hibrid dan menyederhanakan proses migrasi ke Azure Managed Instance for Apache Cassandra. Jika saat ini Anda memiliki pusat data lokal atau beroperasi di lingkungan yang dihost sendiri, Anda dapat menggunakan Azure Managed Instance for Apache Cassandra untuk menggabungkan pusat data lain dengan mulus ke dalam kluster Anda sambil mempertahankannya secara efektif.
Penting
Alat Konfigurator Klien ada di pratinjau publik. Fitur ini disediakan tanpa perjanjian tingkat layanan, dan tidak disarankan untuk beban kerja produksi. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.
Prasyarat
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.
Artikel ini memerlukan Azure CLI versi 2.30.0 atau yang lebih tinggi. Jika Anda menggunakan Azure Cloud Shell, versi terbaru sudah terpasang.
Azure Virtual Network dengan konektivitas ke lingkungan yang dihost sendiri atau lokal. Untuk informasi selengkapnya tentang cara menyambungkan lingkungan lokal ke Azure, lihat artikel Menyambungkan jaringan lokal ke Azure tersebut.
Penginstalan Python diperlukan. Anda dapat memeriksa apakah python diinstal dengan menjalankan
python --version
di terminal Anda.Pastikan bahwa kluster Azure Managed Instance dan Cassandra lokal terletak di jaringan virtual yang sama. Jika tidak, perlu untuk membangun peering jaringan atau cara konektivitas lainnya (misalnya, rute ekspres).
Nama kluster untuk kluster Terkelola dan kluster lokal harus sama. * Dalam file cassandra.yaml pastikan port penyimpanan diatur ke 7001 dan nama kluster sama dengan kluster terkelola:
cluster_name: managed_cluster-name
storage_port: 7001
UPDATE system.local SET cluster_name = 'managed_cluster-name' where key='local';
Penginstalan
- Unduh dan navigasikan ke folder konfigurator klien.
- Siapkan lingkungan virtual untuk menjalankan skrip python:
python3 -m venv env
source env/bin/activate
python3 -m pip install -r requirements.txt
- Masuk ke Azure CLI
az login
- Jalankan skrip python dalam folder klien dengan informasi dari kluster (lokal) yang ada:
python3 client_configurator.py --subscription-id <subcriptionId> --cluster-resource-group <clusterResourceGroup> --cluster-name <clusterName> --initial-password <initialPassword> --vnet-resource-group <vnetResourceGroup> --vnet-name <vnetName> --subnet-name <subnetName> --location <location> --seed-nodes <seed1 seed2 seed3> --mi-dc-name <managedInstanceDataCenterName> --dc-name <onPremDataCenterName> --sku <sku>
Catatan
- id langganan: Id langganan Azure.
- cluster-resource-group: Grup sumber daya yang berada kluster Anda.
- nama kluster: Nama kluster Azure Managed Instance.
- kata sandi awal: Kata sandi untuk kluster Azure Managed Instance for Apache Cassandra Anda.
- vnet-resource-group: Grup sumber daya yang dilampirkan ke jaringan virtual.
- vnet-name: Nama jaringan virtual yang terpasang pada kluster Anda.
- subnet-name: Nama IP yang dialokasikan untuk kluster Cassandra.
- location: Tempat kluster Anda disebarkan.
- seed-node: Node seed dari pusat data yang ada di kluster Cassandra lokal atau yang dihost sendiri.
- mi-dc-name: Nama pusat data kluster Azure Managed Instance Anda.
- dc-name: Nama pusat data kluster lokal.
- sku: Ukuran SKU komputer virtual.
Skrip Python menghasilkan arsip tar bernama
install_certs.tar.gz
. * Bongkar folder ini ke dalam/etc/cassandra/
pada setiap simpul.sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra
Di dalam folder, jalankan
/etc/cassandra/
sudo ./install_certs.sh
.- Pastikan bahwa skrip dapat dieksekusi dengan menjalankan
sudo chmod +x install_certs.sh
. - Skrip menginstal dan mengarahkan Cassandra ke sertifikasi baru yang diperlukan untuk terhubung ke kluster Azure Managed Instance.
- Kemudian meminta pengguna untuk menghidupkan ulang Cassandra.
- Pastikan bahwa skrip dapat dieksekusi dengan menjalankan
Setelah Cassandra selesai memulai ulang pada semua simpul, periksa
nodetool status
. Kedua pusat data akan muncul dalam daftar, dengan simpulnya dalam status UN (Naik/Normal).Dari Azure Managed Instance for Apache Cassandra, Anda kemudian dapat memilih
AllKeyspaces
untuk mengubah pengaturan replikasi di skema Keyspace Anda dan memulai proses migrasi ke kluster Cassandra Managed Instance.
Tip
Pengaturan Replikasi Otomatis harus diaktifkan melalui templat arm. Templat arm harus mencakup:
"properties":{
...
"externalDataCenters": ["dc-name-1","dc-name-2"],
"autoReplicate": "AllKeyspaces",
...
}
Peringatan
Ini akan mengubah semua definisi keyspace Anda untuk menyertakan WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }
.
Jika ini bukan topologi yang Anda inginkan, Anda harus menyesuaikannya dan berjalan nodetool rebuild
secara manual pada kluster Instans Terkelola Cassandra.
Pelajari selengkapnya tentang Replikasi Otomatis
[!INFO]
Langkah berikutnya
Dalam mulai cepat ini, Anda mempelajari cara membuat kluster hibrid menggunakan Azure Managed Instance for Apache Cassandra Client Configurator. Anda sekarang dapat mulai bekerja dengan kluster.