Rövid útmutató: Többrégiós fürt létrehozása az Apache Cassandra Felügyelt Azure-példányával

Az Apache Cassandra Azure Managed Instance egy teljesen felügyelt szolgáltatás tiszta nyílt forráskódú Apache Cassandra-fürtökhöz. A szolgáltatás lehetővé teszi a konfigurációk felül bírálását az egyes számítási feladatok adott igényeitől függően a maximális rugalmasság és szabályozás érdekében.

Ez a rövid útmutató bemutatja, hogyan konfigurálhat többrégiós fürtöt az Azure-ban az Azure CLI-parancsokkal.

Előfeltételek

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: Az Azure Cloud Shell használatának első lépései.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd: Hitelesítés az Azure-ba az Azure CLI használatával.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata és kezelése az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

• Ez a cikk az Azure CLI 2.30.0-s vagy újabb verzióját igényli. Ha Az Azure Cloud Shellt használja, a legújabb verzió már telepítve van.
• Azure-beli virtuális hálózat használata saját üzemeltetésű vagy helyszíni környezethez való kapcsolódással. A helyszíni környezetek Azure-hoz való csatlakoztatásáról további információt a Helyszíni hálózat csatlakoztatása az Azure-hoz című témakörben talál.

A hálózati környezet beállítása

Mivel a szolgáltatással kiépített összes adatközpontot virtuális hálózatinjektálással a dedikált alhálózatokban kell üzembe helyezni, az üzembe helyezés előtt konfigurálja a megfelelő hálózati összekapcsolást. Ebben a rövid útmutatóban hozzon létre egy fürtöt két adatközponttal külön régiókban: az USA keleti régiójában és az USA 2. keleti régiójában. Először hozza létre az egyes régiókhoz tartozó virtuális hálózatokat.

1. Jelentkezzen be az Azure Portalra.

2. Hozzon létre egy erőforráscsoportot:cassandra-mi-multi-region

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

3. Hozza létre az első virtuális hálózatot az USA 2. keleti régiójában egy dedikált alhálózattal:

   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. Hozza létre a második virtuális hálózatot az USA keleti régiójában egy dedikált alhálózattal is:

    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
   

   Kifejezetten különböző IP-címtartományokat adunk hozzá, hogy biztosan ne legyenek hibák a peering során.

5. Társítsd az első virtuális hálózatot a második virtuális hálózattal.

   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. A két virtuális hálózat összekapcsolásához hozzon létre egy másik társviszonyt a második virtuális hálózat és az első között:

   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
   

   Ha további régiókat ad hozzá, minden virtuális hálózatnak kapcsolatot kell létesítenie az összes többi virtuális hálózattal, és az összes többi virtuális hálózatnak vele.

7. Ellenőrizze az előző parancs kimenetét. Győződjön meg arról, hogy az érték peeringState most van Connected. Ezt az eredményt a következő parancs futtatásával is ellenőrizheti:

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

8. Speciális engedélyek alkalmazása mindkét virtuális hálózatra. Az Apache Cassandra felügyelt Azure-példányához ezek az engedélyek szükségesek. Futtassa az alábbi parancsot. Cserélje le <SubscriptionID> az előfizetés azonosítóját:

   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
   

   Az assignee előző parancs értékei rögzített role értékek. Adja meg ezeket az értékeket pontosan a parancsban látható módon.

Ha a futtatás az role assignment createsorán hibákba ütközik, előfordulhat, hogy nem rendelkezik a futtatáshoz szükséges engedélyekkel. Kérdezze meg a rendszergazdát, hogy van-e engedélye.

Többrégiós fürt létrehozása

1. Telepítse a fürterőforrást. Cserélje le <Subscription ID> az előfizetés azonosítóját. Az üzembe helyezés 5–10 percet is igénybe vehet.

   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. A klaszter erőforrás létrehozása után készen áll az adatközpont létrehozására. Először hozzon létre egy adatközpontot az USA 2. keleti régiójában. Cserélje le <SubscriptionID> az előfizetés azonosítóját. Ez a művelet akár 10 percet is igénybe vehet.

   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. Adatközpont létrehozása az USA keleti régiójában. Cserélje le <SubscriptionID> az előfizetés azonosítóját:

   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
   

   A következő elérhető termékszintek közül választhatja ki az értéket --sku :

   • 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

   Jegyezze fel azt is, hogy --availability-zone be van állítva false. A rendelkezésre állási zónák engedélyezéséhez állítsa be a következőre true: . A rendelkezésre állási zónák növelik a szolgáltatás rendelkezésre állási szintjének megállapodását (SLA). További információkért tekintse meg az Apache Cassandra Azure Managed Instance szolgáltatásszintű szerződését.

   A rendelkezésre állási zónák nem minden régióban támogatottak. Az üzembe helyezés sikertelen, ha olyan régiót választ ki, ahol a rendelkezésre állási zónák nem támogatottak. A támogatott régiókkal kapcsolatban tekintse meg a rendelkezésre állási zónákkal rendelkező Azure-régiókat.

   A rendelkezésre állási zónák sikeres üzembe helyezésének feltétele a számítási erőforrások rendelkezésre állása is az adott régió összes zónájában. Az üzembe helyezés meghiúsulhat, ha a kiválasztott termékszint vagy kapacitás nem érhető el az összes zónában.

4. A második adatközpont létrehozása után kérje le a csomópont állapotát annak ellenőrzéséhez, hogy az összes Cassandra-csomópont sikeresen létrejött-e:

   resourceGroupName='cassandra-mi-multi-region'
   clusterName='test-multi-region'
   
   az managed-cassandra cluster status\
      --cluster-name $clusterName \
      --resource-group $resourceGroupName
   

5. Ezután a CQLSH használatával csatlakozzon a fürthöz. A következő CQL-lekérdezés használatával módosítsa az egyes kulcsterek mindegyikének replikációs stratégiáját, hogy tartalmazza az összes adatközpontot a fürtben (a rendszertáblák automatikusan frissítődnek).

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

6. Végül, ha olyan fürthöz ad hozzá adatközpontot, amely már tartalmaz adatokat, futtatnia rebuild kell az előzményadatok replikálásához. Ebben az esetben tegyük fel, hogy az dc-eastus2 adatközpont már rendelkezik adatokkal. Az Azure CLI-ben futtassa az alábbi parancsot a dc-eastus adatközpont minden csomópontján: nodetool rebuild. Cserélje le <ip address> a csomópont IP-címére:

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

   A kulcstérreplikáció módosításainak alkalmazása után ne engedélyezze az alkalmazás-ügyfeleknek az új adatközpontba való írást. Ellenkező esetben az újraépítés nem működik. Ezután létre kell hoznia egy támogatási kérést, hogy csapatunk végrehajtsa a repair az Ön számára.

Hibaelhárítás

Ha hibaüzenet jelenik meg, amikor engedélyeket alkalmaz a virtuális hálózatra az Azure CLI használatával, ugyanezt az engedélyt manuálisan is alkalmazhatja az Azure Portalon. Egy példahiba a következő lehet: "Nem található felhasználó vagy szolgáltatásnév a gráfadatbázisban a következőhöz e5007d2c-4b13-4a74-9b6a-605d99f03501: ." További információ: Azure Cosmos DB-szolgáltatásnév hozzáadása az Azure Portalon.

Az Azure Cosmos DB szerepkör-hozzárendelése csak üzembe helyezési célokra használható. Az Azure Managed Instanced for Apache Cassandra nem rendelkezik háttérfüggőségekkel az Azure Cosmos DB-hez.

Az erőforrások eltávolítása

Ha nem kívánja tovább használni ezt a felügyelt példányfürtöt, kövesse az alábbi lépéseket annak törléséhez:

1. Az Azure Portal bal oldali menüjében válassza az Erőforráscsoportok lehetőséget.
2. A listából válassza ki a rövid útmutatóhoz létrehozott erőforráscsoportot.
3. Az Erőforráscsoport áttekintése panelen válassza az Erőforráscsoport törlése lehetőséget.
4. A következő panelen adja meg a törölni kívánt erőforráscsoport nevét, majd válassza a Törlés lehetőséget.

Következő lépés

Ebben a gyorsútmutatóban megtanulta, hogyan hozhat létre egy többrégiós klasztert az Azure CLI és az Azure Managed Instance használatával az Apache Cassandra-hoz. Most már megkezdheti a fürttel való munkát.

Felügyelt Azure-példány kezelése Apache Cassandra-erőforrásokhoz az Azure CLI használatával