Sdílet prostřednictvím


Rychlý start: Konfigurace hybridního clusteru se službou Azure Managed Instance for Apache Cassandra pomocí konfigurátoru klienta

Azure Client Configurator je nástroj navržený tak, aby vám pomohl s konfigurací hybridního clusteru a zjednodušil proces migrace do služby Azure Managed Instance for Apache Cassandra. Pokud aktuálně máte místní datacentra nebo pracujete v místním prostředí, můžete pomocí služby Azure Managed Instance for Apache Cassandra bezproblémově začlenit další datacentra do clusteru a současně je efektivně udržovat.

Důležité

Nástroj Client Configurator je ve verzi Public Preview. Tato funkce je poskytována bez smlouvy o úrovni služeb. Nedoporučujeme ho pro produkční úlohy.

Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Požadavky

  • Tento článek vyžaduje Azure CLI verze 2.30.0 nebo novější. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

  • Použijte virtuální síť Azure s připojením k vašemu vlastnímu nebo místnímu prostředí. Další informace o připojení místních prostředí k Azure najdete v tématu Připojení místní sítě k Azure.

  • Vyžaduje se instalace Pythonu. Pokud chcete zkontrolovat, jestli je Python nainstalovaný, spusťte python --version ho v terminálu.

  • Ujistěte se, že se ve stejné virtuální síti nachází jak cluster Azure Managed Instance for Apache Cassandra, tak místní cluster Cassandra. Pokud ne, musíte nastavit propojení sítí nebo jiný způsob připojení. Použijte například Azure ExpressRoute.

  • Název clusteru pro spravovaný cluster i místní cluster musí být stejný.

    cassandra.yaml V souboru se ujistěte, že je port úložiště nastavený na 7001 a název clusteru je stejný jako spravovaný cluster:

    cluster_name: managed_cluster-name
    storage_port: 7001
    
    UPDATE system.local SET cluster_name = 'managed_cluster-name' where key='local';
    

Instalace

  1. Stáhněte a přejděte do složky konfigurátoru klienta.

  2. Nastavte virtuální prostředí pro spuštění skriptu Pythonu:

    python3 -m venv env
    source env/bin/activate
    python3 -m pip install -r requirements.txt
    
  3. Přihlaste se k Azure CLI az login.

  4. Spusťte skript Pythonu ve složce klienta s informacemi z existujícího (místního) clusteru:

    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>
    
    Parameter Popis
    subscription-ID ID předplatného Azure
    cluster-resource-group Skupina prostředků, ve které se cluster nachází
    cluster-name Název clusteru Azure Managed Instance for Apache Cassandra
    initial-password Heslo pro váš cluster Azure Managed Instance pro Apache Cassandra
    vnet-resource-group Skupina prostředků připojená k virtuální síti
    vnet-name Název virtuální sítě připojené k vašemu clusteru
    subnet-name Název IP adresy přidělené clusteru Cassandra
    location Kde je cluster nasazený
    seed-nodes Startovací uzly existujících datacenter ve vašem místním nebo samostatně hostovaném clusteru Cassandra.
    mi-dc-name Název datového centra vaší Azure Managed Instance clusteru pro Apache Cassandra
    dc-name Název datacentra místního clusteru
    sku Velikost úrovně produktu virtuálního počítače
  5. Skript Pythonu vytvoří archiv tar s názvem install_certs.tar.gz. Rozbalte tuto složku na /etc/cassandra/ na každý uzel.

    sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra
    
  6. /etc/cassandra/ Ve složce spusťte sudo ./install_certs.shpříkaz .

    • Spuštěním příkazu sudo chmod +x install_certs.sh. se ujistěte, že je skript spustitelný.

    • Skript nainstaluje a nasměruje Cassandra na nové certifikáty potřebné pro připojení ke clusteru Azure Managed Instance for Apache Cassandra.

    • Pak uživatele vyzve k restartování Cassandry.

      Snímek obrazovky znázorňující výsledek spuštění skriptu

  7. Po dokončení restartování Cassandry na všech uzlech zkontrolujte nodetool status. Obě datová centra by se měla zobrazit v seznamu se svými uzly ve UN (Up/Normal) stavu.

  8. Ve vaší instanci služby Azure Managed Instance for Apache Cassandra pak můžete vybrat AllKeyspaces pro změnu nastavení replikace ve schématu keyspace a zahájit proces migrace do clustru Azure Managed Instance for Apache Cassandra.

  9. autoReplicate Povolte nastavení pomocí šablony Azure Resource Manageru (šablona ARM). Šablona ARM by měla obsahovat:

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

    Všechny definice keyspaces se změní tak, aby zahrnovaly WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Pokud tato topologie není to, co chcete, upravte ji a spusťte nodetool rebuild ji ručně v clusteru Azure Managed Instance for Apache Cassandra.

    Přečtěte si další informace o automatickém duplikování.

  10. Výběrem podokna Data Center aktualizujte a monitorujte průběh replikace dat.

    Snímek obrazovky znázorňující průběh replikace

Další krok