Bagikan melalui


Mulai cepat: Mengonfigurasi kluster hibrid dengan Azure Managed Instance for Apache Cassandra dengan menggunakan Client Configurator

Azure Client Configurator 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 Client Configurator sedang dalam 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.

Prasyarat

  • Artikel ini memerlukan Azure CLI versi 2.30.0 atau yang lebih baru. Jika Anda menggunakan Azure Cloud Shell, versi terbaru sudah diinstal.

  • Gunakan jaringan virtual Azure dengan konektivitas ke lingkungan yang dihost sendiri atau lokal. Untuk informasi selengkapnya tentang cara menyambungkan lingkungan lokal ke Azure, lihat Menyambungkan jaringan lokal ke Azure.

  • Penginstalan Python diperlukan. Untuk memeriksa apakah Python diinstal, jalankan python --version di terminal Anda.

  • Pastikan bahwa kluster Azure Managed Instance for Apache Cassandra dan kluster Cassandra lokal terletak di jaringan virtual yang sama. Jika tidak, Anda perlu membuat peering jaringan atau metode konektivitas lainnya. Misalnya, gunakan Azure ExpressRoute.

  • Nama kluster untuk kluster terkelola dan kluster lokal harus sama.

    cassandra.yaml Dalam file, pastikan bahwa 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

  1. Unduh dan masuk ke folder configurator klien.

  2. Siapkan lingkungan virtual untuk menjalankan skrip Python:

    python3 -m venv env
    source env/bin/activate
    python3 -m pip install -r requirements.txt
    
  3. Masuk ke Azure CLI az login.

  4. 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>
    
    Pengaturan Deskripsi
    subscription-ID ID langganan Azure
    cluster-resource-group Grup sumber daya tempat kluster Anda berada
    cluster-name Nama kluster Azure Managed Instance for Apache Cassandra
    initial-password 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 dilampirkan ke kluster Anda
    subnet-name Nama IP yang dialokasikan ke kluster Cassandra
    location Tempat kluster Anda di-deploy
    seed-nodes Node benih dari pusat data yang ada di kluster Cassandra lokal atau yang dihost sendiri
    mi-dc-name Nama pusat data Azure Managed Instance untuk kluster Apache Cassandra Anda
    dc-name Nama pusat data kluster lokal
    sku Ukuran tingkat produk mesin virtual
  5. 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
    
  6. 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 sertifikat baru yang diperlukan untuk terhubung ke kluster Azure Managed Instance for Apache Cassandra.

    • Kemudian meminta pengguna untuk memulai ulang Cassandra.

      Cuplikan layar yang memperlihatkan hasil menjalankan skrip.

  7. Setelah Cassandra selesai merestart di semua node, periksa nodetool status. Kedua pusat data muncul dalam daftar, dengan node-nya dalam status UN (Up/Normal).

  8. Dari instans 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 Azure Managed Instance for Cassandra.

  9. Aktifkan autoReplicate pengaturan dengan menggunakan templat Azure Resource Manager (templat ARM). Templat ARM harus mencakup:

    "properties":{
    ...
    "externalDataCenters": ["dc-name-1","dc-name-2"],
    "autoReplicate": "AllKeyspaces",
    ...
    }
    

    Semua definisi keyspace Anda berubah untuk menyertakan WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Jika topologi ini bukan yang Anda inginkan, sesuaikan dan jalankan nodetool rebuild secara manual pada kluster Azure Managed Instance for Apache Cassandra.

    Pelajari selengkapnya tentang replikasi otomatis.

  10. Perbarui dan pantau kemajuan replikasi data dengan memilih panel Pusat Data .

    Cuplikan layar yang memperlihatkan kemajuan replikasi.

Langkah selanjutnya