Freigeben über

Schnellstart: Konfigurieren eines Hybridclusters mit azure Managed Instance für Apache Cassandra mithilfe des Clientkonfigurators

Der Azure-Clientkonfigurator ist ein Tool, das Sie bei der Konfiguration eines Hybridclusters und der Vereinfachung des Migrationsprozesses zu Azure Managed Instance für Apache Cassandra unterstützt. Wenn Sie derzeit über lokale Rechenzentren verfügen oder in einer selbst gehosteten Umgebung arbeiten, können Sie Azure Managed Instance for Apache Cassandra nutzen, um andere Rechenzentren nahtlos in Ihren Cluster einzubinden und sie gleichzeitig effektiv zu verwalten.

Wichtig

Das Tool "Clientkonfigurator" befindet sich in der öffentlichen Vorschau. Dieses Feature wird ohne Vereinbarung zum Servicelevel bereitgestellt. Sie sollte nicht für Produktionsworkloads verwendet werden.

Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Voraussetzungen

  • Dieser Artikel erfordert die Azure CLI-Version 2.30.0 oder höher. Bei Verwendung von Azure Cloud Shell ist die aktuelle Version bereits installiert.

  • Verwenden Sie ein virtuelles Azure-Netzwerk mit Konnektivität zu Ihrer selbst gehosteten oder lokalen Umgebung. Weitere Informationen zum Verbinden lokaler Umgebungen mit Azure finden Sie unter Verbinden eines lokalen Netzwerks mit Azure.

  • Eine Python-Installation ist erforderlich. Um zu überprüfen, ob Python installiert ist, führen Sie es in Ihrem Terminal aus python --version .

  • Stellen Sie sicher, dass sich sowohl der Azure Managed Instance für Apache Cassandra-Cluster als auch der lokale Cassandra-Cluster im selben virtuellen Netzwerk befinden. Andernfalls müssen Sie Netzwerk-Peering oder ein anderes Verbindungsmittel einrichten. Verwenden Sie beispielsweise Azure ExpressRoute.

  • Der Clustername für den verwalteten Cluster und den lokalen Cluster muss identisch sein.

    Stellen Sie in der cassandra.yaml Datei sicher, dass der Speicherport auf 7001 festgelegt ist, und der Clustername entspricht dem verwalteten Cluster:

    cluster_name: managed_cluster-name
storage_port: 7001

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

Installation

  1. Laden Sie den Clientkonfigurator-Ordner herunter, und gehen Sie in den Ordner "Clientkonfigurator".

  2. Richten Sie eine virtuelle Umgebung ein, um das Python-Skript auszuführen:

    python3 -m venv env
source env/bin/activate
python3 -m pip install -r requirements.txt

  3. Melden Sie sich bei der Azure CLI az loginan.

  4. Führen Sie das Python-Skript im Clientordner mit Informationen aus dem vorhandenen (lokalen) Cluster aus:

    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 BESCHREIBUNG
    subscription-ID Azure-Abonnement-ID
    cluster-resource-group Ressourcengruppe, in der sich Ihr Cluster befindet
    cluster-name Azure Managed Instance for Apache Cassandra-Clustername
    initial-password Kennwort für Ihre azure Managed Instance für Apache Cassandra Cluster
    vnet-resource-group Ressourcengruppe, die an das virtuelle Netzwerk angefügt ist
    vnet-name Name des virtuellen Netzwerks, das an Ihren Cluster angefügt ist
    subnet-name Name der IP-Adresse, die dem Cassandra-Cluster zugeordnet ist
    location Wo Ihr Cluster bereitgestellt wird
    seed-nodes Seedknoten der vorhandenen Rechenzentren in Ihrem lokalen oder selbst gehosteten Cassandra-Cluster
    mi-dc-name Name des Rechenzentrums Ihrer azure Managed Instance für Apache Cassandra-Cluster
    dc-name Name des Rechenzentrums des lokalen Clusters
    sku Produktebene des virtuellen Computers

  5. Das Python-Skript erzeugt ein tar-Archiv mit dem Namen install_certs.tar.gz. Entpacken Sie diesen Ordner /etc/cassandra/ in jeden Knoten:

    sudo tar -xzvf install_certs.tar.gz -C /etc/cassandra

  6. Führen Sie innerhalb des Ordners /etc/cassandra/ sudo ./install_certs.sh aus.

    • Stellen Sie sicher, dass das Skript ausführbar ist, indem Sie sudo chmod +x install_certs.sh ausführen.

    • Das Skript installiert und weist Cassandra auf die neuen Zertifikate hin, die zum Herstellen einer Verbindung mit dem Azure Managed Instance für Apache Cassandra-Cluster erforderlich sind.

    • Anschließend wird der Benutzer aufgefordert, Cassandra neu zu starten.

      Screenshot, der das Ergebnis der Ausführung des Skripts zeigt.

  7. Nachdem Cassandra den Neustart auf allen Knoten abgeschlossen hat, überprüfen Sie nodetool status. Beide Rechenzentren sollten in der Liste mit ihren Knoten im UN (Up/Normal) Zustand angezeigt werden.

  8. Aus Ihrer Instanz von Azure Managed Instance für Apache Cassandra können Sie dann auswählen AllKeyspaces , um die Replikationseinstellungen in Ihrem Keyspace-Schema zu ändern und den Migrationsprozess zu der azure Managed Instance für Cassandra-Cluster zu starten.

  9. Aktivieren Sie die autoReplicate Einstellung mithilfe einer Azure Resource Manager-Vorlage (ARM-Vorlage). Die ARM-Vorlage sollte Folgendes enthalten:

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

    Alle Keyspaces-Definitionen ändern sich dahingehend, dass sie WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'on-prem-datacenter-1' : 3, 'mi-datacenter-1': 3 } beinhalten. Wenn diese Topologie nicht Ihren Vorstellungen entspricht, passen Sie dies an und führen Sie nodetool rebuild manuell auf der Azure-Verwalteten Instanz für Apache Cassandra-Cluster aus.

    Weitere Informationen zur Autoreplizierung.

  10. Aktualisieren und überwachen Sie den Datenreplikationsfortschritt, indem Sie den Datencenterbereich auswählen.

    Screenshot, der den Replikationsfortschritt zeigt.

Nächster Schritt

Erlernen Sie die Migration zu Azure Managed Instance für Apache Cassandra unter Verwendung von Apache Spark und einem Dual-Write-Proxy

  • Last updated on