Schnellstart: Erstellen eines Azure Managed Instance for Apache Cassandra-Clusters im Azure-Portal

Azure Managed Instance for Apache Cassandra bietet automatisierte Bereitstellungs- und Skalierungsvorgänge für verwaltete Open-Source-Rechenzentren in Apache Cassandra und ermöglicht so schnellere Hybridszenarios und einen geringeren kontinuierlichen Wartungsaufwand.

In dieser Schnellstartanleitung erfahren Sie, wie Sie mithilfe des Azure-Portals eine Azure Managed Instance-Instanz für einen Apache Cassandra-Cluster erstellen.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Erstellen eines Managed Instance-Clusters

  1. Melden Sie sich beim Azure-Portal an.

  2. Suchen Sie in der Suchleiste nach Managed Instance for Apache Cassandra, und wählen Sie das Ergebnis aus.

    Screenshot der Suche nach der Azure SQL Managed Instance für Apache Cassandra.

  3. Wählen Sie die Schaltfläche Managed Instance for Apache Cassandra-Cluster erstellen aus.

    Erstellen des Clusters.

  4. Geben Sie im Bereich Managed Instance for Apache Cassandra-Cluster erstellen folgende Details ein:

    • Wählen Sie in der Dropdownliste unter Abonnement Ihr Azure-Abonnement aus.
    • Geben Sie für Ressourcengruppe an, ob Sie eine neue Ressourcengruppe erstellen oder eine vorhandene verwenden möchten. Eine Ressourcengruppe ist ein Container, der verwandte Ressourcen für eine Azure-Lösung enthält. Weitere Informationen finden Sie im Übersichtsartikel Was ist Azure Resource Manager?.
    • Clustername: Geben Sie einen Namen für den Cluster ein.
    • Speicherort: Der Speicherort, an dem der Cluster bereitgestellt wird.
    • Ursprüngliches Cassandra-Administratorkennwort: Das Kennwort, das zum Erstellen des Clusters verwendet wird.
    • Cassandra-Administratorkennwort bestätigen: Geben Sie Ihr Kennwort erneut ein.
    • Virtuelles Netzwerk: Wählen Sie ein vorhandenes virtuelles Netzwerk und ein Subnetz aus, oder erstellen Sie ein neues.
    • Rollen zuweisen: Für virtuelle Netzwerke sind besondere Berechtigungen erforderlich, damit verwaltete Cassandra-Cluster bereitgestellt werden können. Lassen Sie dieses Kontrollkästchen aktiviert, wenn Sie ein neues virtuelles Netzwerk erstellen oder ein vorhandenes virtuelles Netzwerk ohne angewendete Berechtigungen verwenden. Wenn Sie ein virtuelles Netzwerk verwenden, in dem Sie bereits Azure SQL Managed Instance-Cassandra-Cluster bereitgestellt haben, deaktivieren Sie diese Option.

    Ausfüllen des Formulars zum Erstellen des Clusters.

    Hinweis

    Für die Bereitstellung einer Instanz von Azure Managed Instance for Apache Cassandra ist Internetzugriff erforderlich. In Umgebungen, in denen der Internetzugriff eingeschränkt ist, tritt ein Fehler bei der Bereitstellung auf. Stellen Sie sicher, dass der Zugriff im VNet auf die folgenden wichtigen Azure-Dienste, die für die richtige Funktionsweise von Managed Cassandra erforderlich sind, nicht blockiert ist. Ausführlichere Informationen finden Sie unter Erforderliche Netzwerkregeln für ausgehenden Datenverkehr.

    • Azure Storage
    • Azure Key Vault
    • Skalierungsgruppen für virtuelle Azure-Computer
    • Azure-Überwachung
    • Azure Active Directory
    • Azure Security
  5. Wählen Sie als Nächstes die Registerkarte Rechenzentrum aus.

  6. Geben Sie die folgenden Details ein:

    • Rechenzentrumsname: Geben Sie in das Textfeld einen Namen für das Rechenzentrum ein.
    • Verfügbarkeitszone: Aktivieren Sie dieses Kontrollkästchen, wenn Verfügbarkeitszonen aktiviert werden sollen.
    • SKU-Größe: Wählen Sie eine der verfügbaren VM-SKU-Größen aus.
    • Nein. No. of disks (Anzahl der Datenträger): Wählen Sie die Anzahl der P30-Datenträger aus, die an jeden Cassandra-Knoten angefügt werden sollen.
    • Nein. No. of nodes (Anzahl der Knoten): Wählen Sie die Anzahl der Cassandra-Knoten aus, die in diesem Rechenzentrum bereitgestellt werden.

    Überprüfen der Zusammenfassung, um das Rechenzentrum zu erstellen

    Warnung

    Verfügbarkeitszonen werden nicht in allen Regionen unterstützt. Bereitstellungen sind nicht erfolgreich, wenn Sie eine Region auswählen, in der Verfügbarkeitszonen nicht unterstützt werden. Informationen zu den unterstützten Regionen finden Sie hier. Die erfolgreiche Bereitstellung von Verfügbarkeitszonen unterliegt auch der Verfügbarkeit von Computeressourcen in allen Zonen in der angegebenen Region. Bei Bereitstellungen kann ein Fehler auftreten, wenn die von Ihnen ausgewählte SKU oder Kapazität nicht in allen Zonen verfügbar ist.

  7. Klicken Sie als Nächstes auf Überprüfen und erstellen>Erstellen.

    Hinweis

    Es kann bis zu 15 Minuten dauern, bis der Cluster erstellt ist.

    Überprüfen der Zusammenfassung, um den Cluster zu erstellen.

  8. Nachdem die Bereitstellung abgeschlossen ist, aktivieren Sie Ihre Ressourcengruppe, um den neu erstellten Managed Instance-Cluster anzuzeigen:

    Übersichtsseite nach dem Erstellen des Clusters.

  9. Navigieren Sie zum Durchsuchen der Clusterknoten zur Clusterressource, und öffnen Sie den Bereich Rechenzentrum, um sie anzuzeigen:

    Screenshot der Rechenzentrumsknoten.

Skalieren eines Rechenzentrums

  1. Nachdem Sie nun einen Cluster mit einem einzelnen Rechenzentrum bereitgestellt haben, können Sie die Knoten nach oben oder unten skalieren, indem Sie das Rechenzentrum hervorheben und die Scale-Schaltfläche auswählen:

    Screenshot der Skalierung der Rechenzentrumsknoten.

  2. Verschieben Sie als Nächstes den Schieberegler auf die gewünschte Zahl, oder bearbeiten Sie einfach den Wert. Wenn Sie fertig sind, wählen Sie Scale aus.

    Screenshot des Auswählens der Anzahl der Rechenzentrumsknoten.

    Hinweis

    Wie lange es dauert, bis die Knoten skaliert sind, hängt von verschiedenen Faktoren ab; es kann mehrere Minuten dauern. Wenn Azure Ihnen mitteilt, dass der Skalierungsvorgang abgeschlossen ist, bedeutet dies nicht, dass alle Ihre Knoten dem Cassandra-Ring beigetreten sind. Knoten werden vollständig in Betrieb genommen, wenn alle den Status „fehlerfrei“ haben und der Rechenzentrumsstatus „erfolgreich“ ist.

Hinzufügen eines Rechenzentrums

  1. Wenn Sie ein anderes Rechenzentrum hinzufügen möchten, klicken Sie im Bereich Rechenzentrum auf die Schaltfläche „Hinzufügen“:

    Screenshot des Hinzufügens eines Rechenzentrums.

    Warnung

    Wenn Sie ein Rechenzentrum in einer anderen Region hinzufügen, müssen Sie ein anderes virtuelles Netzwerk auswählen. Sie müssen auch sicherstellen, dass dieses virtuelle Netzwerk über eine Verbindung mit dem virtuellen Netzwerk der primären Region verfügt, das oben erstellt wurde (und allen anderen virtuellen Netzwerken, die Rechenzentren im Cluster der verwalteten Instanz hosten). Lesen Sie sich diesen Artikel durch, um mehr über das Peering virtueller Netzwerke mithilfe des Azure-Portals zu erfahren. Außerdem müssen Sie sicherstellen, dass Sie die entsprechende Rolle auf Ihr virtuelles Netzwerk angewendet haben, bevor Sie versuchen, einen Cluster der verwalteten Instanz mithilfe des folgenden CLI-Befehls bereitzustellen.

        az role assignment create \
        --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \
        --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \
        --scope /subscriptions/<subscriptionID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>
    
  2. Füllen Sie die entsprechenden Felder aus:

    • Datacenter name (Name des Rechenzentrums): Wählen Sie in der Dropdownliste Ihr Azure-Abonnement aus.
    • Verfügbarkeitszone: Aktivieren Sie dieses Kontrollkästchen, wenn Verfügbarkeitszonen in diesem Rechenzentrum aktiviert werden sollen.
    • Speicherort: Der Speicherort, an dem das Rechenzentrum bereitgestellt wird.
    • SKU-Größe: Wählen Sie eine der verfügbaren VM-SKU-Größen aus.
    • Nein. No. of disks (Anzahl der Datenträger): Wählen Sie die Anzahl der P30-Datenträger aus, die an jeden Cassandra-Knoten angefügt werden sollen.
    • Nein. No. of nodes (Anzahl der Knoten): Wählen Sie die Anzahl der Cassandra-Knoten aus, die in diesem Rechenzentrum bereitgestellt werden.
    • Virtuelles Netzwerk: Wählen Sie ein vorhandenes virtuelles Netzwerk und ein Subnetz aus.

    Rechenzentrum hinzufügen.

    Warnung

    Beachten Sie, dass es beim Hinzufügen eines Rechenzentrums nicht erlaubt ist, ein neues virtuelles Netzwerk zu erstellen. Sie müssen ein vorhandenes virtuelles Netzwerk auswählen, und – wie oben erwähnt – sicherstellen, dass Konnektivität zwischen den Zielsubnetzen besteht, in denen Rechenzentren bereitgestellt werden. Sie müssen auch die entsprechende Rolle auf das VNet anwenden, um die Bereitstellung zu ermöglichen (siehe oben).

  3. Wenn das Rechenzentrum bereitgestellt wird, sollten Sie alle Rechenzentrumsinformationen im Bereich Rechenzentrum anzeigen können:

    Anzeigen der Clusterressourcen.

Aktualisieren der Cassandra-Konfiguration

Der Dienst ermöglicht die Aktualisierung auf eine Cassandra-YAML-Konfiguration in einem Rechenzentrum über das Portal oder mittels CLI-Befehlen. So aktualisieren Sie Einstellungen im Portal

  1. Suchen Sie in den „Einstellungen“ nach Cassandra Configuration. Markieren Sie das Rechenzentrum, dessen Konfiguration Sie ändern möchten, und klicken Sie auf „Aktualisieren“:

    Screenshot des ausgewählten Rechenzentrums für die Aktualisierung der Konfiguration.

  2. Geben Sie im daraufhin geöffneten Fenster die Feldnamen im YAML-Format ein, wie unten gezeigt. Klicken Sie dann auf „Aktualisieren“.

    Screenshot des Aktualisierens der Cassandra-Rechenzentrumskonfiguration.

  3. Wenn die Aktualisierung abgeschlossen ist, werden die überschriebenen Werte im Bereich Cassandra Configuration angezeigt:

    Screenshot der aktualisierten Cassandra-Konfiguration.

    Hinweis

    Nur überschriebene Cassandra-Konfigurationswerte werden im Portal angezeigt.

    Wichtig

    Stellen Sie sicher, dass die von Ihnen bereitgestellten Cassandra-YAML-Einstellungen für die von Ihnen bereitgestellte Version von Cassandra geeignet sind. Cassandra v3.11-Einstellungen finden Sie hier und v4.0-Einstellungen hier. Die folgenden YAML-Einstellungen dürfen nicht aktualisiert werden:

    • cluster_name
    • seed_provider
    • initial_token
    • autobootstrap
    • client_ecncryption_options
    • server_encryption_options
    • transparent_data_encryption_options
    • audit_logging_options
    • authenticator
    • authorizer
    • role_manager
    • storage_port
    • ssl_storage_port
    • native_transport_port
    • native_transport_port_ssl
    • listen_address
    • listen_interface
    • broadcast_address
    • hints_directory
    • data_file_directories
    • commitlog_directory
    • cdc_raw_directory
    • saved_caches_directory

Problembehandlung

Wenn beim Anwenden von Berechtigungen für Ihre Virtual Network-Instanz mithilfe der Azure CLI ein Fehler mit dem Hinweis auftritt, dass der Benutzer oder Dienstprinzipal in der Graphdatenbank für „e5007d2c-4b13-4a74-9b6a-605d99f03501“ nicht gefunden werden kann, können Sie die gleiche Berechtigung manuell über das Azure-Portal anwenden. Informationen zur Vorgehensweise finden Sie hier.

Hinweis

Die Azure Cosmos DB-Rollenzuweisung wird nur für Bereitstellungszwecke verwendet. Azure Managed Instance for Apache Cassandra verfügt über keine Back-End-Abhängigkeiten von Azure Cosmos DB.

Herstellen einer Verbindung mit Ihrem Cluster

Azure Managed Instance for Apache Cassandra erstellt keine Knoten mit öffentlichen IP-Adressen. Um also eine Verbindung mit dem neu erstellten Cassandra-Cluster herzustellen, müssen Sie eine weitere Ressource im VNET erstellen. Dabei kann es sich um eine Anwendung handeln oder einen virtuellen Computer, auf dem das Open-Source-Abfragetool CQLSH von Apache installiert ist. Sie können eine Vorlage verwenden, um einen virtuellen Ubuntu-Computer bereitzustellen. Stellen Sie nach der Bereitstellung mithilfe von SSH eine Verbindung mit dem Computer her, und installieren Sie CQLSH mithilfe der folgenden Befehle:

# Install default-jre and default-jdk
sudo apt update
sudo apt install openjdk-8-jdk openjdk-8-jre

# Install the Cassandra libraries in order to get CQLSH:
echo "deb http://www.apache.org/dist/cassandra/debian 311x main" | sudo tee -a /etc/apt/sources.list.d/cassandra.sources.list
curl https://downloads.apache.org/cassandra/KEYS | sudo apt-key add -
sudo apt-get update
sudo apt-get install cassandra

# Export the SSL variables:
export SSL_VERSION=TLSv1_2
export SSL_VALIDATE=false

# Connect to CQLSH (replace <IP> with the private IP addresses of a node in your Datacenter):
host=("<IP>")
initial_admin_password="Password provided when creating the cluster"
cqlsh $host 9042 -u cassandra -p $initial_admin_password --ssl

Bereinigen von Ressourcen

Falls Sie diesen Managed Instance-Cluster nicht mehr benötigen, löschen Sie ihn wie folgt:

  1. Wählen Sie im linken Menü des Azure-Portals die Option Ressourcengruppen aus.
  2. Wählen Sie in der Liste die Ressourcengruppe aus, die Sie für diesen Schnellstart erstellt haben.
  3. Wählen Sie im Ressourcengruppenbereich Übersicht die Option Ressourcengruppe löschen aus.
  4. Geben Sie in dem nächsten Fenster den Namen der zu löschenden Ressourcengruppe ein, und wählen Sie dann Löschen aus.

Nächste Schritte

In dieser Schnellstartanleitung haben Sie erfahren, wie Sie mithilfe des Azure-Portals eine Azure Managed Instance-Instanz für einen Apache Cassandra-Cluster erstellen. Sie können jetzt beginnen, mit dem Cluster zu arbeiten.