Condividi tramite

Guida introduttiva: Creare un cluster in più aree con Istanza gestita di Azure per Apache Cassandra

Istanza gestita di Azure per Apache Cassandra è un servizio completamente gestito per cluster Apache Cassandra open source puri. Il servizio consente anche di eseguire l'override delle configurazioni, a seconda delle esigenze specifiche di ogni carico di lavoro, per la massima flessibilità e controllo.

Questa guida introduttiva descrive come usare i comandi dell'interfaccia della riga di comando di Azure per configurare un cluster in più aree in Azure.

Prerequisiti

  • Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.30.0 o successiva. Se si sta usando Azure Cloud Shell, la versione più recente è già installata.
  • Usa una rete virtuale di Azure con connettività all'ambiente autogestito o locale. Per altre informazioni su come connettere gli ambienti locali ad Azure, vedere Connettere una rete locale ad Azure.

Configurare l'ambiente di rete

Poiché tutti i data center di cui è stato effettuato il provisioning con questo servizio devono essere distribuiti in subnet dedicate usando l'inserimento della rete virtuale, è necessario configurare il peering di rete appropriato prima della distribuzione. Per questa guida introduttiva, creare un cluster con due data center in aree separate: Stati Uniti orientali e Stati Uniti orientali 2. Creare prima di tutto le reti virtuali per ogni area.

  1. Accedere al portale di Azure.

  2. Creare un gruppo di risorse denominato cassandra-mi-multi-region:

    az group create --location eastus2 --name cassandra-mi-multi-region

  3. Creare la prima rete virtuale negli Stati Uniti orientali 2 con una subnet dedicata:

    az network vnet create \
  --name vnetEastUs2 \
  --location eastus2 \
  --resource-group cassandra-mi-multi-region \
  --address-prefix 10.0.0.0/16 \
  --subnet-name dedicated-subnet

  4. Creare la seconda rete virtuale negli Stati Uniti orientali, anche con una subnet dedicata:

     az network vnet create \
   --name vnetEastUs \
   --location eastus \
   --resource-group cassandra-mi-multi-region \
   --address-prefix 192.168.0.0/16 \
   --subnet-name dedicated-subnet

    Vengono aggiunti in modo esplicito intervalli di indirizzi IP diversi per assicurarsi che non siano presenti errori con il peering.

  5. Collegare la prima rete virtuale alla seconda.

    az network vnet peering create \
  --resource-group cassandra-mi-multi-region \
  --name MyVnet1ToMyVnet2 \
  --vnet-name vnetEastUs2 \
  --remote-vnet vnetEastUs \
  --allow-vnet-access \
  --allow-forwarded-traffic

  6. Per connettere le due reti virtuali, creare un altro peering tra la seconda rete virtuale e la prima:

    az network vnet peering create \
  --resource-group cassandra-mi-multi-region \
  --name MyVnet2ToMyVnet1 \
  --vnet-name vnetEastUs \
  --remote-vnet vnetEastUs2 \
  --allow-vnet-access \
  --allow-forwarded-traffic

    Se si aggiungono altre regioni, ogni rete virtuale richiede il peering da essa verso tutte le altre reti virtuali e il peering da tutte le altre reti virtuali verso di essa.

  7. Controllare l'output del comando precedente. Assicurarsi che il valore di peeringState sia ora Connected. È anche possibile controllare questo risultato eseguendo il comando seguente:

    az network vnet peering show \
  --name MyVnet1ToMyVnet2 \
  --resource-group cassandra-mi-multi-region \
  --vnet-name vnetEastUs2 \
  --query peeringState

  8. Applicare alcune autorizzazioni speciali a entrambe le reti virtuali. Istanza gestita di Azure per Apache Cassandra richiede queste autorizzazioni. Eseguire il comando seguente. Sostituire <SubscriptionID> con l'ID sottoscrizione:

    az role assignment create \
  --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \
  --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \
  --scope /subscriptions/<SubscriptionID>/resourceGroups/cassandra-mi-multi-region/providers/Microsoft.Network/virtualNetworks/vnetEastUs2

az role assignment create     \
  --assignee a232010e-820c-4083-83bb-3ace5fc29d0b \
  --role 4d97b98b-1d4f-4787-a291-c67834d212e7 \
  --scope /subscriptions/<SubscriptionID>/resourceGroups/cassandra-mi-multi-region/providers/Microsoft.Network/virtualNetworks/vnetEastUs

    I valori assignee e role nel comando precedente sono valori fissi. Immettere questi valori esattamente come illustrato nel comando .

Se si verificano errori durante l'esecuzione di az role assignment create, è possibile che non si disponga delle autorizzazioni necessarie per l'esecuzione. Rivolgersi all'amministratore per ottenere le autorizzazioni.

Creare un cluster in più aree

  1. Distribuire la risorsa cluster. Sostituire <Subscription ID> con l'ID della sottoscrizione. La distribuzione può richiedere da 5 a 10 minuti.

    resourceGroupName='cassandra-mi-multi-region'
clusterName='test-multi-region'
location='eastus2'
delegatedManagementSubnetId='/subscriptions/<SubscriptionID>/resourceGroups/cassandra-mi-multi-region/providers/Microsoft.Network/virtualNetworks/vnetEastUs2/subnets/dedicated-subnet'
initialCassandraAdminPassword='myPassword'

 az managed-cassandra cluster create \
   --cluster-name $clusterName \
   --resource-group $resourceGroupName \
   --location $location \
   --delegated-management-subnet-id $delegatedManagementSubnetId \
   --initial-cassandra-admin-password $initialCassandraAdminPassword \
   --debug

  2. Dopo aver creato la risorsa cluster, si è pronti per creare un data center. Creare prima di tutto un data center negli Stati Uniti orientali 2. Sostituire <SubscriptionID> con l'ID della sottoscrizione. Questa azione può richiedere fino a 10 minuti.

    resourceGroupName='cassandra-mi-multi-region'
clusterName='test-multi-region'
dataCenterName='dc-eastus2'
dataCenterLocation='eastus2'
delegatedManagementSubnetId='/subscriptions/<SubscriptionID>/resourceGroups/cassandra-mi-multi-region/providers/Microsoft.Network/virtualNetworks/vnetEastUs2/subnets/dedicated-subnet'

 az managed-cassandra datacenter create \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --data-center-location $dataCenterLocation \
    --delegated-subnet-id $delegatedManagementSubnetId \
    --node-count 3

  3. Creare un data center negli Stati Uniti orientali. Sostituire <SubscriptionID> con l'ID sottoscrizione:

    resourceGroupName='cassandra-mi-multi-region'
clusterName='test-multi-region'
dataCenterName='dc-eastus'
dataCenterLocation='eastus'
delegatedManagementSubnetId='/subscriptions/<SubscriptionID>/resourceGroups/cassandra-mi-multi-region/providers/Microsoft.Network/virtualNetworks/vnetEastUs/subnets/dedicated-subnet'
virtualMachineSKU='Standard_D8s_v4'
noOfDisksPerNode=4

 az managed-cassandra datacenter create \
   --resource-group $resourceGroupName \
   --cluster-name $clusterName \
   --data-center-name $dataCenterName \
   --data-center-location $dataCenterLocation \
   --delegated-subnet-id $delegatedManagementSubnetId \
   --node-count 3
   --sku $virtualMachineSKU \
   --disk-capacity $noOfDisksPerNode \
   --availability-zone false

    È possibile scegliere il valore per --sku dai livelli di prodotto disponibili seguenti:

    • Standard_E8s_v4
    • Standard_E16s_v4
    • Standard_E20s_v4
    • Standard_E32s_v4
    • Standard_DS13_v2
    • Standard_DS14_v2
    • Standard_D8s_v4
    • Standard_D16s_v4
    • Standard_D32s_v4

    Notare anche che --availability-zone è impostata su false. Per abilitare le zone di disponibilità, impostarla su true. Le zone di disponibilità aumentano l'accordo sul livello di servizio (SLA) del servizio. Per altre informazioni, vedere Contratti a livello di servizio per Istanza gestita di Azure per Apache Cassandra.

    Le zone di disponibilità non sono supportate in tutte le aree. Le distribuzioni hanno esito negativo se si seleziona un'area in cui le zone di disponibilità non sono supportate. Per le aree supportate, vedere Aree di Azure con zone di disponibilità.

    La corretta distribuzione delle zone di disponibilità è soggetta anche alla disponibilità delle risorse di calcolo in tutte le zone dell'area specifica. Le distribuzioni potrebbero non riuscire se il livello di prodotto selezionato o la capacità non è disponibile in tutte le zone.

  4. Dopo aver creato il secondo data center, controllare lo stato del nodo per verificare che tutti i nodi Cassandra si siano avviati correttamente.

    resourceGroupName='cassandra-mi-multi-region'
clusterName='test-multi-region'

az managed-cassandra cluster status\
   --cluster-name $clusterName \
   --resource-group $resourceGroupName

  5. Usare quindi CQLSH per connettersi al cluster. Usare la query CQL seguente per aggiornare la strategia di replica in ogni keyspace in modo da includere tutti i data center nel cluster (le tabelle di sistema vengono aggiornate automaticamente):

    ALTER KEYSPACE "ks" WITH REPLICATION = {'class': 'NetworkTopologyStrategy', 'dc-eastus2': 3, 'dc-eastus': 3};

  6. Infine, se si aggiunge un data center a un cluster che contiene già dati, è necessario eseguire rebuild per replicare i dati cronologici. In questo caso, si supponga che il dc-eastus2 data center disponga già di dati. Nell'interfaccia della riga di comando di Azure eseguire il comando seguente per eseguire nodetool rebuild in ogni nodo del nuovo dc-eastus data center. Sostituire <ip address> con l'indirizzo IP del nodo:

    az managed-cassandra cluster invoke-command \
  --resource-group $resourceGroupName \
  --cluster-name $clusterName \
  --host <ip address> \
  --command-name nodetool --arguments rebuild="" "dc-eastus2"=""

    Non consentire ai client dell'applicazione di scrivere nel nuovo data center fino a quando non si applicano modifiche alla replica keyspace. In caso contrario, la ricompilazione non funziona. È quindi necessario creare una richiesta di supporto così che la nostra squadra possa eseguire repair per te.

Risoluzione dei problemi

Se si verifica un errore quando si applicano autorizzazioni alla rete virtuale usando l'interfaccia della riga di comando di Azure, è possibile applicare manualmente la stessa autorizzazione dal portale di Azure. Un errore di esempio potrebbe essere "Non è possibile trovare l'utente o l'entità servizio nel database a grafo per e5007d2c-4b13-4a74-9b6a-605d99f03501". Per altre informazioni, vedere Usare il portale di Azure per aggiungere un'entità servizio di Azure Cosmos DB.

L'assegnazione di ruolo di Azure Cosmos DB viene usata solo ai fini della distribuzione. Istanza gestita di Azure per Apache Cassandra non dispone di dipendenze back-end in Azure Cosmos DB.

Pulire le risorse

Se non si intende continuare a usare questo cluster di istanza gestita, seguire questa procedura per eliminarlo:

  1. Nel menu a sinistra del portale di Azure, selezionare Gruppi di risorse.
  2. Nell'elenco selezionare il gruppo di risorse creato per questa guida introduttiva.
  3. Nel riquadro Panoramica del gruppo di risorse selezionare Elimina gruppo di risorse.
  4. Nel riquadro successivo immettere il nome del gruppo di risorse da eliminare e quindi selezionare Elimina.

Passo successivo

In questo avvio rapido, si è appreso come creare un cluster in più aree usando l'interfaccia della riga di comando di Azure e Azure Managed Instance per Apache Cassandra. È ora possibile iniziare a usare il cluster.

Gestire le risorse di Istanza gestita di Azure per Apache Cassandra tramite l'interfaccia della riga di comando di Azure

  • Last updated on