Partilhar via

Início rápido: Implementar um cluster Azure DocumentDB usando o Terraform

Neste quickstart, implementas um novo cluster Azure DocumentDB usando o Terraform. Este guia de início rápido fornece instruções passo a passo para o ajudar a começar rapidamente. Este cluster contém todos os seus recursos do MongoDB: bases de dados, coleções e documentos. Fornece um endpoint único para ferramentas e kits de desenvolvimento de software (SDKs) se ligarem ao Azure DocumentDB e realizarem operações.

Pré-requisitos

  • Uma assinatura do Azure

    • Se você não tiver uma assinatura do Azure, crie uma conta gratuita

Configurar ambiente

Configure o seu ambiente Azure CLI para gerir os recursos Azure DocumentDB na sua subscrição.

  1. Comece em um diretório vazio.

  2. Entre na CLI do Azure.

    az login

  3. Verifica a tua subscrição alvo do Azure.

    az account show

    Observação

    Se não estiver ligado à subscrição que esperava, use este comando para alterar a sua subscrição:

    az account set --subscription "<subscription-name>"

    Para mais informações, consulte gerir subscrições Azure com a CLI do Azure.

Preparar a configuração do Terraform

Crie e configure um ficheiro Terraform para definir os recursos necessários para implementar um cluster Azure DocumentDB.

  1. Crie um novo ficheiro main.tf no diretório do seu projeto.

  2. Adicione esta configuração ao conteúdo do ficheiro.

    variable "admin_username" {
  type = string
  description = "Username for default administrator account"
}

variable "admin_password" {
  type = string
  description = "Password for default administrator account"
  sensitive = true
}

terraform {
  required_providers {
    azurerm = {
      source = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
}

provider "azurerm" {
  features { }
}

resource "azurerm_resource_group" "resource_group" {
  name     = "example-resource-group"
  location = "West US"
}

resource "azurerm_mongo_cluster" "cluster" {
  name                   = "example-mongo-cluster"
  resource_group_name    = azurerm_resource_group.resource_group.name
  location               = azurerm_resource_group.resource_group.location
  administrator_username = var.admin_username
  administrator_password = var.admin_password
  shard_count            = "1"
  compute_tier           = "M10"
  high_availability_mode = "Disabled"
  storage_size_in_gb     = "32"
  version                = "8.0"
}

    Sugestão

    Para mais informações sobre as opções que utilizam o azurerm_mongo_cluster recurso, consulte azurerm a documentação do fornecedor no Terraform Registry.

Implementar a configuração

Implemente o ficheiro de configuração criado na etapa anterior usando um plano de execução.

  1. Inicialize a implementação do Terraform com a CLI do Terraform.

    terraform init --upgrade

  2. Crie um plano de execução e guarde-o num ficheiro chamado main.tfplan. Forneça valores quando solicitado para as variáveis admin_username e admin_password.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform plan --out "main.tfplan"

    Observação

    Este comando define temporariamente a ARM_SUBSCRIPTION_ID variável de ambiente. Esta configuração é obrigatória para o azurerm fornecedor a partir da versão 4.0. Para mais informações, consulte ID de subscrição em azurerm.

  3. Aplique o plano de execução para implementar recursos no Azure.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform apply "main.tfplan"

  4. Espere que a operação de implantação termine antes de avançar.

Analisar os recursos implementados

Liste os recursos Azure DocumentDB implementados no seu grupo de recursos.

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

    az resource list \
    --resource-group "<resource-group-name>" \
    --namespace "Microsoft.DocumentDB" \
    --resource-type "mongoClusters" \
    --query "[].name" \
    --output json

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

    [
  "msdocs-documentdb-example-cluster"
]

Limpeza de recursos

Remova todos os recursos definidos na sua configuração do Terraform.

  1. Destrói os teus recursos geridos pela Terraform usando o destroy comando.

    ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform destroy

    Sugestão

    Alternativamente, use az group delete para remover o grupo de recursos da sua subscrição:

    az group delete \
    --name "<resource-group-name>" \
    --yes \
    --no-wait

    Importante

    Certifique-se de que já não precisa dos recursos antes de executar este comando, pois ele apaga permanentemente.

  2. Para prosseguir com a remoção, confirme quaisquer instruções relevantes.

Conteúdo relacionado

  • Last updated on