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 administrada por Terraform con recursos adicionales de MongoDB y HashiCorp.
Requisitos previos
Antes de implementar MongoDB Atlas con Terraform, debe:
Crear un atlas cuenta.
Obtenga el ID de su organización de la cual es el
Organization Owner.Tip
Puede encontrar el ID de su organización en la interfaz de usuario de Atlas, debajo del nombre de su organización. General Settings.
Configurar una autenticación de cuenta de servicio (SA).
Instalar Terraform.
Implementar MongoDB Atlas con Terraform
Rellene los archivos de soporte.
Consulte el módulo atlas-basic y copie el contenido en los archivos que creó en el paso anterior (haga clic en el enlace Source Code para ver el contenido).
Nota
Tus claves públicas y privadas de Atlas son secretas. Considera almacenarlas como variables de entorno.
Configurar main.tf contenidos.
Actualice los siguientes campos en su archivo main.tf:
Campo | Nuevo valor |
|---|---|
|
|
| Su proveedor. Los valores posibles son: |
| Consulta Proveedores y regiones de la nube para conocer todas las regiones que puedes usar. |
(Opcional) Parámetros de visualización.
Puedes enviar información de tu configuración de Terraform a la ventana de tu terminal. Esto es útil para valores que no conocerás hasta que Atlas cree los recursos, como la cadena de conexión.
Si desea mostrar sus parámetros después de implementar su proyecto, agregue algunas líneas de código de salida a su 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
El aprovisionamiento de nuevos recursos de Atlas puede tardar unos minutos. El proveedor de Terraform de Atlas te actualiza cada diez segundos hasta que se completa.
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: