Archiviazione ad alte prestazioni in Azure DocumentDB

Accedere al portale di Azure (https://portal.azure.com).

Nel menu del portale di Azure o nella pagina Home selezionare Crea una risorsa.

Nella pagina Nuovo cercare e selezionare Azure DocumentDB.

Nella pagina Creare il cluster Azure DocumentDB e all'interno della sezione Nozioni di base, selezionare l'opzione Configura nella sezione livello Cluster.

Nella pagina Configura scegliere il livello cluster e le dimensioni di archiviazione in base alle esigenze. Selezionare il tipo di archiviazione come SSD Premium v2 per abilitare l'archiviazione ad alte prestazioni, quindi selezionare Salva per applicare le modifiche.

Compilare i dettagli rimanenti e quindi selezionare Rivedi e crea.

Rivedere le impostazioni specificate e quindi selezionare Crea. La creazione del cluster richiede alcuni minuti. Attendere il completamento della distribuzione delle risorse.

Infine, selezionare Vai alla risorsa per passare al cluster Azure DocumentDB nel portale.

Aprire un nuovo terminale.

Accedi alla CLI di Azure.

Creare un nuovo file Bicep per definire la definizione del ruolo. Assegnare al file il nome main.bicep.

Aggiungere questo modello al contenuto del file. Sostituire i segnaposto <cluster-name>, <location>, <username> e <password> con i valori appropriati.

resource cluster 'Microsoft.DocumentDB/mongoClusters@2025-09-01' = {
  name: '<cluster-name>'
  location: '<location>'
  properties: {
    administrator: {
      userName: '<username>'
      password: '<password>'
    }
    serverVersion: '8.0'
    storage: {
      sizeGb: 32
      type: 'PremiumSSDv2'
    }
    compute: {
      tier: 'M30'
    }
    sharding: {
      shardCount: 1
    }
    highAvailability: {
      targetMode: 'Disabled'
    }
  }
}

Distribuire il modello Bicep usando az deployment group create. Specificare il nome del modello Bicep e sostituire il <resource-group> segnaposto con il nome del gruppo di risorse di Azure di destinazione.

az deployment group create \
    --resource-group "<resource-group>" \
    --template-file main.bicep

Attendere il completamento della distribuzione. Esaminare l'output della distribuzione.

Aprire un nuovo terminale.

Accedi alla CLI di Azure.

Verifica l'abbonamento Azure di destinazione.

az account show

Definire il cluster in un nuovo file Terraform. Denominare il file cluster.tf.

Aggiungere questa configurazione della risorsa al contenuto del file. Sostituire i segnaposto <cluster-name>, <resource-group> e <location> con i valori appropriati.

variable "admin_username" {
  type        = string
  description = "Administrator username for the cluster."
  sensitive   = true
}

variable "admin_password" {
  type        = string
  description = "Administrator password for the cluster."
  sensitive   = true
}

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

provider "azurerm" {
  features {}
}

data "azurerm_resource_group" "existing" {
  name = "<resource-group>"
}

resource "azurerm_mongo_cluster" "cluster" {
  name                   = "<cluster-name>"
  resource_group_name    = data.azurerm_resource_group.existing.name
  location               = "<location>"
  administrator_username = var.admin_username
  administrator_password = var.admin_password
  shard_count            = "1"
  compute_tier           = "M30"
  high_availability_mode = "Disabled"
  storage_size_in_gb     = "32"
  storage_type           = "PremiumSSDv2"
  version                = "8.0"
}

Avviare la distribuzione di Terraform.

terraform init --upgrade

Creare un piano di esecuzione e salvarlo in un file denominato cluster.tfplan. Specificare i valori quando richiesto per le admin_username variabili e admin_password .

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

Applicare il piano di esecuzione per distribuire il cluster in Azure.

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

Attendere il completamento della distribuzione. Esaminare l'output della distribuzione.

Aprire un nuovo terminale.

Accedi alla CLI di Azure.

Creare un nuovo file JSON denominato cluster.json.

Aggiungere questo documento al contenuto del file. Sostituire i segnaposto <location>, <username> e <password> con i valori appropriati.

{
  "location": "<location>",
  "properties": {
    "administrator": {
      "userName": "<username>",
      "password": "<password>"
    },
    "serverVersion": "8.0",
    "storage": {
      "sizeGb": 32,
      "type": "PremiumSSDv2"
    },
    "compute": {
      "tier": "M30"
    },
    "sharding": {
      "shardCount": 1
    },
    "highAvailability": {
      "targetMode": "Disabled"
    }
  }
}

Utilizzare il comando az rest CLI di Azure per creare un nuovo cluster con la configurazione specificata nel file JSON. Specificare il nome del file JSON come body della richiesta e sostituire i segnaposto seguenti:

az rest \
    --method "GET" \
    --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>/users?api-version=2025-09-01" \
    --body @cluster.json

Attendere il completamento della distribuzione. Esaminare l'output della distribuzione.