Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Comienza con Terraform y el proveedor de MongoDB Atlas

Puede usar Terraform para gestionar su infraestructura de MongoDB Atlas como Infrastructure as Code con el proveedor de Atlas Terraform. El proveedor Atlas Terraform automatiza las implementaciones de infraestructura al simplificar el proceso de provisionamiento, gestionar y controlar la infraestructura de Atlas como Infrastructure as Code.

Esta guía le enseña cómo crear y destruir clústeres de Atlas en una organización de MongoDB Atlas existente.

Nota

El proveedor de Atlas Terraform admite cualquier versión de MongoDB que Atlas admita en su Proyecto y región. Para aprender a cambiar la versión de MongoDB de su clúster, consulte Actualizar una versión principal.

Una vez que hayas configurado un entorno de prueba, continúa experimentando con una infraestructura gestionada por Terraform con recursos adicionales de MongoDB y HashiCorp.

Los clústeres de Atlas Infinite son compatibles con el proveedor de Atlas para Terraform. Para aprender más, consulta Crear un clúster de Atlas Infinite con Terraform y MongoDB Atlas Infinite: Descripción general.

Antes de implementar MongoDB Atlas con Terraform, debe:

1
mkdir terraform-projcd terraform-proj
2

Crea los archivos main.tf, provider.tf, variables.tf y versions.tf.

touch main.tf provider.tf variables.tf versions.tf
3

Añada el siguiente contenido a provider.tf:

provider "mongodbatlas" { client_id = var.client_id client_secret = var.client_secret}

Añada el siguiente contenido a variables.tf:

variable "client_id" { description = "Atlas Service Account client ID" type = string} variable "client_secret" { description = "Atlas Service Account client secret" type = string sensitive = true} variable "org_id" { description = "Atlas organization ID" type = string}

Añada el siguiente contenido a versions.tf:

terraform { required_providers { mongodbatlas = { source = "mongodb/mongodbatlas" version = "~> 2.2" } } required_version = "~> 1.0"}

Nota

El ID de cliente de su cuenta de servicio de Atlas y el secreto de cliente son secretos. Considere almacenarlos como variables de entorno.

4

Nota

El siguiente ejemplo utiliza el módulo de Proyecto para crear el Proyecto y el mongodbatlas_advanced_cluster recurso para crear un clúster gratuito.

Añada el siguiente contenido a su archivo main.tf:

module "project" { source = "terraform-mongodbatlas-modules/project/mongodbatlas" name = "tenant-example-project" org_id = var.org_id} resource "mongodbatlas_advanced_cluster" "this" { project_id = module.project.id name = "TenantCluster" cluster_type = "REPLICASET" replication_specs = [ { region_configs = [ { provider_name = "TENANT" backing_provider_name = "AWS" region_name = "US_EAST_1" priority = 7 electable_specs = { instance_size = "M0" } } ] } ]}

Si trabaja con un proveedor de nube o una región diferente, puede actualizar los siguientes campos para que coincidan con su entorno.

Campo
Nuevo valor

backing_provider_name

Tu proveedor. Los posibles valores son: "AWS", "AZURE" o "GCP".

region_name

Consulta Proveedores de nube y regiones para conocer todas las regiones que puedes utilizar.

Importante

Puede establecer database_edition en el recurso mongodbatlas_advanced_cluster cuando crea un clúster dedicado. No puedes cambiarlo después, y no puedes escalar un clúster dedicado a un clúster gratuito o un clúster flexible. database_edition no está disponible para clústeres gratuitos, como el clúster M0 de este ejemplo, y para clústeres Flex.

El recurso mongodbatlas_advanced_cluster, y tanto la fuente de datos singular (mongodbatlas_advanced_cluster) como las fuentes de datos plurales (mongodbatlas_advanced_clusters), exponen database_edition y el atributo de solo lectura effective_database_edition. Dado que database_edition es opcional, utilice effective_database_edition para confirmar qué edición asignó Atlas, incluso si no la configuró usted mismo.

Para crear un clúster de Atlas Infinite dedicado, consulte Crear un clúster de Atlas Infinite con Terraform.

5

Puedes mostrar información desde tu configuración de Terraform en la ventana de tu terminal. Esto resulta útil para valores que no conocerás hasta que Atlas cree los recursos, como tu cadena de conexión.

Si deseas mostrar tus parámetros después de implementar tu proyecto, agrega algunas líneas de código de salida a tu archivo main.tf.

6

Para inicializar tu proyecto, ejecuta el siguiente comando:

terraform init

Este comando también descarga e instala el proveedor de MongoDB Atlas, si aún no lo has hecho.

7

Para ver el plan de ejecución, ejecute el siguiente comando:

terraform plan

Terraform describe los cambios que planea realizar. Si el resultado no es lo que esperas, podría haber un problema en tu archivo main.tf.

8

Para implementar su infraestructura, ejecute el siguiente comando:

terraform apply

Cuando se le pida Do you want to perform these actions?, introduzca yes.

Nota

Los nuevos recursos de Atlas pueden tardar algunos minutos en aprovisionarse. El proveedor de Terraform de Atlas te actualiza cada diez segundos hasta que se complete.

El siguiente ejemplo utiliza Terraform para crear un clúster de Atlas Infinite con el escalado automático de computación habilitado:

resource "mongodbatlas_advanced_cluster" "infinite" { project_id = module.project.id name = "InfiniteCluster" cluster_type = "REPLICASET" database_edition = "INFINITE" replication_specs = [ { region_configs = [ { provider_name = "AWS" priority = 7 region_name = "US_EAST_1" electable_specs = { instance_size = "M10" node_count = 2 } auto_scaling = { compute_enabled = true compute_max_instance_size = "M60_GEN_2" storage_config = { shard_size_limit_gb = 10240 } } } ] } ]}

Cuando crea un clúster de Atlas Infinite con Terraform, se aplican los siguientes requisitos y limitaciones:

  • Configuración obligatoria: Establezca database_edition en "INFINITE" en el recurso mongodbatlas_advanced_cluster y establezca un valor compute_enabled explícito (true o false) en auto_scaling. Atlas requiere este valor al crear el clúster.

  • Edición de base de datos inmutable: No puede cambiar la edición de base de datos de un clúster después de crearlo.

  • Limitaciones de la vista previa pública: Todas las demás limitaciones de la vista previa pública de Atlas Infinite se aplican a los clústeres que implementa con Terraform. Para aprender más, consulte No compatible en la vista previa pública.

  • Tipo de clúster: Los clústeres de Atlas Infinite dedicados solo admiten el tipo de clúster REPLICASET.

  • Nivel máximo de escalado automático: compute_max_instance_size es obligatorio cuando compute_enabled es true. Los clústeres de Atlas Infinite en el nivel M30 y superiores se ejecutan en hardware Amazon Web Services Gen2, por lo que debe añadir _GEN_2 al nombre del nivel, como en M60_GEN_2. Para aprender más, se puede consultar clústeres dedicados de Gen2.

  • Nodos elegibles: Un clúster de Atlas Infinite tiene dos nodos de computación elegibles, uno primario y otro en espera, así que establezca node_count en 2. Para aprender más, consulte Replicación y conmutación por error.

  • Nodos de solo lectura y nodos de análisis: para servir más lecturas o para aislar las query de análisis de su carga de trabajo operativa, configure read_only_specs o analytics_specs junto con electable_specs en el mismo objeto region_configs. Para aprender más, consulte Aislamiento de carga de trabajo en clústeres de Atlas Infinite.

  • Límite de almacenamiento: storage_config.shard_size_limit_gb solo es necesario si incluye storage_config. Si omite storage_config, Atlas aplica el límite de almacenamiento máximo por defecto. Para aprender más, consulte Límite de almacenamiento máximo.

Nota

storage_config.shard_size_limit_gb establece la cantidad máxima de datos que el clúster puede almacenar. Para aprender más, consulta la documentación del proveedor de Terraform.

Una vez que terraform apply se complete, confirme que el clúster está implementado.

  • Aparece un nuevo clúster en la interfaz de usuario de Atlas en su proyecto.

  • Si agregó valores de salida a main.tf, la cadena de conexión aparece en la salida de Terraform.

Para borrar todos los recursos creados en tu directorio de Terraform, ejecuta el siguiente comando:

terraform destroy

Advertencia

Si elimina todos sus recursos, no podrá recuperarlos.

Cuando se le pida Do you really want to destroy all resources?, introduzca yes.

Después de implementar el clúster, puede:

Recursos adicionales: