Compartilhar via

Início Rápido: Criar um cluster vCore do Azure Cosmos DB for MongoDB usando um modelo Bicep

  • Artigo

APLICA-SE AO: MongoDB vCore

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

Pré-requisitos

Examinar o arquivo Bicep

O arquivo Bicep usado neste guia de início rápido vem dos 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'
  }
}

Observação

Observe que, no código acima, shardGroupSpecs é chamado de nodeGroupSpecs.

Há dois recursos do Azure definidos no arquivo Bicep:

Implante o arquivo Bicep

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

  1. Crie variáveis em shell para resourceGroupName e location

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

  2. Caso ainda não tenha feito isso, entre na CLI do Azure usando o comando az login.

  3. Use o comando az group create 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 bicep. Em seguida, você será solicitado a inserir um valor para os parâmetros adminUsername e adminPassword.

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

    Dica

    Como alternativa, use a opção --parameters 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 valores clusteradmin e P@ssw.rd para os parâmetros adminUsername 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.

Examinar os recursos implantados

Liste os recursos implantados pelo modelo Bicep para o 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 a ser esperado:

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

Limpar recursos

Quando o seu cluster vCore do Azure Cosmos DB for MongoDB estiver pronto, 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 de sua assinatura.

    az group delete \
    --name $resourceGroupName

Próxima etapa

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

Migrar dados para a vCore do Azure Cosmos DB for MongoDB