Documentación de Oracle Cloud Infrastructure

Creación de un archivo de configuración de Terraform

Descubra cómo crear un archivo de configuración de terraform con un lenguaje específico del dominio de Terraform o formato JSON si los archivos necesitan ser legibles por máquina.

Terraform describe la infraestructura de Oracle Cloud Infrastructure (OCI) mediante sintaxis declarativa y, a continuación, aplica persistencia en los archivos de configuración susceptibles de compartirse, revisarse, editarse, versionarse, conservarse o reutilizarse. Consulte Configuration Syntax. Los archivos de configuración de Terraform pueden utilizar uno de estos dos formatos: lenguaje específico del dominio de Terraform (formato HashiCorp Configuration Language [HCL]), que es el enfoque recomendado, o formato JSON si los archivos deben ser legibles por una máquina. Los archivos de configuración que utilizan el formato HCL terminan con la extensión de archivo .tf; los que utilizan formato JSON terminan con la extensión de archivo .tf.json. El formato de Terraform es legible por el usuario, mientras que el formato JSON es legible por una máquina.

Utilice las configuraciones de Terraform para definir los recursos que necesita su solución o aplicación en el momento del despliegue. Los recursos pueden crear objetos de Oracle Cloud Infrastructure, como redes virtuales en la nube o instancias informáticas. La primera aplicación de la configuración crea los objetos y las aplicaciones posteriores pueden actualizarlos o suprimirlos. Terraform, a continuación, convierte las configuraciones de Oracle Cloud Infrastructure en un juego de llamadas de API con respecto a los puntos finales de API de Oracle Cloud Infrastructure. La clave para escribir la configuración de Terraform es comprender cómo sintetizar la infraestructura deseada conceptualmente en la sintaxis de configuración de Terraform.

En función de su nivel de experiencia en el desarrollo de configuraciones de Terraform, puede continuar con la introducción a una plantilla de pila de Marketplace o crear sus propias secciones de configuraciones de Terraform.

Introducción a una plantilla de pila de Marketplace

Una recopilación de ejemplos que permite a los editores de Oracle Cloud Infrastructure Marketplace obtener un inicio rápido de despliegue de aplicaciones en Oracle Cloud Infrastructure está disponible en la plantilla de inicio rápido de OCI. Este repositorio contiene la plantilla que se puede utilizar para acelerar la construcción de pilas que se ejecuta desde la CLI de Terraform local, OCI Resource Manager y Cloud Shell.

Para empezar, recomendamos crear una clonación del repositorio oci-quickstart-template:

$> git clone https://github.com/oracle-quickstart/oci-quickstart-template.git
$> cd oci-quickstart-template

Los archivos de configuración de Terraform (.tf) tienen requisitos específicos, según los componentes definidos en el archivo. Por ejemplo, puede tener el proveedor de Terraform definido en un archivo (provider.tf), las variables definidas en otro (variables.tf), los orígenes de datos definidos en otro. La plantilla de pila de inicio rápido de Marketplace agrupa recursos similares en archivos individuales, pero tenga en cuenta que el diseño del sistema de archivos es solo una referencia de ejemplo.

Despliegue de una instancia con una imagen personalizada

Para crear una instancia desde una imagen personalizada, siga estos pasos:

  1. Localice el recurso oci_core_instance en el archivo compute.tf y defina source_details en local.compute_image_id en la plantilla oci-quickstart-template que acaba de clonar. La variable local local.compute_image_id se puede definir en un ocid de imagen personalizada o en un ocid de imagen de marketplace basado en el indicador mp_subscription_enable.

  2. Modifique variables.tf para definir el valor de atributo por defecto de variable compute_image_id en el OCID de la imagen personalizada que ha creado después de la tarea 2 en Creación de una lista de pilas de OCI en Partner Portal.

Creación de su propia pila de Marketplace

El repositorio oci-quickstart-template sirve como punto de partida para las configuraciones de Terraform, pero no le limita a crear su propio Infrastrucutre como código. Para obtener referencia a más ejemplos, consulte Terraform Provider de Oracle Cloud Infrastructure para OCI: terraform-provider-OCI/docs/examples. Asegúrese de que los archivos de Terraform cumplan con las directrices para pilas de Marketplace.