Guia de início rápido: criar um cluster vCore do Azure Cosmos DB para MongoDB usando um modelo Bicep

  • Artigo

APLICA-SE A: MongoDB vCore

Neste início rápido, você cria um novo cluster vCore do Azure Cosmos DB para MongoDB. Este cluster contém todos os recursos do MongoDB: bancos de dados, coleções e documentos. O cluster fornece um ponto de extremidade exclusivo para várias ferramentas e SDKs se conectarem ao Azure Cosmos DB e executarem operações diárias.

Pré-requisitos

Revise o arquivo Bicep

O arquivo Bicep usado neste início rápido é de Modelos de Início Rápido do 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

Por favor, note que no código acima, shardGroupSpecs é chamado nodeGroupSpecs.

Dois recursos do Azure são definidos no arquivo Bicep:

Implantar o arquivo Bicep

Crie um cluster vCore do Azure Cosmos DB para MongoDB usando o modelo Bicep.

  1. Criar variáveis de shell para resourceGroupName e location

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

  2. Se ainda não o fez, entre na CLI do Azure usando o az login comando.

  3. Use o az group create comando para criar um novo grupo de recursos em sua assinatura.

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

  4. Use az deployment group create para implantar o modelo bíceps. Em seguida, você será solicitado a inserir um valor para os adminUsername parâmetros e adminPassword .

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

    Gorjeta

    Como alternativa, use a --parameters opção para passar um arquivo de parâmetros com valores predefinidos.

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

    Este exemplo de arquivo JSON injeta clusteradmin e P@ssw.rd valores para os adminUsername parâmetros e 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. Aguarde a conclusão da operação de implantação antes de prosseguir.

Rever os recursos implementados

Liste os recursos implantados pelo modelo Bicep no seu grupo de recursos de destino.

  1. Use az resource list para obter uma lista de recursos em seu grupo de recursos.

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

  2. Na saída de exemplo, procure recursos que tenham um tipo de Microsoft.DocumentDB/mongoClusters. Aqui está um exemplo do tipo de saída esperada:

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

Clean up resources (Limpar recursos)

Quando terminar de usar o cluster vCore do Azure Cosmos DB para MongoDB, você poderá excluir os recursos do Azure criados para não incorrer em mais cobranças.

  1. Use az group delete para remover o grupo de recursos da sua assinatura.

    az group delete \
    --name $resourceGroupName

Próximo passo

Neste guia, você aprendeu como criar um cluster vCore do Azure Cosmos DB para MongoDB. Agora você pode migrar dados para o cluster.

Migrar dados para o Azure Cosmos DB para MongoDB vCore