Puede usar Terraform para administrar su infraestructura de MongoDB Atlas como código con el proveedor Atlas Terraform. Este proveedor automatiza las implementaciones de infraestructura simplificando el proceso de aprovisionamiento, administración y control de la infraestructura Atlas como código.
Esta guía le enseña cómo crear, modificar y destruir clústeres de Atlas en una organización y un proyecto de MongoDB Atlas existentes.
Una vez que haya configurado un entorno de prueba, continúe experimentando con una infraestructura gestionada por Terraform. recursos adicionales de MongoDB y HashiCorp.
Requisitos previos
Antes de implementar MongoDB Atlas con Terraform, debe:
Crear un Atlas cuenta.
Obtén tu Identificador de la Organización del cual eres el
Organization Owner.Tip
Puedes encontrar el Identificador de la Organización en la Atlas Interfaz de Usuario, en la sección de tu organización. General Settings.
Configura la autenticación de la cuenta de servicio (SA).
Instala Terraform.
Implementar 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 claves públicas y privadas de Atlas son secretas. Considera almacenarlas 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 solicite Do you want to perform these actions?, ingrese 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 eliminar todos los recursos creados en su directorio Terraform, ejecute el siguiente comando:
terraform destroy
Advertencia
Si elimina todos sus recursos, no podrá recuperarlos.
Cuando se le solicite Do you really want to destroy all resources?, ingrese 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: