Note:

Instalación y configuración de la herramienta Pulumi Infrastructure as Code en Oracle Cloud Infrastructure

Introducción

Simplifiquemos la gestión de su infraestructura de Oracle Cloud (OCI) con la herramienta Pulumi Infrastructure as Code (IaC). Este tutorial discutirá cómo instalar y configurar Pulumi, asegurándose de que encaje perfectamente en su flujo de trabajo. Ya sea que tenga experiencia o comience a usar IaC, este tutorial tiene instrucciones paso a paso. Prepárate para actualizar la gestión de tu infraestructura con Pulumi en OCI.

Una vez que Pulumi se esté ejecutando en la configuración de OCI, verá una mejora notable en la eficiencia. La sencilla interfaz facilita el despliegue y la gestión de recursos y simplifica la gestión de la infraestructura de OCI.

Objetivo

Requisitos

Tarea 1: Descargar e instalar Pulumi

Descargue e instale Pulumi en su sistema o máquina virtual (VM). Para obtener más información, consulte Descargar e instalar Pulumi.

Por ejemplo, los usuarios de macOS pueden instalar Pulumi ejecutando el siguiente comando.

brew install pulumi/tap/pulumi

Tarea 2: Instalación del paquete de proveedor de OCI para Pulumi

Los proveedores de OCI actúan como la conexión entre el código Pulumi y los servicios de OCI que pretende supervisar. Los proveedores de OCI permiten a Pulumi crear, gestionar y configurar recursos en su entorno de OCI a través del código.

Para instalar los proveedores de OCI para Pulumi, vaya a la interfaz de línea de comandos (CLI) y ejecute el comando de instalación. Para este tutorial, utilizaremos Python como lenguaje Pulumi para desplegar servicios de OCI.

python3 -m pip install pulumi_oci

Para instalar proveedores de OCI con otros idiomas, consulte Proveedor de OCI para Pulumi.

Tarea 3: Configuración de Variables de Entorno

Configure las variables de entorno necesarias para conectar Pulumi con su entorno OCI. Estas variables incluyen el identificador de Oracle Cloud (OCID) de su arrendamiento, el OCID de usuario, la huella, la región y la ruta a su clave de API de OCI.

Modifique los valores según el archivo de configuración del arrendamiento y ejecute los siguientes comandos.

export TF_VAR_tenancy_ocid="ocid1.tenancy.oc1..<unique_ID>"

export TF_VAR_user_ocid="ocid1.user.oc1..<unique_ID>"

export TF_VAR_fingerprint="<key_fingerprint>"

export TF_VAR_region="us-ashburn-1"

export TF_VAR_private_key_path="/path/to/oci_api_key.pem"

Tarea 4: Crear una pila Pulumi

Organiza tu proyecto creando un directorio para tu pila Pulumi. Inicialícelo con su lenguaje de programación preferido. Para este tutorial, estamos utilizando la pila de Python.

  1. Cree un directorio de pila Pulumi. Para crear un nuevo directorio para la pila Pulumi, ejecute el siguiente comando.

    mkdir OCI_Pulumi_Stack && cd OCI_Pulumi_Stack
    
  2. Inicialice el proyecto Pulumi con una plantilla de OCI Python: pulumi new oci-python.

  3. Introduzca los detalles del proyecto, como el nombre del proyecto, la descripción y el nombre de la pila (por ejemplo, desarrollo, ubicación temporal, producción). Este paso inicia el proceso de configuración, incluida la adición de las dependencias necesarias y la carga del código de ejemplo en el archivo main.py.

  4. Verifique el código configurado comprobando el contenido del directorio OCI_Pulumi_Stack. Aquí encontrará el código de ejemplo y los archivos adicionales creados durante el proceso de inicialización.

Tarea 5: Personalizar una pila Pulumi

Personalice una pila según sus requisitos específicos. Abra el archivo de despliegue principal main.py y agregue el código necesario para definir los recursos de OCI que desea desplegar. En este tutorial, le mostraremos cómo recuperar los dominios de disponibilidad en su arrendamiento de OCI.

"""A OCI Python Pulumi program"""

import pulumi

import pulumi_oci as oci

test_availability_domains = oci.identity.get_availability_domains(compartment_id="ocid1.tenancy.oc1..xxxxx")

# Output availability domains

pulumi.export("availability_domain_1", test_availability_domains.availability_domains[0].name)

pulumi.export("availability_domain_2", test_availability_domains.availability_domains[1].name)

pulumi.export("availability_domains_3", test_availability_domains.availability_domains[2].name)

Este código muestra cómo recuperar los dominios de disponibilidad de su arrendamiento de OCI y exportar sus nombres como salida. Al ejecutar este código con Pulumi, interactuará con OCI para recuperar los dominios de disponibilidad y mostrar sus nombres como salida. Esto le permite asegurarse de que el código recupera con precisión la información necesaria de OCI.

Tarea 6: Despliegue del código Pulumi en OCI

Ejecute el siguiente comando para desplegar recursos en OCI.

pulumi up

Tarea 7: Verificación de la salida del comando

Después del despliegue, el comando ejecutará el programa Pulumi y recuperará los dominios de disponibilidad de su arrendamiento de OCI, según se define en el código.

Pulumi_OCI_Output

Confirmaciones

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en Oracle Learning Explorer.

Para obtener documentación sobre el producto, visite Oracle Help Center.