Compartir vía

Inicio rápido: Crear un clúster de núcleo virtual de Azure Cosmos DB for MongoDB mediante una plantilla de Bicep

  • Artículo

SE APLICA A: núcleo virtual de MongoDB

En este inicio rápido, creará un nuevo clúster de núcleo virtual de Azure Cosmos DB for MongoDB. Este clúster contiene todos los recursos de MongoDB: bases de datos, colecciones y documentos. El clúster ofrece un punto de conexión único para que varias herramientas y SDK se conecten a Azure Cosmos DB y realicen operaciones diarias.

Requisitos previos

Revisión del archivo de Bicep

El archivo de Bicep usado en este inicio rápido forma parte de las plantillas de inicio rápido de Azure.

@description('Azure Cosmos DB MongoDB vCore cluster name')
@maxLength(44)
param clusterName string = 'msdocs-${uniqueString(resourceGroup().id)}'

@description('Location for the cluster.')
param location string = resourceGroup().location

@description('Username for admin user')
param adminUsername string

@secure()
@description('Password for admin user')
@minLength(8)
@maxLength(128)
param adminPassword string

resource cluster 'Microsoft.DocumentDB/mongoClusters@2022-10-15-preview' = {
  name: clusterName
  location: location
  properties: {
    administratorLogin: adminUsername
    administratorLoginPassword: adminPassword
    nodeGroupSpecs: [
        {
            kind: 'Shard'
            shardCount: 1
            sku: 'M40'
            diskSizeGB: 128
            enableHa: false
        }
    ]
  }
}

resource firewallRules 'Microsoft.DocumentDB/mongoClusters/firewallRules@2022-10-15-preview' = {
  parent: cluster
  name: 'AllowAllAzureServices'
  properties: {
    startIpAddress: '0.0.0.0'
    endIpAddress: '0.0.0.0'
  }
}

Nota:

Tenga en cuenta que, en el código anterior, shardGroupSpecs se denomina nodeGroupSpecs.

En el archivo Bicep, se definen dos recursos de Azure:

Implementación del archivo de Bicep

Crear un clúster de núcleo virtual de Azure Cosmos DB for MongoDB mediante la plantilla de Bicep.

  1. Cree variables de shell para resourceGroupName y location

    # Variable for resource group name and location
resourceGroupName="msdocs-cosmos-quickstart-rg"
location="eastus"

  2. Si aún no lo ha hecho, inicie sesión en la CLI de Azure con el comando az login.

  3. Use el comando az group create para crear un nuevo grupo de recursos en la suscripción.

    az group create \
    --name $resourceGroupName \
    --location $location

  4. Use az deployment group create para implementar la plantilla de Bicep. A continuación, se le pedirá que escriba un valor para los parámetros adminUsername y adminPassword.

    az deployment group create \
    --resource-group $resourceGroupName \
    --template-file 'main.bicep'

    Sugerencia

    Como alternativa, use la opción --parameters para pasar un archivo de parámetros con valores predefinidos.

    az deployment group create \
    --resource-group $resourceGroupName \
    --template-file 'main.bicep' \
    --parameters @main.parameters.json

    Este archivo JSON de ejemplo inserta los valores clusteradmin y P@ssw.rd para los parámetros adminUsername y adminPassword, respectivamente.

    {
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "adminUsername": {
      "value": "clusteradmin"
    },
    "adminPassword": {
      "value": "P@ssw.rd"
    }
  }
}

  5. Espere a que la operación de implementación se complete antes de continuar.

Revisión de los recursos implementados

Enumere los recursos implementados por la plantilla de Bicep en el grupo de recursos de destino.

  1. Use az resource list para obtener una lista de recursos del grupo de recursos.

    az resource list \
    --resource-group $resourceGroupName \
    --location $location \
    --output tsv

  2. En la salida de ejemplo, busque los recursos que tienen un tipo de Microsoft.DocumentDB/mongoClusters. Este es un ejemplo del tipo de salida que se espera:

    Name                  ResourceGroup                Location    Type                                Status
--------------------  ---------------------------  ----------  ----------------------------------  --------
msdocs-sz2dac3xtwzzu  msdocs-cosmos-quickstart-rg  eastus      Microsoft.DocumentDB/mongoClusters

Limpieza de recursos

Cuando haya terminado con el clúster de núcleo virtual de Azure Cosmos DB for MongoDB, puede eliminar los recursos de Azure que creó para no tener más gastos.

  1. Use az group delete para quitar el grupo de recursos de la suscripción.

    az group delete \
    --name $resourceGroupName

Paso siguiente

En esta guía, ha aprendido a crear un clúster de núcleo virtual de Azure Cosmos DB for Mongo DB. Ahora puede migrar datos al clúster.

Migración de datos a un núcleo virtual de Azure Cosmos DB for MongoDB