Rychlý start: Konfigurace hybridního clusteru se službou Azure Managed Instance for Apache Cassandra pomocí nástroje Client Configurator
Konfigurátor klienta Azure je nástroj, který vám pomůže s konfigurací hybridního clusteru a zjednodušením procesu 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 a nedoporučuje se pro produkční úlohy. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.
Požadavky
Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
Tento článek vyžaduje Azure CLI verze 2.30.0 nebo vyšší. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.
Azure Virtual Network s připojením k místnímu nebo místnímu prostředí. Další informace o připojení místních prostředí k Azure najdete v článku Připojení místní sítě k Azure .
Vyžaduje se instalace Pythonu. Spuštěním
python --versionv terminálu můžete zkontrolovat, jestli je python nainstalovaný.Ujistěte se, že se spravovaná instance Azure i místní cluster Cassandra nacházejí ve stejné virtuální síti. Pokud ne, je nutné vytvořit partnerský vztah sítě nebo jiný způsob připojení (například expressroute).
Název clusteru pro spravovaný cluster i místní cluster musí být stejný. * V souboru cassandra.yaml 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
- Stáhněte a přejděte do složky konfigurátoru klienta.
- 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
- Přihlášení k Azure CLI
az login - 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>
Poznámka:
- id předplatného: ID předplatného Azure.
- skupina prostředků clusteru: Skupina prostředků, ve které se cluster nachází.
- název clusteru: Název clusteru spravované instance Azure.
- initial-password: Password for your Azure Managed Instance for Apache Cassandra cluster.
- 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.
- název podsítě: Název IP adresy přidělené clusteru Cassandra.
- umístění: Kde je cluster nasazený.
- počáteční uzly: Počáteční uzly existujících datacenter v místním nebo místním clusteru Cassandra.
- mi-dc-name: Název datového centra vašeho clusteru Azure Managed Instance.
- dc-name: Název datového centra místního clusteru.
- skladová položka: Velikost skladové položky virtuálního počítače.
Skript Pythonu vytvoří archiv tar s názvem
install_certs.tar.gz. * Rozbalte tuto složku do/etc/cassandra/každého uzlu.sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra/etc/cassandra/Ve složce spusťtesudo ./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.
- Pak uživatele vyzve k restartování Cassandry.
- Spuštěním příkazu
Jakmile se Cassandra restartuje na všech uzlech, zkontrolujte
nodetool status. Obě datová centra by se měla zobrazit v seznamu se svými uzly ve stavu UN (Up/Normal).Ve službě Azure Managed Instance for Apache Cassandra pak můžete změnit
AllKeyspacesnastavení replikace ve schématu Keyspace a spustit proces migrace do clusteru Spravované instance Cassandra.
Tip
Nastavení automatické replikace by mělo být povolené prostřednictvím šablony arm. Šablona arm by měla obsahovat:
"properties":{
...
"externalDataCenters": ["dc-name-1","dc-name-2"],
"autoReplicate": "AllKeyspaces",
...
}
Upozorňující
Tím se změní definice všech vašich prostorů klíčů tak, aby zahrnovala WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }.
Pokud to není topologie, kterou chcete, budete ji muset upravit a spustit nodetool rebuild ručně v clusteru spravované instance Cassandra.
Další informace o automatické replikaci
Výběrem podokna
Data Centeraktualizujte a monitorujte průběh replikace dat.
[!INFO]
Další kroky
V tomto rychlém startu jste zjistili, jak vytvořit hybridní cluster pomocí azure Managed Instance for Apache Cassandra Client Configurator. Teď můžete začít pracovat s clusterem.