Configurar Módulos Terraform

Todos los recursos informáticos, de red e infraestructura de almacenamiento necesarios para esta solución se definen en módulos de Terraform.

Antes de Empezar

Antes de empezar a configurar los módulos de Terraform, realice los siguientes pasos:

  1. Aprenda los conceptos básicos de Terraform.

    Como mínimo, lea la introducción en la documentación de Terrraform.

  2. Mantenga la siguiente información lista:
    • OCID del arrendamiento.

      Puede encontrar el OCID de su arrendamiento en la consola web de Oracle Cloud Infrastructure. Seleccione Administración en el menú Servicios y, a continuación, haga clic en Detalles de arrendamiento.

    • OCID del usuario que desea que utilice Terraform para la autenticación con Oracle Cloud Infrastructure.

      Para buscar el OCID del usuario, seleccione Identidad en el menú Servicios y, a continuación, seleccione Usuarios. Localice su nombre de usuario en la lista y copie su OCID.

    • OCID del compartimento en el que desea crear los recursos.

      Para buscar el OCID de un compartimento, seleccione Identidad en el menú Servicios y, a continuación, seleccione Compartimentos. Localice el compartimento que necesita en la lista y copie su OCID.

    • Identificador de la región en la que desea crear los recursos.

      Por ejemplo, el ID de la región US East (Ashburn) es us-ashburn-1.

      Consulte Regiones y dominios de disponibilidad.

  3. Decida lo siguiente:
  4. Verifique que los límites de servicio de su arrendamiento puedan incluir todos los recursos que desea crear.

Descarga del código Terraform

El código Terraform de esta solución está disponible en GitHub.

  1. En el panel de navegación de la izquierda, haga clic en Descargar código.
  2. Haga clic en Representante de Git.
  3. Clone o descargue el repositorio en su computadora local.

Acerca de Terraform Code

El código Terraform que ha descargado tiene la estructura siguiente:

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • Directorio _docs: Contiene los diagramas de arquitectura.
  • *.tf: archivos de configuración de Terraform que utiliza la solución. No edite estos archivos.
  • env-vars: Script para definir las variables de entorno para Terraform.
  • LICENSE.md: condiciones de licencia para el código.
  • modules: Directorios que contienen las configuraciones principales de Terraform para los recursos creados con esta solución. No los edite.
  • orm: contiene un archivo zip que puede utilizar para crear una pila en Oracle Cloud Infrastructure Resource Manager, en lugar de utilizar Terraform para desplegar la solución.
  • README.md: documentación de inicio rápido para el código.
  • schema.yaml: restricciones y validaciones de las variables utilizadas en el código Terraform. Este archivo se utiliza al desplegar los recursos mediante Oracle Resource Manager. No edite este archivo.
  • terraform.tfvars: variables de Terraform. Tendrá que definir valores para las variables en este archivo posteriormente.
  • userdata: contiene un script que se ejecuta en las instancias informáticas después de crearse. No edite los archivos en este directorio.

Configuración de las variables de entorno de Terraform

El código Terraform incluye un script que puede utilizar para almacenar valores para determinados parámetros Terraform como variables de entorno.

  1. Asegúrese de haber completado los requisitos descritos anteriormente.
    Consulte Before You Begin.
  2. En su computadora local, vaya al directorio donde descargó el código Terraform.
  3. En el directorio de nivel superior del código, localice y abra el archivo env-vars en un editor de texto sin formato.
  4. Introduzca valores adecuados para las variables del archivo.

    Nota:

    Al especificar el valor de cada variable, recuerde no marcar como comentario la línea; es decir, eliminar el carácter # (almohadilla) al principio de la línea.
  5. Verifique los valores especificados.
    Si omite cualquier valor, se le pedirá que introduzca cuando ejecute Terraform. Si proporciona valores incorrectos, Terraform producirá un error.
  6. Cuando esté satisfecho con que todos los valores sean correctos, guarde y cierre el archivo.
  7. Defina las variables de entorno ejecutando el siguiente comando desde el directorio que contiene el archivo de variables de entorno ejecutando el siguiente comando:
    source ./env-vars
  8. Compruebe que ha definido todas las variables de entorno ejecutando el siguiente comando:
    env | grep TF
    Se muestran las variables de entorno que defina.

Definir los Parámetros de Despliegue

Especifique los recursos de cálculo, red, base de datos y almacenamiento que se crearán y sus propiedades.

  1. Asegúrese de haber completado los requisitos descritos anteriormente.
    Consulte Before You Begin.
  2. En el directorio de nivel superior del código que ha descargado o clonado, ubique el archivo terraform.tfvars y ábralo en un editor de texto sin formato.
  3. Establezca valores para las variables enumeradas en terraform.tfvars.
    El archivo README del código que ha descargado contiene descripciones para las variables e incluye un ejemplo de un archivo terraform.tfvars terminado.
  4. Guarde y cierre terraform.tfvars.