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 te enseña a crear, modificar y destruir clústeres de Atlas en una organización y proyecto existentes de MongoDB Atlas.
Una vez que haya configurado un entorno de prueba, continúe experimentando con una infraestructura administrada por Terraform con recursos adicionales de MongoDB y HashiCorp.
Requisitos previos
Antes de implementar MongoDB Atlas con Terraform, debe:
Crear una cuentaen Atlas.
Obtén tu Identificador de la Organización de la que eres el
Organization Owner.Tip
Se puede encontrar el Identificador de la organización en la interfaz de usuario de Atlas, en General Settings de la organización.
Configura la autenticación de la cuenta de servicio (SA).
Instala Terraform.
Implementa MongoDB Atlas con Terraform
Rellenar archivos de soporte.
Consulta el módulo atlas-basic y copia el contenido en los archivos que creaste en el paso anterior (haz clic en el enlace en el Source Code para ver el contenido).
Nota
Tus llaves públicas y llaves privadas de Atlas son confidenciales. Considera almacenarlos como variables de entorno.
Configura los contenidos de main.tf.
Actualiza los siguientes campos en tu archivo main.tf:
Campo | Nuevo valor |
|---|---|
|
|
| Tu proveedor. Los posibles valores son: |
| Consulta Proveedores de nube y regiones para conocer todas las regiones que puedes utilizar. |
(Opcional) Parámetros de visualización.
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.
Implementa tu infraestructura.
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.
Terminar la instancia de MongoDB Atlas
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.
Próximos pasos
Para explorar configuraciones más avanzadas, amplíe los conceptos fundamentales tratados en este tutorial con recursos adicionales de Atlas, configuraciones del proveedor Atlas Terraform y capacidades de Terraform. Consulta los siguientes recursos: