Administración de recursos de Azure Managed Instance for Apache Cassandra mediante la CLI de Azure

En este artículo se describen los comandos comunes para automatizar la administración de Azure Managed Instance para clústeres de Apache Cassandra mediante la CLI de Azure.

Requisitos previos

• Use el entorno de Bash en Azure Cloud Shell.

  

• Si lo prefiere, instale la CLI de Azure para ejecutar sus comandos de referencia.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.

  • Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Azure Managed Instance para clústeres de Apache Cassandra

En las secciones siguientes se muestra cómo administrar clústeres de Azure Managed Instance for Apache Cassandra:

• Creación de un clúster de instancia administrada
• Eliminación de un clúster de instancia administrada
• Obtención de los detalles del clúster
• Obtención del estado del nodo de clúster
• Listado de clústeres por grupo de recursos
• Listado de clústeres por identificador de suscripción

Creación de un clúster de instancia administrada

Cree un clúster de Azure Managed Instance for Apache Cassandra con el comando az managed-cassandra cluster create:

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 \

Eliminación de un clúster de instancia administrada

Elimine un clúster con el comando az managed-cassandra cluster delete:

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

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

Obtención de los detalles del clúster

Obtenga los detalles del clúster con el comando az managed-cassandra cluster show:

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

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

Obtención del estado del nodo de clúster

Obtenga los detalles del clúster con el comando az managed-cassandra cluster node-status:

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

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

Listado de clústeres por grupo de recursos

Enumere los clústeres por grupo de recursos con el comando az managed-cassandra cluster list:

subscriptionId='MySubscriptionId'
resourceGroupName='MyResourceGroup'

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

Listado de clústeres por identificador de suscripción

Enumere los clústeres por id. de suscripción con el comando az managed-cassandra cluster list:

# set your subscription id
az account set -s <subscriptionID>

az managed-cassandra cluster list

Centros de datos de instancia administrada

En las secciones siguientes se muestra cómo administrar centro de datos de Azure Managed Instance for Apache Cassandra:

• Creación de un centro de datos
• Eliminación de un centro de datos
• Obtención de los detalles del centro de datos
• Obtención de centro de datos en un clúster
• Actualización o escalabilidad de un centro de datos
• Actualización de la configuración de Cassandra

Creación de un centro de datos

Cree un centro de datos con el comando az managed-cassandra datacenter create:

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'

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 

Eliminación de un centro de datos

Elimine un centro de datos con el comando az managed-cassandra datacenter delete:

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

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

Obtención de detalles del centro de datos

Obtenga los detalles del centro de datos con el comando az managed-cassandra datacenter show:

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

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

Actualización o escalabilidad de un centro de datos

Actualice o escale un centro de datos (para escalar cambie el valor de nodeCount) con el comando az managed-cassandra datacenter update:

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

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

Actualización de la configuración de Cassandra

Cambie la configuración de Cassandra en un centro de datos mediante el comando az managed-cassandra datacenter update. Deberá codificar el fragmento de YAML en base64 mediante una herramienta en línea. Se admiten los siguientes valores de configuración de YAML:

• column_index_size_in_kb
• compaction_throughput_mb_per_sec
• read_request_timeout_in_ms
• range_request_timeout_in_ms
• aggregated_request_timeout_in_ms
• write_request_timeout_in_ms
• internode_compression
• batchlog_replay_throttle_in_kb

Por ejemplo, el fragmento de YAML siguiente:

column_index_size_in_kb: 16
read_request_timeout_in_ms: 10000

Cuando se codifica, YAML se convierte en Y29sdW1uX2luZGV4X3NpemVfaW5fa2I6IDE2CnJlYWRfcmVxdWVzdF90aW1lb3V0X2luX21zOiAxMDAwMA==.

Observe a continuación:

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

Obtención de los centro de datos de un clúster

Obtenga los centros de datos de un clúster con el comando az managed-cassandra datacenter list:

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

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

Pasos siguientes

• Creación de un clúster de instancia administrada desde Azure Portal
• Implementación de un clúster de Apache Spark administrado con Azure Databricks