Mulai Cepat: Buat Instans Terkelola Azure untuk kluster Apache Cassandra dari portal Azure

Azure Managed Instance for Apache Cassandra adalah layanan terkelola penuh untuk kluster Apache Cassandra sumber terbuka murni. Layanan ini juga memungkinkan konfigurasi untuk diubah, tergantung pada kebutuhan spesifik setiap beban kerja, yang memungkinkan fleksibilitas dan kontrol maksimum di mana diperlukan.

Panduan mulai cepat ini menunjukkan cara menggunakan portal Microsoft Azure untuk membuat Azure Managed Instance untuk cluster Apache Cassandra.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Membuat kluster instans terkelola

1. Masuk ke portal Azure.

2. Dari bilah penelusuran, carilah Instance yang Terkelola untuk Apache Cassandra dan pilih hasilnya.

   

3. Pilih Buat Instans Terkelola untuk kluster Apache Cassandra.

   

4. Dari panel Buatlah Managed Instance for Apache Cassandra, masukkan detail yang berikut:

   • Langganan - Dari menu dropdown, pilih langganan Azure Anda.
   • Grup sumber daya- Tentukan apakah Anda ingin membuat grup sumber daya baru atau menggunakan grup sumber daya yang ada. Grup sumber daya adalah kontainer yang menampung sumber daya terkait untuk solusi Azure.
   • Nama Klaster - Masukkan nama untuk Klaster.
   • Lokasi - Lokasi untuk menyebarkan kluster.
   • Versi Cassandra - Versi Apache Cassandra untuk disebarkan.
   • Extention - Ekstensi untuk ditambahkan, termasuk Cassandra Lucene Index.
   • Kata sandi admin Awal Cassandra - Kata sandi yang digunakan untuk membuat Klaster.
   • Konfirmasi kata sandi admin Cassandra - Masukkan kembali kata sandi Anda.
   • Virtual Network - Pilih jaringan virtual dan subnet yang keluar, atau buat yang baru.
   • Tetapkan peran - Jaringan virtual memerlukan izin khusus untuk memungkinkan kluster Cassandra terkelola disebarkan. Centang kotak ini jika Anda membuat jaringan virtual baru, atau menggunakan jaringan virtual yang ada tanpa izin yang diterapkan. Jika Anda menggunakan jaringan virtual tempat Anda sebelumnya menyebarkan kluster Azure SQL Managed Instance Cassandra, batal pilih opsi ini.

   

   Tips

   Jika Anda menggunakan VPN, Anda tidak perlu membuka koneksi lain.

   Catatan

   Penyebaran Azure Managed Instance for Apache Cassandra memerlukan akses internet. Penyebaran akan gagal di lingkungan ketika akses internet terbatas. Pastikan Anda tidak memblokir akses di jaringan virtual Anda ke layanan Azure penting berikut yang diperlukan agar Cassandra Terkelola berfungsi dengan baik. Untuk informasi selengkapnya, lihat Aturan jaringan keluar yang diperlukan.

   • Azure Storage
   • Azure KeyVault
   • Set Skala Mesin Virtual Azure
   • Pemantauan Azure
   • Microsoft Entra ID
   • Keamanan Azure
   • Replikasi Otomatis. Pilih bentuk replikasi otomatis yang akan digunakan. Untuk informasi selengkapnya, lihat Replikasi Turnkey.
   • Jadwalkan Strategi Peristiwa. Strategi yang digunakan oleh kluster untuk peristiwa terjadwal.

   Tips

   • StopANY berarti menghentikan node apa saja ketika ada peristiwa terjadwal untuk node tersebut.
   • StopByRack berarti hanya menghentikan simpul di rak tertentu untuk Peristiwa Terjadwal tertentu. Misalnya, jika beberapa kejadian dijadwalkan secara bersamaan untuk simpul di rak yang berbeda, hanya simpul di satu rak yang berhenti. Simpul-simpul lain di rak-rak lain mengalami keterlambatan.

5. Selanjutnya pilih tab Pusat data.

6. Masukkan rincian berikut:

   • Nama pusat data. Ketik nama pusat data di bidang teks.
   • Zona ketersediaan. Centang kotak ini jika Anda ingin zona ketersediaan diaktifkan.
   • Ukuran SKU. Pilih dari ukuran SKU komputer virtual yang tersedia.

   

   Catatan

   Kami memperkenalkan write-through caching (Pratinjau Umum) dengan menggunakan SKU VM seri L. Implementasi ini bertujuan untuk meminimalkan latensi ekor dan meningkatkan performa baca, terutama untuk beban kerja intensif baca. SKU-SKU khusus ini dilengkapi dengan disk yang terpasang secara lokal, yang memastikan peningkatan IOPS yang sangat besar untuk operasi baca dan latensi ekor yang lebih rendah.

   Penting

   Penembolokan write-through sedang dalam tahap pratinjau publik. Fitur ini disediakan tanpa perjanjian tingkat layanan. Kami tidak merekomendasikannya untuk beban kerja produksi. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

   • Tidak. disk. Pilih jumlah disk p30 yang akan dilampirkan ke setiap simpul Cassandra.
   • Tidak. dari simpul. Pilih jumlah simpul Cassandra untuk disebarkan ke pusat data ini.

   

   Peringatan

   Zona ketersediaan tidak didukung di semua wilayah. Penyebaran gagal jika Anda memilih wilayah tempat zona ketersediaan tidak didukung. Untuk informasi selengkapnya, lihat Daftar wilayah Azure.

   Keberhasilan penyebaran zona ketersediaan juga tunduk pada ketersediaan sumber daya komputasi di semua zona di wilayah tertentu. Penyebaran mungkin gagal jika SKU yang Anda pilih, atau kapasitas, tidak tersedia di semua zona.

7. Selanjutnya, pilih Ulas dan Buat>Buat.

   Catatan

   Dibutuhkan waktu hingga 15 menit untuk membuat kluster.

   

8. Setelah penyebaran selesai, periksa grup sumber daya Anda untuk melihat kluster instans terkelola yang baru dibuat:

   

9. Untuk menelusuri simpul kluster, navigasikan ke sumber daya kluster dan buka panel Pusat Data :

   

Menskalakan pusat data

Sekarang setelah Anda menyebarkan kluster dengan satu pusat data, Anda dapat menskalakan secara horizontal atau vertikal dengan menyoroti pusat data, dan memilih tombol Skala :

Skala horizontal

Untuk meluaskan skala atau menskalakan pada simpul, pindahkan slider ke angka yang diinginkan, atau cukup edit nilainya. Setelah selesai, pilih Skalakan.

Skala vertikal

Untuk meningkatkan atau menurunkan skala ukuran SKU dari simpul Anda, pilih dari Ukuran SKU. Setelah selesai, pilih Skalakan.

Catatan

Lamanya waktu yang diperlukan untuk operasi penskalaan tergantung pada berbagai faktor. Mungkin perlu waktu beberapa menit. Ketika Azure memberi tahu Anda bahwa operasi skala selesai, itu tidak berarti bahwa semua simpul Anda bergabung dengan cincin Cassandra. Simpul sepenuhnya diaktifkan ketika semuanya menampilkan status sehat dan status pusat data menunjukkan sukses.

Penskalannya adalah operasi online dan bekerja dengan cara yang sama seperti dijelaskan untuk patching. Untuk informasi selengkapnya, lihat Patching.

Menambahkan pusat data

1. Untuk menambahkan pusat data lain, pilih tombol tambahkan di panel Pusat Data :

   

   Peringatan

   Jika Anda menambahkan pusat data di wilayah lain, Anda perlu memilih jaringan virtual yang berbeda. Anda juga perlu memastikan bahwa jaringan virtual ini memiliki konektivitas ke jaringan virtual wilayah utama yang dibuat sebelumnya. Selain itu, pastikan bahwa jaringan virtual lain yang berada di dalam kluster instans terkelola yang menghosting pusat data. Untuk informasi selengkapnya, lihat Menyambungkan jaringan virtual dengan peering jaringan virtual.

   Anda juga perlu memastikan bahwa Anda menerapkan peran yang sesuai ke jaringan virtual Anda sebelum mencoba menyebarkan kluster instans terkelola, menggunakan perintah CLI berikut.

   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>
   

2. Isi bidang yang sesuai:

   • Nama pusat data. Dari daftar dropdown, pilih langganan Azure Anda.
   • Zona ketersediaan. Pilih jika Anda ingin zona ketersediaan diaktifkan di pusat data ini.
   • Lokasi. Lokasi tempat pusat data Anda disebarkan.
   • Ukuran SKU. Pilih dari ukuran SKU komputer virtual yang tersedia.
   • Tidak. disk. Pilih jumlah disk p30 yang akan dilampirkan ke setiap simpul Cassandra.
   • Tidak. dari simpul. Pilih jumlah simpul Cassandra untuk disebarkan ke pusat data ini.
   • Jaringan Virtual. Pilih jaringan virtual dan subnet yang keluar.

   

   Peringatan

   Portal Microsoft Azure tidak mengizinkan pembuatan jaringan virtual baru saat Anda menambahkan pusat data. Anda perlu memilih jaringan virtual yang ada dan Anda perlu memastikan ada konektivitas antara subnet target tempat pusat data disebarkan. Anda juga perlu menerapkan peran yang sesuai ke jaringan virtual untuk memungkinkan penyebaran, seperti yang dijelaskan sebelumnya.

3. Saat pusat data disebarkan, Anda akan dapat menampilkan semua informasi pusat data di Panel Pusat Data:

   

4. Untuk memastikan replikasi antar pusat data, sambungkan ke cqlsh dan gunakan kueri CQL berikut untuk memperbarui strategi replikasi di setiap keyspace untuk menyertakan semua pusat data di seluruh kluster. Tabel sistem diperbarui secara otomatis.

   ALTER KEYSPACE "ks" WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'dc': 3, 'dc2': 3};
   

5. Jika Anda menambahkan pusat data ke kluster tempat sudah ada data, jalankan rebuild untuk mereplikasi data historis. Di Azure CLI, gunakan perintah berikut untuk dijalankan nodetool rebuild di setiap node pusat data baru. Tindakan ini menggantikan <new dc ip address> dengan alamat IP simpul, dan <olddc> dengan nama pusat data Anda yang sudah ada:

    az managed-cassandra cluster invoke-command \
      --resource-group $resourceGroupName \
      --cluster-name $clusterName \
      --host <new dc ip address> \
      --command-name nodetool --arguments rebuild="" "<olddc>"=""
   

   Peringatan

   Anda tidak boleh mengizinkan klien aplikasi menulis pada pusat data baru hingga Anda menerapkan perubahan pada replikasi keyspace. Jika tidak, pembangunan ulang tidak berfungsi, dan Anda perlu membuat permintaan dukungan sehingga tim kami dapat menjalankan repair atas nama Anda.

Memperbarui konfigurasi Cassandra

Layanan ini memungkinkan pembaruan untuk konfigurasi YAML Cassandra pada pusat data dengan menggunakan portal Microsoft Azure atau dengan menggunakan perintah CLI. Untuk memperbarui pengaturan di portal:

1. Temukan Cassandra Configuration di bawah pengaturan. Sorot pusat data yang konfigurasinya ingin Anda ubah, dan pilih perbarui:

   

2. Di jendela yang terbuka, masukkan nama bidang dalam format YAML, seperti yang diperlihatkan di sini. Lalu pilih perbarui.

   

3. Saat pembaruan selesai, nilai yang diambil alih muncul di panel Cassandra Configuration :

   

   Catatan

   Hanya nilai konfigurasi Cassandra yang diubah yang ditampilkan di portal Azure.

   Penting

   Pastikan pengaturan yaml Cassandra yang Anda berikan sesuai untuk versi Cassandra yang Anda sebarkan. Lihat Pengaturan Cassandra v3.11 untuk Cassandra v3.11 dan Cassandra v4.0 untuk v4.0. Anda tidak dapat memperbarui pengaturan YAML berikut:

   • nama_kelompok
   • penyedia benih
   • initial_token
   • autobootstrap
   • opsi_enkripsi_klien
   • opsi_enkripsi_server
   • opsi_enkripsi_data_transparan
   • opsi_pencatatan_audit
   • Authenticator
   • pemberi izin
   • manajer_peran
   • storage_port
   • ssl_port_penyimpanan
   • native_transport_port
   • port_transportasi_asli_ssl
   • alamat_dengar
   • antarmuka mendengarkan
   • alamat siaran
   • direktori_petunjuk
   • data_file_directories
   • commitlog_directory
   • cdc_raw_directory
   • direktori_cache_yang_disimpan
   • snitch_titik_akhir
   • partisi
   • rpc_address
   • Antarmuka_RPC

Memperbarui versi Cassandra

Penting

Pembaruan Versi Cassandra 5.0 dan Turnkey, ada di pratinjau publik. Fitur-fitur ini disediakan tanpa perjanjian tingkat layanan. Kami tidak merekomendasikan fitur ini untuk beban kerja produksi. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Anda dapat melakukan peningkatan versi utama di tempat langsung dari portal atau melalui templat Az CLI, Terraform, atau ARM.

1. Temukan panel Update dari tab Gambaran Umum.

   

2. Pilih versi Cassandra dari daftar dropdown.

   Peringatan

   Jangan lewati versi. Sebaiknya perbarui hanya dari satu versi ke contoh lain 3.11 ke 4.0, 4.0 ke 4.1.

   

3. Pilih perbarui untuk menyimpan.

Replikasi turnkey

Cassandra 5.0 memperkenalkan pendekatan yang efisien untuk menyebarkan kluster multi-wilayah, menawarkan kenyamanan dan efisiensi yang ditingkatkan. Jika Anda menggunakan fungsionalitas replikasi turnkey, menyiapkan dan mengelola kluster multi-wilayah menjadi lebih mudah diakses, memungkinkan integrasi dan operasi yang lebih lancar di seluruh lingkungan terdistribusi.

Pembaruan ini secara signifikan mengurangi kompleksitas yang terkait dengan penyebaran dan pemeliharaan beberapa konfigurasi wilayah, memungkinkan pengguna untuk menggunakan kemampuan Cassandra dengan kemudahan dan efektivitas yang lebih besar.

Tips

• Tidak Ada: Pengaturan replikasi otomatis diatur ke tidak ada.
• SystemKeyspaces: Replikasi otomatis semua keyspace sistem (system_auth, system_traces, system_auth).
• AllKeyspaces: Replikasi otomatis semua keyspace dan pantau apakah keyspace baru dibuat lalu terapkan pengaturan replikasi otomatis secara otomatis.

Skenario replikasi otomatis

• Saat Anda menambahkan pusat data baru, fitur replikasi otomatis di Cassandra berjalan nodetool rebuild dengan mulus untuk memastikan keberhasilan replikasi data di seluruh pusat data yang ditambahkan.
• Menghapus pusat data memicu penghapusan otomatis pusat data tertentu dari keyspace.

Untuk pusat data eksternal, seperti yang dihosting di lokasi sendiri, pusat data tersebut dapat disertakan dalam keyspace dengan menggunakan properti pusat data eksternal. Pendekatan ini memungkinkan Cassandra untuk menggabungkan pusat data eksternal ini sebagai sumber untuk proses pembangunan kembali.

Peringatan

Mengatur replikasi otomatis ke AllKeyspaces mengubah replikasi keyspace Anda untuk mencakup:

WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }

Jika topologi ini bukan yang Anda inginkan, gunakan SystemKeyspaces, sesuaikan sendiri, dan jalankan nodetool rebuild secara manual pada kluster Azure Managed Instance for Apache Cassandra.

Batalkan alokasi klaster

Untuk lingkungan nonproduksi, Anda dapat menjeda atau membatalkan alokasi sumber daya di kluster untuk menghindari biaya untuk mereka. Anda terus dikenakan biaya untuk penyimpanan. Pertama ubah jenis kluster menjadi NonProduction, lalu deallocate.

Tips

Jenis kluster harus digunakan sebagai "Non-Produksi" hanya untuk menghemat biaya pengembangan. Mereka mungkin datang dengan SKU yang lebih kecil, dan TIDAK boleh digunakan untuk menjalankan beban kerja produksi.

Peringatan

• Jenis kluster yang didefinisikan sebagai "Nonproduksi" tidak memiliki jaminan SLA yang diterapkan padanya.
• Jangan menjalankan skema atau operasi tulis selama dealokasi. Tindakan ini dapat menyebabkan kehilangan data dan dalam kasus yang jarang terjadi kerusakan skema yang memerlukan intervensi manual dari tim dukungan.

Pemecahan Masalah

Jika Anda mengalami kesalahan saat menerapkan izin ke jaringan virtual Menggunakan Azure CLI, Anda dapat menerapkan izin yang sama secara manual dari portal Microsoft Azure. Contoh kesalahan tersebut adalah Tidak dapat menemukan prinsipal pengguna atau layanan dalam database grafik untuk 'e5007d2c-4b13-4a74-9b6a-605d99f03501'. Untuk informasi selengkapnya, lihat Menggunakan portal Microsoft Azure untuk menambahkan perwakilan layanan Azure Cosmos DB.

Catatan

Penugasan peran Azure Cosmos DB digunakan hanya untuk tujuan penyebaran. Azure Managed Instance for Apache Cassandra tidak memiliki dependensi backend pada Azure Cosmos DB.

Menyambungkan ke Klaster Anda

Azure Managed Instance for Apache Cassandra tidak membuat simpul dengan alamat IP publik. Untuk menyambungkan ke kluster Cassandra yang baru dibuat, buat sumber daya lain di dalam jaringan virtual. Sumber daya ini bisa berupa aplikasi, atau komputer virtual dengan alat kueri sumber terbuka Apache CQLSH terinstal. Anda dapat menggunakan templat untuk menyebarkan komputer virtual Ubuntu.

Menyambung ke CQLSH

Setelah komputer virtual disebarkan, gunakan SSH untuk menyambungkan ke komputer, dan instal CQLSH menggunakan perintah di bawah ini:

# 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

Menghubungkan dari aplikasi

Seperti halnya CQLSH, menyambungkan dari aplikasi menggunakan salah satu driver klien Apache Cassandra yang didukung mengharuskan enkripsi SSL diaktifkan, dan verifikasi sertifikasi dinonaktifkan. Lihat sampel untuk menyambungkan ke Azure Managed Instance for Apache Cassandra menggunakan Java, .NET, Node.js, dan Python.

Sebaiknya nonaktifkan verifikasi sertifikat karena verifikasi sertifikat tidak berfungsi kecuali Anda memetakan alamat IP node kluster Anda ke domain yang sesuai. Jika Anda memiliki kebijakan internal yang mengamanatkan bahwa Anda melakukan verifikasi sertifikat SSL untuk aplikasi apa pun, Anda dapat memfasilitasi penyiapan ini dengan menambahkan entri seperti 10.0.1.5 host1.managedcassandra.cosmos.azure.com dalam file host Anda untuk setiap simpul. Jika Anda mengambil pendekatan ini, Anda juga perlu menambahkan entri baru setiap kali menambah skala simpul.

Untuk Java, kami juga sangat menyarankan mengaktifkan kebijakan eksekusi spekulatif ketika aplikasi sensitif terhadap latensi akhir. Untuk demo yang menggambarkan cara kerja pendekatan ini, lihat cara mengaktifkan kebijakan dan Demo: menerapkan eksekusi spekulatif.

Catatan

Dalam kebanyakan kasus, seharusnya tidak perlu mengonfigurasi atau menginstal sertifikat (seperti rootCA, node, atau klien, truststores) untuk terhubung ke Azure Managed Instance for Apache Cassandra. Enkripsi SSL dapat diaktifkan dengan menggunakan truststore default dan kata sandi runtime yang digunakan oleh klien karena sertifikat Azure Managed Instance for Apache Cassandra dipercaya oleh lingkungan tersebut. Dalam kasus yang jarang terjadi, jika sertifikat tidak tepercaya, Anda mungkin perlu menambahkannya ke truststore. Lihat Java, .NET, Node.js, dan Python.

Mengonfigurasi sertifikat klien (opsional)

Mengonfigurasi sertifikat klien bersifat opsional. Aplikasi klien dapat terhubung ke Azure Managed Instance for Apache Cassandra selama langkah-langkah sebelumnya selesai. Namun, jika mau, Anda juga dapat membuat dan mengonfigurasi sertifikat klien untuk autentikasi. Secara umum, ada dua cara untuk membuat sertifikat:

• Sertifikat yang ditandatangani sendiri. Sertifikat privat dan publik (tanpa CA) untuk setiap simpul. Dalam hal ini, Anda memerlukan semua sertifikat publik.
• Sertifikat yang ditandatangani oleh Otoritas Sertifikat. Sertifikat ini dapat menjadi CA yang ditandatangani sendiri atau bahkan yang publik. Dalam hal ini, Anda memerlukan sertifikat CA akar dan semua sertifikat antara (jika berlaku). Untuk informasi selengkapnya, lihat Menyiapkan sertifikat SSL untuk produksi.

Jika Anda ingin menerapkan autentikasi sertifikat klien-ke-simpul atau Keamanan Lapisan Transportasi bersama (mTLS), berikan sertifikat dengan menggunakan Azure CLI. Perintah berikut mengunggah dan menerapkan sertifikat klien Anda ke truststore untuk kluster instans terkelola. Anda tidak perlu mengedit cassandra.yaml pengaturan. Setelah Anda menerapkan perintah, kluster Anda memerlukan Cassandra untuk memverifikasi sertifikat saat klien terhubung. Lihat require_client_auth: true di 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

Membersihkan sumber daya

Jika Anda berencana tidak menggunakan Klaster instans terkelola ini, hapus dengan langkah-langkah berikut:

1. Dari menu sebelah kiri portal Microsoft Azure, pilih Grup sumber daya.
2. Dari daftar, pilih grup sumber daya yang Anda buat untuk panduan mulai cepat ini.
3. Pada panel Ringkasan grup sumber daya, pilih Hapus grup sumber daya.
4. Di jendela berikutnya, masukkan nama grup sumber daya yang akan dihapus, lalu pilih Hapus.

Langkah selanjutnya

Sebarkan Kluster Managed Apache Spark dengan Azure Databricks