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

Cikk
03/13/2024

Ez a cikk az Apache Cassandra-fürtökhöz és adatközpontokhoz készült Felügyelt Azure-példány felügyeletének automatizálására szolgáló gyakori parancsokat ismerteti az Azure CLI használatával.

Előfeltételek

Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
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 : Bejelentkezés az Azure CLI-vel.
- 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 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.

Fontos

Az Apache Cassandra-erőforrások felügyelt Azure-példányának kezelése nem nevezhető át. Az erőforrások átnevezése sérti az Azure Resource Manager erőforrás-URI-kkal való működését.

Fürtök kezelése

Az alábbi szakaszok bemutatják, hogyan kezelheti az Azure Managed Instance for Apache Cassandra-fürtöket:

Fürt létrehozása
Fürt törlése
Fürt részleteinek lekérése
A fürtcsomópont állapotának lekérése
Fürtök listázása erőforráscsoport szerint
Fürtök listázása előfizetés-azonosító szerint

Fürt létrehozása

Azure Managed Instance for Apache Cassandra-fürt létrehozása az az managed-cassandra cluster create paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
location='West US'
delegatedManagementSubnetId='/subscriptions/<subscription id>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/management'
initialCassandraAdminPassword='myPassword'

# You can override the cluster name if the original name is not legal for an Azure resource:
# overrideClusterName='ClusterNameIllegalForAzureResource'
# The default Cassandra version is v3.11

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

Fürt törlése

Fürt törlése az az managed-cassandra cluster delete paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

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

Fürt részleteinek lekérése

Fürtadatok lekérése az az managed-cassandra fürtmegjelenítési paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'

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

A fürtcsomópont állapotának lekérése

A fürtcsomópontok állapotának lekérése az az managed-cassandra fürtcsomópont-állapot parancs használatával:

clusterName='cassandra-hybrid-cluster'
resourceGroupName='MyResourceGroup'

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

Fürtök listázása erőforráscsoport szerint

Fürtök listázása erőforráscsoport szerint az az managed-cassandra fürtlista parancs használatával:

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

az managed-cassandra cluster list\
    --resource-group $resourceGroupName

Fürtök listázása előfizetés-azonosító szerint

Fürtök listázása előfizetés-azonosító alapján az az managed-cassandra fürtlista parancs használatával:

# Set your subscription ID
az account set -s <subscriptionID>

az managed-cassandra cluster list

Adatközpontok kezelése

Az alábbi szakaszok bemutatják, hogyan kezelheti az Azure Managed Instance for Apache Cassandra-adatközpontokat:

Adatközpont létrehozása
Adatközpont törlése
Adatközpont részleteinek lekérése
Adatközpontok lekérése fürtön
Adatközpont frissítése vagy méretezése
A Cassandra konfigurációjának lekérése
A Cassandra konfigurációjának frissítése

Adatközpont létrehozása

Adatközpont létrehozása az az managed-cassandra datacenter create paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus2'
delegatedSubnetId='/subscriptions/<SubscriptionID>/resourceGroups/customer-vnet-rg/providers/Microsoft.Network/virtualNetworks/customer-vnet/subnets/dc1-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 $delegatedSubnetId \
    --node-count 3 
    --sku $virtualMachineSKU \
    --disk-capacity $noOfDisksPerNode \
    --availability-zone false

Válassza ki a következő virtuálisgép-beállítások értékét --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
Standard_L8s_v3
Standard_L16s_v3
Standard_L32s_v3
Standard_L8as_v3
Standard_L16as_v3
Standard_L32as_v3

Az Apache Cassandra Azure Managed Instance jelenleg nem támogatja a virtuálisgép-családok közötti váltást. Ha például jelenleg Standard_DS13_v2 virtuális gépe van, és nagyobb virtuális gépre szeretne frissíteni, például Standard_DS14_v2, ez a lehetőség nem érhető el. A frissítés igényléséhez azonban megnyithat egy támogatási jegyet.

Az előző parancs --availability-zone a következőre falsevan állítva: . A rendelkezésre állási zónák engedélyezéséhez állítsa ezt az értéket a következőre true: . A rendelkezésre állási zónák növelik a szolgáltatás rendelkezésre állására vonatkozó szolgáltatásiszint-szerződést (SLA). További információkért tekintse át az SLA teljes részleteit.

Figyelmeztetés

Az Apache Cassandra Azure Managed Instance nem támogatja a rendelkezésre állási zónákat minden régióban. Ha olyan régiót választ ki, ahol a rendelkezésre állási zónák nem támogatottak, az üzembe helyezés sikertelen lesz. Tekintse meg a támogatott régiók listáját.

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 a régió összes zónájában. Az üzembe helyezés meghiúsulhat, ha a virtuális gép vagy a kiválasztott kapacitás nem érhető el az összes zónában.

Adatközpont törlése

Adatközpont törlése az az managed-cassandra datacenter delete paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter delete \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName

Figyelmeztetés

Ha egynél több adatközpont van a fürtben, először el kell távolítania a törölni kívánt adatközpontra mutató hivatkozásokat a kulcstérreplikációs stratégia beállításai között. Ez a parancs sikertelen lesz, ha a fürtben lévő kulcsterek továbbra is hivatkoznak az adatközpontra.

Adatközpont részleteinek lekérése

Az adatközpont adatainak lekérése az az managed-cassandra datacenter show paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter show \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName

Adatközpont frissítése vagy méretezése

Adatközpont frissítése vagy méretezése az az managed-cassandra datacenter update paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'

az managed-cassandra datacenter update \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --node-count 13

Az adatközpontok méretezéséhez módosítsa az --node-count értéket.

A Cassandra konfigurációjának lekérése

A csomópont aktuális YAML-konfigurációjának lekérése az az managed-cassandra cluster invoke-command paranccsal:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
commandName='get-cassandra-yaml'
 
az managed-cassandra cluster invoke-command \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --host <ip address> \
    --command-name 'get-cassandra-yaml'

A kimenet olvashatóbbá teheti a következő parancsokkal:

$output = az managed-cassandra cluster invoke-command \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --host <ip address> \
    --command-name 'get-cassandra-yaml' \
    | ConvertFrom-Json
$output.commandOutput

A Cassandra konfigurációjának frissítése

Az az managed-cassandra datacenter update paranccsal módosítsa a Cassandra konfigurációját egy adatközponton. A YAML-töredéket egy online eszközzel kell kódolnia a Base64-nek.

Vegyük például a következő YAML-töredéket:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

Kódoláskor a YAML a következővé lesz konvertálva: Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA==.

Íme a az managed-cassandra datacenter update kódolt YAML-töredékkel rendelkező parancs:

resourceGroupName='MyResourceGroup'
clusterName='cassandra-hybrid-cluster'
dataCenterName='dc1'
dataCenterLocation='eastus'
yamlFragment='Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA=='

az managed-cassandra datacenter update \
    --resource-group $resourceGroupName \
    --cluster-name $clusterName \
    --data-center-name $dataCenterName \
    --base64-encoded-cassandra-yaml-fragment $yamlFragment