Udostępnij za pomocą


Szybki start: konfigurowanie klastra hybrydowego za pomocą wystąpienia zarządzanego platformy Azure dla usługi Apache Cassandra przy użyciu programu Client Configurator

Konfigurator klienta platformy Azure to narzędzie ułatwiające konfigurowanie klastra hybrydowego i upraszczanie procesu migracji do wystąpienia zarządzanego platformy Azure dla usługi Apache Cassandra. Jeśli obecnie masz lokalne centra danych lub działają we własnym środowisku, możesz użyć wystąpienia zarządzanego platformy Azure dla usługi Apache Cassandra, aby bezproblemowo dołączyć inne centra danych do klastra, jednocześnie efektywnie je konserwując.

Ważne

Narzędzie Konfigurator klienta jest w publicznej wersji zapoznawczej. Ta funkcja jest udostępniana bez umowy dotyczącej poziomu usług. Nie zalecamy obsługi obciążeń produkcyjnych.

Aby uzyskać więcej informacji, zobacz Uzupełniające warunki korzystania z wersji zapoznawczych platformy Microsoft Azure.

Wymagania wstępne

  • Ten artykuł wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.30.0 lub nowszej. Jeśli używasz usługi Azure Cloud Shell, najnowsza wersja jest już zainstalowana.

  • Użyj sieci wirtualnej platformy Azure z łącznością z własnym środowiskiem lub środowiskiem lokalnym. Aby uzyskać więcej informacji na temat łączenia środowisk lokalnych z platformą Azure, zobacz Łączenie sieci lokalnej z platformą Azure.

  • Wymagana jest instalacja języka Python. Aby sprawdzić, czy język Python jest zainstalowany, uruchom polecenie python --version w terminalu.

  • Upewnij się, że zarówno klaster usługi Azure Managed Instance for Apache Cassandra, jak i lokalny klaster Cassandra znajdują się w tej samej sieci wirtualnej. Jeśli nie, musisz ustanowić peering sieciowy lub inny sposób łączności. Na przykład użyj usługi Azure ExpressRoute.

  • Nazwa klastra zarówno dla klastra zarządzanego, jak i klastra lokalnego musi być taka sama.

    Upewnij się, że w pliku cassandra.yaml port magazynu jest ustawiony na 7001, a nazwa klastra jest taka sama jak w klastrze zarządzanym.

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

Instalacja

  1. Pobierz i przejdź do folderu konfiguratora klienta.

  2. Skonfiguruj środowisko wirtualne, aby uruchomić skrypt języka Python:

    python3 -m venv env
    source env/bin/activate
    python3 -m pip install -r requirements.txt
    
  3. Zaloguj się do Azure CLI az login.

  4. Uruchom skrypt języka Python w folderze klienta z informacjami z istniejącego klastra (lokalnego):

    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 Opis
    subscription-ID Identyfikator subskrypcji Azure
    cluster-resource-group Grupa zasobów, w której znajduje się klaster
    cluster-name Nazwa klastra usługi Azure Managed Instance dla Apache Cassandra
    initial-password Hasło dla zarządzanej instancji Azure dla klastra Apache Cassandra
    vnet-resource-group Grupa zasobów dołączona do sieci wirtualnej
    vnet-name Nazwa sieci wirtualnej dołączonej do klastra
    subnet-name Nazwa adresu IP przydzielonego do klastra Cassandra
    location Miejsce wdrożenia klastra
    seed-nodes Węzły startowe istniejących centrów danych w lokalnie zainstalowanym lub własnym klastrze Cassandra
    mi-dc-name Nazwa centrum danych klastra usługi Azure Managed Instance dla klastra Apache Cassandra
    dc-name Nazwa centrum danych klastra lokalnego
    sku Rozmiar warstwy produktu maszyny wirtualnej
  5. Skrypt języka Python tworzy archiwum tar o nazwie install_certs.tar.gz. Rozpakuj ten folder na /etc/cassandra/ na każdym węźle.

    sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra
    
  6. W folderze /etc/cassandra/ uruchom polecenie sudo ./install_certs.sh.

    • Upewnij się, że skrypt jest wykonywalny, uruchamiając polecenie sudo chmod +x install_certs.sh.

    • Skrypt instaluje i wskazuje Cassandrę na nowe certyfikaty potrzebne do połączenia z zarządzanym wystąpieniem Azure dla klastra Apache Cassandra.

    • Następnie monituje użytkownika o ponowne uruchomienie bazy danych Cassandra.

      Zrzut ekranu przedstawiający wynik uruchomienia skryptu.

  7. Po zakończeniu ponownego uruchamiania systemu Cassandra na wszystkich węzłach, sprawdź nodetool status. Oba centra danych powinny pojawić się na liście z węzłami w stanie UN (Up/Normal).

  8. W swojej usłudze Azure Managed Instance for Apache Cassandra możesz wybrać opcję AllKeyspaces, aby zmienić ustawienia replikacji w schemacie przestrzeni kluczy i rozpocząć proces migracji do klastra Azure Managed Instance dla Cassandra.

  9. autoReplicate Włącz ustawienie przy użyciu szablonu usługi Azure Resource Manager (szablonu usługi ARM). Szablon usługi ARM powinien zawierać następujące elementy:

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

    Wszystkie definicje przestrzeni kluczy zmieniają się tak, aby zawierały WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 }. Jeśli ta topologia nie jest odpowiednia, dostosuj ją i uruchom nodetool rebuild ręcznie w wystąpieniu zarządzanym platformy Azure dla klastra Apache Cassandra.

    Dowiedz się więcej o autoreplicacji.

  10. Aktualizuj i monitoruj postęp replikacji danych, wybierając okienko Centrum danych .

    Zrzut ekranu przedstawiający postęp replikacji.

Następny krok