Gestión de pilas y trabajos

En este tema se describe cómo crear, editar y suprimir pilas, así como gestionar trabajos, incluida la generación y aplicación de planes de ejecución. La detección de cambios también se cubre en este tema.

Política de IAM necesaria

Para gestionar pilas y trabajos, debe contar con el tipo necesario de acceso en una política escrita por un administrador, tanto si utiliza la consola como la API de REST con un SDK, una CLI u otra herramienta. Si intenta realizar una acción y recibe un mensaje de que no tiene permiso o no está autorizado, confirme con su administrador el tipo de acceso que se le ha otorgado y qué compartimento debe trabajar.

Importante

También serán necesarias políticas para gestionar recursos de Oracle Cloud Infrastructure para operaciones del gestor de recursos que acceden a los recursos. Por ejemplo, la ejecución de un trabajo de aplicación en una pila que incluye instancias y subredes de Compute requiere políticas que le otorguen permisos para esos tipos de recursos, en los compartimentos en los que desea aprovisionar los recursos. Para consultar ejemplos de políticas de gestión de recursos de Oracle Cloud Infrastructure, consulte Políticas comunes.

Si es la primera vez que trabaja con políticas, consulte Introducción a las políticas y Políticas comunes.

Administradores: para políticas comunes que proporcionan a los grupos acceso a recursos de Resource Manager, consulte Gestión de pilas y trabajos (Protección de Resource Manager).

Etiquetado de recursos

Puede aplicar etiquetas a los recursos para facilitar su organización según las necesidades de su negocio. Puede aplicar etiquetas al crear un recurso o puede actualizar el recurso más tarde con las etiquetas que desee. Para obtener información general sobre la aplicación de etiquetas, consulte Etiquetas de recursos.

Movimiento de recursos a otro compartimento

Puede mover las pilas de un compartimento a otro. Al mover una pila a un compartimento nuevo, sus trabajos asociados se mueven con ella. Después de mover la pila al nuevo compartimento, las políticas inherentes se aplican de inmediato y afectan el acceso a la pila y los trabajos asociados a través de Consola. Para obtener más información, consulte Gestión de compartimentos.

Uso de la Consola

Gestión de pilas (consola)

Para crear una pila

En esta sección se describe cómo comenzar desde la página Crear pila al crear pilas. Para obtener información sobre los orígenes de configuración de Terraform soportados con el gestor de recursos, consulte Dónde almacenar las configuraciones de Terraform.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en Crear pila.

  4. En la página Crear pila, en Seleccionar el origen de la configuración de Terraform, seleccione la opción que desee.

    • Mi configuración: carpeta local, cubo de Object Storage o archivo .zip local.

      En Configuración de pila, seleccione la opción correspondiente a la ubicación de la configuración de Terraform:

      • Carpeta: arrastre y suelte una carpeta en el control del cuadro de diálogo o haga clic en Examinar y navegue hasta la ubicación de la carpeta que desee.
      • Bloque de almacenamiento de objetos: seleccione un cubo de la lista.

        La lista muestra los cubos del compartimento indicado. Para seleccionar otro compartimento, haga clic en Cambiar compartimento.

      • . Archivo Zip: arrastre y suelte un archivo .zip en el control del cuadro de diálogo o haga clic en Examinar y navegue hasta la ubicación del archivo .zip que desee.

      El cuadro de diálogo se rellena con la información que incluye la configuración local de Terraform.

    • Plantilla: configuración de Terraform incorporada (servicio, arquitectura o plantilla privada).

      En Configuración de pila, haga clic en Seleccionar plantilla y, a continuación, seleccione la plantilla que desee. Las plantillas privadas están en el separador Privadas.

      El cuadro de diálogo se rellena con la información incluida en la configuración de Terraform para la plantilla seleccionada.

    • Sistema de control de código fuente: ubicación remota mediante un proveedor de origen de configuración.
      Niveles
      1. En Configuración de pila, seleccione un proveedor de origen de configuración.

        Si necesita crear uno, consulte Para crear un proveedor de origen de configuración.

      2. Seleccione un repositorio.

        Ejemplo: https://gitlab.com/example

      3. Seleccione una Rama.

        La lista que se devuelve tiene un límite de 100 bifurcaciones.

      4. (Opcional) Especifique un directorio de trabajo para ejecutar Terraform.

        Este campo está visible al seleccionar una bifurcación con directorios.

        Ejemplo (un nivel): Directorio

        Ejemplo (dos niveles): Directorio/Subdirectorio

        Si no se especifica, se utiliza el directorio raíz.

      El cuadro de diálogo se rellena con la información contenida en la configuración remota de Terraform.

    • Compartimento existente: genere una configuración de Terraform mediante la detección de recursos.

      Pasos
      • Seleccione compartimento para detección de recursos ( compartimento que contiene los recursos que desea capturar).

        Por defecto, se define un compartimento desde el ámbito de lista.

      • Seleccione Región para detección de recursos (región que contiene los recursos que desea capturar).

      • Para filtrar los servicios específicos soportados para la detección de recursos, seleccione Seleccionado y, a continuación, seleccione los servicios que desee.

        Nota

        Este valor no se puede cambiar al editar la pila más tarde.

      El cuadro de diálogo se rellena con información sobre el compartimento especificado.

  5. Para utilizar proveedores personalizados, haga lo siguiente.
    1. Seleccione Usar proveedores personalizados.
    2. Seleccione el cubo que contiene los proveedores personalizados.
  6. Introduzca un nombre para la nueva pila (o acepte el nombre por defecto proporcionado). Evite introducir información confidencial.
  7. También puede introducir una descripción.
  8. En Crear en compartimento, seleccione el compartimento en el que desea crear la pila.

    Por defecto, se define un compartimento desde el ámbito de lista.

  9. Para la versión de Terraform, seleccione la versión que desea para la configuración de Terraform.

    Este campo no está disponible cuando se selecciona Compartimento existente.

  10. Opcionalmente, aplique etiquetas a la pila.

    Si tiene permisos para crear un recurso, también los tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si deben aplicar etiquetas, omita esta opción (puede aplicar las etiquetas posteriormente) o pregunte al administrador.

  11. Haga clic en Siguiente.

    El panel Configurar variables muestra variables de la configuración de Terraform.

    No se muestran variables para el origen de pila Compartimento existente porque aún no existe ninguna configuración de Terraform.

  12. Revise las variables y cambie según sea necesario.

    Importante

    No agregue la clave privada ni otra información confidencial a las variables de configuración.
  13. Haga clic en Siguiente.

  14. En el panel Revisar, verifique la configuración de la pila.

  15. Para aprovisionar recursos automáticamente cuando se crea la pila, seleccione Ejecutar aplicación.

    Este campo no está disponible cuando se selecciona Compartimento existente.

    Nota

    Ejecutar aplicación está seleccionado por defecto para las pilas creadas en el botón Desplegar en Oracle Cloud o en Marketplace.
  16. Haga clic en Crear para crear una pila.

    Aparece la página de detalles de pila para la nueva pila.

    Si se seleccionó Ejecutar aplicación, Gestor de recursos ejecuta la acción de aplicación en la nueva pila.

Origen de pila de compartimento existente: se ejecuta una solicitud de trabajo en la pila. Cuando finaliza la solicitud de trabajo, se ejecuta un trabajo para generar un archivo de configuración de Terraform para la pila. Cuando finaliza el trabajo, los recursos del compartimento seleccionado se capturan en la configuración generada. Puede volver a crear estos recursos en otro compartimento.

Para desplegar los recursos definidos, ejecute un trabajo de aplicación en la nueva pila.

Para comenzar la creación de la pila desde la página Crear instancia informática

Puede crear una pila con la configuración que especifique en la página Crear instancia informática disponible en la consola. Utilice la nueva pila para instalar, configurar y gestionar la instancia de recursos informáticos mediante el modelo de "infraestructura como código".

Nota

Antes de empezar, consulte los requisitos para crear instancias de Compute. Consulte Política de IAM necesaria y los requisitos previos para Creación de una instancia de Linux o Creación de una instancia de Windows.
  1. Abra la página Create Compute Instance:
    1. Abra el menú de navegación y haga clic en Recursos informáticos. En Recursos informáticos, haga clic en Instancias.
    2. Haga clic en Crear instancia.
  2. Rellene los campos de configuración para especificar los detalles de la pila. Por ejemplo, seleccione la imagen que desea utilizar en la pila.
  3. Haga clic en Guardar como pila.

    Aparece la página Crear pila. El origen de pila "Compute Instance" se indica en la parte superior de la ventana de diálogo, junto con cualquier nombre de instancia proporcionado.

  4. En la página Crear pila, realice lo siguiente.
    1. Introduzca un nombre para la nueva pila. Evite introducir información confidencial.

      Ejemplo: mi instancia de Compute

    2. También puede introducir una descripción.
    3. En el menú desplegable Crear en compartimento, seleccione el compartimento en el que desea crear la pila.

      Por defecto, se define un compartimento desde el ámbito de lista.

    4. Seleccione una versión de Terraform.

      Nota

      Las versiones de Terraform no son compatibles con versiones anteriores.
    5. Si tiene permisos para crear un recurso, también los tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si deben aplicar etiquetas, omita esta opción (puede aplicar las etiquetas posteriormente) o pregunte al administrador.
    6. Haga clic en Siguiente.

      En el panel Configurar variables se muestran variables del archivo de configuración de Terraform seleccionado.

    7. Revise las variables y realice los cambios necesarios.

      Importante

      No agregue la clave privada ni otra información confidencial a las variables de configuración.
    8. Haga clic en Siguiente.
    9. En el panel Revisar, verifique la configuración de la pila.
    10. Para aprovisionar recursos automáticamente cuando se crea la pila, seleccione Ejecutar aplicación.

    11. Haga clic en Crear para crear una pila.

    Aparece la página de detalles de pila para la nueva pila.

    Si se seleccionó Ejecutar aplicación, Gestor de recursos ejecuta la acción de aplicación en la nueva pila.

    Si no se ha seleccionado Ejecutar aplicación, puede ejecutar manualmente la acción de aplicación en la pila.

Para ver cómo Terraform representa sus recursos

Descubra cómo Terraform utiliza la sintaxis de lenguaje de configuración de HashiCorp (HCL) para representar los recursos de Oracle Cloud Infrastructure.

  1. Capture la infraestructura existente mediante la creación de una pila a partir de ese compartimento.

    Pasos clave en la página Crear pila:

    1. En Seleccionar el origen de la configuración de Terraform, seleccione Compartimento existente.

    2. Seleccione compartimento para detección de recursos ( compartimento que contiene los recursos que desea capturar).

      Por defecto, se define un compartimento desde el ámbito de lista.

    3. Seleccione Región para detección de recursos (región que contiene los recursos que desea capturar).
    4. Para filtrar los servicios específicos soportados para la detección de recursos, seleccione Seleccionado y, a continuación, seleccione los servicios que desee.

      Nota

      Este valor no se puede cambiar al editar la pila más tarde.
    5. Haga clic en Siguiente dos veces y, a continuación, haga clic en Crear para crear una pila.

    Aparece la página de detalles de pila para la nueva pila. Se ejecuta una solicitud de trabajo en la pila. Cuando finaliza la solicitud de trabajo, se ejecuta un trabajo para generar un archivo de configuración de Terraform para la pila. Cuando finaliza el trabajo, los recursos del compartimento seleccionado se capturan en la configuración generada.

  2. Descargue el archivo de configuración de Terraform generado: en el separador Información de pila de la página de detalles de pila, haga clic en Descargar.
    Nota

    También puede ver el archivo de configuración de Terraform generado en el Editor de códigos. Para obtener más información, consulte Edición de configuraciones mediante el editor de códigos.
Para recrear (clonar) la infraestructura existente en otro compartimento
  1. Capture la infraestructura existente mediante la creación de una pila a partir de ese compartimento.

    Aparece la página de detalles de pila para la nueva pila. Se ejecuta una solicitud de trabajo en la pila. Cuando finaliza la solicitud de trabajo, se ejecuta un trabajo para generar una configuración de Terraform para la pila. Cuando finaliza el trabajo, los recursos del compartimento seleccionado se capturan en la configuración generada.

  2. Descargue el archivo de configuración de Terraform generado: en el separador Información de pila de la página de detalles de pila, haga clic en Descargar.
  3. Edite el archivo vars.tf (variables del archivo de configuración de Terraform descargado) para especificar el destino compartment_ocid y region.

    Ejemplo:

    variable "compartment_ocid" {
      default = "ocid1.compartment.oc1..uniqueid"
    }
    variable "region" {
      default = "us-phoenix-1"
    }
  4. Si la región de destino tiene más o menos dominios de disponibilidad que la región de origen, edite el archivo vars.tf para especificar el número correcto de dominios de disponibilidad.

    Por ejemplo, si clonó de una región que tiene 3 dominios de disponibilidad y desea volver a crear la infraestructura en una región que solo tiene 1 dominio de disponibilidad, elimine las referencias a los dominios de disponibilidad segundo y tercero.

    Ejemplo que muestra 3 dominios de disponibilidad:

    data oci_identity_availability_domain export_NzDH-EU-FRANKFURT-1-AD-1 {
      compartment_id = var.compartment_ocid
      ad_number      = "1"
    }
    data oci_identity_availability_domain export_NzDH-EU-FRANKFURT-1-AD-2 {
      compartment_id = var.compartment_ocid
      ad_number      = "2"
    }
    data oci_identity_availability_domain export_NzDH-EU-FRANKFURT-1-AD-3 {
      compartment_id = var.compartment_ocid
      ad_number      = "3"
    }

    Ejemplo que muestra 1 dominio de disponibilidad:

    data oci_identity_availability_domain export_NzDH-EU-FRANKFURT-1-AD-1 {
      compartment_id = var.compartment_ocid
      ad_number      = "1"
    }
  5. Cree una segunda pila con el archivo de configuración editado.

    1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
    2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

    3. Haga clic en Crear pila.
    4. En el cuadro de diálogo Crear pila, haga clic en Mi configuración.
    5. Agregue el archivo de configuración de Terraform descargado (.zip).

      Puede dejar los demás campos como están por ahora. Como referencia, consulte Para crear una pila.

    6. Para la versión de Terraform, seleccione una versión soportada por la detección de recursos.
    7. Haga clic en Siguiente para mostrar el panel Configurar variables.
    8. Actualice la variable compartment_ocid para especificar el compartimento de destino de los recursos clonados.
    9. Si desea clonar los recursos en una región diferente, actualice la variable region.
    10. Haga clic en Siguiente para mostrar el panel Revisar.
    11. Para aprovisionar recursos automáticamente cuando se crea la pila, seleccione Ejecutar aplicación.

    12. Haga clic en Crear para crear una pila.

      Aparece la página de detalles de pila para la segunda pila.

      Si se seleccionó Ejecutar aplicación, Gestor de recursos ejecuta la acción de aplicación en la nueva pila.

      Los recursos se clonan en el compartimento y región especificados.

  6. Si no seleccionó Ejecutar aplicación para la nueva pila, ejecute Aplicar ahora (después de ejecutar opcionalmente Plan):
    1. (Opcional) Para confirmar que la pila creará recursos como se esperaba, ejecute un trabajo de plan.
    2. Clonar Recursos: ejecute un trabajo de aplicación en la nueva pila.

      Los recursos se clonan en el compartimento y región especificados.

Para ver pilas

Puede ver los nombres, las descripciones, los estados y la hora de creación de la pila. La página de detalles de una pila muestra su estado de cambio y permite ver el último informe de detección de cambios.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Para mostrar la página de detalles de una pila, haga clic en el nombre de la pila.
Para comprobar la versión del proveedor de Terraform de OCI

Siga estas instrucciones para verificar la versión del proveedor de Terraform de OCI utilizada por el gestor de recursos en la región actual.

Nota

También puede comprobar esta versión con un comando de Terraform. Para obtener instrucciones, consulte Comprobación de las versiones de proveedor de Terraform y OCI Terraform.

La documentación del proveedor de Terraform de OCI refleja cuál es la última versión. Puede ver la documentación de versiones anteriores del proveedor visitando la referencia de HashiCorp y seleccionando una versión específica.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Asegúrese de que la región que desea utilizar esté seleccionada.

    Por ejemplo, seleccione una región comercial dedicada.

  4. Haga clic en el nombre de una pila.

    Se mostrará la página Detalles de pila.

  5. Haga clic en Plan.

    El trabajo de planificación incluye automáticamente la versión del proveedor de Terraform de OCI en su log.

    También puede ejecutar un trabajo de aplicación, que también incluye esta información de versión en su log.

  6. (Opcional) En el panel Plan, revise el nombre del trabajo de planificación y actualícelo si es necesario.

  7. En el panel Plan, haga clic en Plan.

    El nuevo trabajo de planificación se muestra en Trabajos. Cuando se completa el trabajo, aparece la página Detalles del trabajo, donde se muestra el log.

  8. En la página Detalles del trabajo, consulte la versión del proveedor que aparece en el log del trabajo.

    Para acceder al log de trabajos desde esta página, haga clic en Logs en Recursos.

    Ejemplo de versión de proveedor:

    *provider.oci: version = "~> 4.23"
Para descargar el archivo de configuración de Terraform de la pila

El archivo de configuración de Terraform que se muestra en la página de detalles de pila es el mismo que el archivo de configuración de Terraform que se muestra en la página de detalles del trabajo más reciente correcto.

Nota

Para pilas creadas mediante sistemas de control de código fuente, los archivos de configuración no están disponibles para su descarga hasta que se ejecute correctamente un trabajo en la pila.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila para mostrar su página de detalles.
  4. En el separador Información de pila, a la derecha de Configuración de Terraform, haga clic en Descargar.
    Nota

    También puede ver el archivo de configuración de Terraform generado en el Editor de códigos. Para obtener más información, consulte Edición de configuraciones mediante el editor de códigos.
Para detectar los cambios de una pila o recursos seleccionados

Puede detectar los cambios de las nuevas pilas creadas a partir de compartimentos o pilas en las que la última ejecución de trabajo fue Aplicar o Importar estado. Al detectar cambios, puede especificar todos los recursos o los recursos seleccionados.

Cambio es la diferencia entre el estado real de la infraestructura y la última configuración ejecutada de la pila. Por ejemplo, el cambio se produce cuando un miembro del equipo agrega una etiqueta de producción a los recursos o cuando se suprime un recurso.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila para mostrar su página de detalles.

  4. Vaya a Más acciones y seleccione Ejecutar detección de cambios.

    De manera alternativa, en el separador Información de pila, haga clic en Ejecutar detección de cambio ahora.

  5. En el panel Ejecutar detección de cambios, seleccione la opción que desee.

    • Todos los recursos: detecta el cambio de todos los recursos de la pila.

    • Recursos seleccionados: detecta el cambio para los recursos especificados en la pila.

      Puede seleccionar una dirección de la lista o introducirla. Cada recurso se identifica mediante una dirección de recurso, que es una cadena derivada del tipo de recurso y el nombre especificados en la configuración de Terraform de la pila más un índice opcional. Por ejemplo, la dirección de recurso para la cuarta instancia informática con el nombre "test_instance" es oci_core_instance.test_instance[3] (tipo de recurso oci_core_instance, un punto como delimitador, nombre de recurso test_instance e índice 3 entre paréntesis). Para obtener más detalles y ejemplos de direcciones de recursos, consulte la documentación de Terraform en https://www.terraform.io/docs/internals/resource-addressing.html#examples.

  6. (Opcional) Configure las opciones avanzadas:

    • Actualizar versiones de proveedor (la pila debe ser Terraform 0.14 y posterior; se deben actualizar las pilas anteriores para utilizar Terraform Registry): Recupera las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

      Necesario si las versiones de proveedor en la configuración de Terraform cambiaron desde la última vez que se ejecutó un trabajo en la pila. Los archivos de bloqueo de dependencia se gestionan automáticamente para pilas nuevas y actualizadas. Los proveedores se actualizan dentro de las restricciones de versión de la configuración de Terraform.

    • Opcionalmente, etiquete el trabajo.
  7. Haga clic en Ejecutar detección de cambios.

    Se inicia una solicitud de trabajo. Una vez finalizada la solicitud de trabajo, el estado de cambio aparece en el separador Información de pila. Consulte Para ver el último informe de detección de cambios.

Para agregar recursos no gestionados a una pila
Nota

Algunos pasos de este procedimiento utilizan la CLI de Terraform.
  1. Recopile información sobre los recursos no gestionados que desea agregar: tenga en cuenta sus OCID.

    Los recursos no gestionados se crean fuera del gestor de recursos.

    Consejo

    Puede generar una configuración de Terraform que muestre todos los recursos de un compartimento. Para obtener instrucciones, consulte Para ver cómo Terraform representa sus recursos.
  2. Recopilar información de pila
    1. En la consola, acceda a la página de detalles de la pila a la que desea agregar los recursos.

      1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
      2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

      3. Haga clic en el nombre de la pila para mostrar su página de detalles.

    2. Confirme que los recursos gestionados actualmente están actualizados: Genere un informe de detección de cambios.

      1. Vaya a Más acciones y seleccione Ejecutar detección de cambios.

      2. En el panel Ejecutar detección de cambios, seleccione Todos los recursos.

      3. Haga clic en Ejecutar detección de cambios.

        Se inicia una solicitud de trabajo. Una vez finalizada la solicitud de trabajo, el estado de cambio aparece en el separador Información de pila.

      4. Vaya a Más acciones y seleccione Ver informe de detección de cambios.

        Un panel muestra el estado de cambio de los recursos especificados definidos por la pila. Los recursos se identifican por nombres de recursos.

      5. Para ver los detalles del estado de cambio de un recurso, haga clic en la flecha hacia abajo.

        Se muestran las propiedades reales y esperadas.

      6. Si se informan diferencias entre las propiedades reales y las esperadas, haga que los recursos coincidan con las propiedades de la configuración de Terraform: ejecute un trabajo de aplicación. En la página Detalles de pila, haga clic en Aplicar.

        También puede abordar estas diferencias al editar manualmente la configuración de Terraform más adelante.

    3. Descargue el archivo de configuración de Terraform de la pila: en el separador Información de pila, a la derecha de Configuración de Terraform, haga clic en Descargar.

    4. Descargue el archivo de estado de la pila:

      1. Vaya a la página de detalles del trabajo de aplicación más reciente: haga clic en el enlace del trabajo en Trabajos.
      2. En la página de detalles del trabajo, haga clic en Descargar estado de Terraform.
  3. Actualización del archivo de estado mediante la CLI de Terraform
    1. Configure la CLI de Terraform en la máquina local.

      Para obtener instrucciones, consulte CLI de Terraform.

    2. En la máquina local, vaya a la CLI de Terraform y navegue hasta el directorio que contiene la configuración de Terraform descargada y el archivo de estado.

    3. Para cada recurso no gestionado previamente identificado, importe el archivo de estado ejecutando el comando terraform import:

      terraform import -state=<path_to_tfstate_file> -var-file="<path_to_credentials_file>" -var-file="<path_to_env_file>" <resource_name> <resource_ocid>

      Ejemplo:

      terraform import -state=example.tfstate -var-file="credentials.tfvars" -var-file="environments.tfvars" module.operations.oci_identity_compartment.move_compartment ocid1.compartment.oc1..exampleid

      Para obtener más información sobre este comando, consulte Terraform Import CLI Command.

    4. Refresque el archivo de estado ejecutando el comando terraform refresh:

      Nota

      Para refrescar un recurso específico, utilice el destino de refrescamiento -target=<resource>.

      Para obtener más información sobre este comando, consulte Terraform Refresh CLI Command.

  4. Actualice manualmente la configuración de Terraform descargada para incluir el recurso no gestionado previamente identificado.

    Si cualquier cambio no resuelto permanece en el informe de detección de cambios, solucione esas diferencias en la actualización manual.

  5. Actualización de la pila
    1. Vuelva a acceder a la página de detalles de la pila.

      1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
      2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

      3. Haga clic en el nombre de la pila para mostrar su página de detalles.

    2. Importe el archivo de estado refrescado a la pila.

      1. Vaya a Más acciones y seleccione Importar estado.

      2. En el cuadro de diálogo Estado de importación, agregue el archivo de estado de Terraform; para ello, arrástrelo y suéltelo en el control del cuadro de diálogo o haga clic en Examinar y vaya a la ubicación del archivo.

      3. Haga clic en Importar

    3. Cargue la configuración de Terraform editada manualmente en la pila.

      1. En el separador Información de pila, junto a Configuración de Terraform, haga clic en Cargar.

      2. En el cuadro de diálogo Editar pila, en Configuración de pila, haga clic en . Archivo zip y agregue la configuración de Terraform revisada.

        Puede arrastrar y soltar el archivo .zip de configuración de Terraform en el control o haga clic en Examinar y navegue hasta la ubicación del archivo .zip.

      3. Haga clic en Siguiente según sea necesario y, a continuación, haga clic en Guardar cambios.

  6. Confirme que la infraestructura está actualizada
    1. Haga clic en Plan.

    2. En el cuadro de diálogo Plan, revise el trabajo de planificación Nombre y actualícelo si es necesario.

    3. Haga clic en Plan.

      El nuevo trabajo de planificación se muestra en Puestos, con el estado inicial Aceptado. En breve, el estado cambia a En curso. Una vez finalizado el trabajo, consulte el log del trabajo para confirmar que no hay cambios.

      Ejemplo de registro de puesto que no informa cambios:

      No changes. Infrastructure is up-to-date.
      This means that Terraform did not detect any differences between your
      configuration and real physical resources that exist. As a result, no
      actions need to be performed. 

    Felicidades. Ha agregado correctamente recursos no gestionados anteriormente a la pila. El gestor de recursos gestiona los recursos agregados.

Para ver el último informe de detección de cambios
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila para mostrar su página de detalles.
  4. Vaya a Más acciones y seleccione Ejecutar detección de cambios.

    De manera alternativa, en el separador Información de pila, haga clic en Ver informe de detección de cambios.

    Un panel muestra el estado de cambio de los recursos especificados definidos por la pila. Los recursos se identifican por nombres de recursos.

  5. Para ver los detalles del estado de cambio de un recurso, haga clic en la flecha hacia abajo.

    Se muestran las propiedades reales y esperadas.

  6. (Opcional) Para que los recursos coincidan con las propiedades de la configuración de Terraform, ejecute un trabajo de aplicación: en la página Detalles de pila, haga clic en Aplicar.

Para ver un informe de detección de cambios antiguo
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila para mostrar su página de detalles.
  4. Haga clic en Solicitudes de trabajo.
  5. Haga clic en la solicitud de trabajo del informe de detección de cambios que desee.
  6. En el separador Información de solicitudes de trabajo, haga clic en Ver informe de detección de cambios.

    Un panel muestra el estado de cambio de los recursos especificados definidos por la pila en el momento en que se detectó la detección de cambios. Los recursos se identifican por nombres de recursos.

  7. Para ver los detalles del estado de cambio de un recurso, haga clic en la flecha hacia abajo.

    Se muestran las propiedades reales y esperadas.

Para ver el último informe de detección de cambios, consulte Para ver el último informe de detección de cambios. Para detectar de nuevo el cambio, consulte Para detectar el cambio de una pila o recursos seleccionados.

Para editar una pila

Puede editar pilas. Al editar una pila, puede cargar una configuración diferente y cambiar el nombre, la descripción y las variables de la pila.

Nota

Como alternativa a estos pasos, edite el archivo de configuración de Terraform generado en el editor de códigos. Para obtener más información, consulte Edición de configuraciones mediante el editor de códigos.

Si la configuración se almacena en un sistema de control de código fuente, como GitLab, confirme los cambios allí. La confirmación más reciente se utiliza al ejecutar trabajos en la pila.

Si la configuración se almacena en un cubo, no puede cambiar el cubo de la pila existente, pero puede cambiar el contenido del cubo. El contenido más reciente del cubo se utiliza al ejecutar trabajos en la pila.

No hay ningún archivo de configuración disponible para descargar hasta que se ejecute correctamente un trabajo en la pila.

Para obtener información sobre los orígenes de configuración de Terraform admitidos con el gestor de recursos, consulte Dónde almacenar las configuraciones de Terraform.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el menú Acciones y, a continuación, seleccione Editar.

    También puede editar una pila desde su página de detalles. Haga clic en el nombre de la pila para mostrar su página de detalles y, a continuación, haga clic en Editar.

  4. En el cuadro de diálogo Editar pila, cambie las propiedades que desee. Para obtener información sobre la configuración específica del origen, consulte el paso de origen en Para crear una pila.

    Note

    For a stack that specifies an Object Storage bucket, the bucket and compartment cannot be changed.
    • Para editar los valores asignados a variables en una pila, haga clic en Configurar variables.

      También puede editar variables desde la página de detalles de una pila. Haga clic en el nombre de la pila para mostrar la página Detalles de pila, haga clic en Variables (en Recursos) y, a continuación, haga clic en Editar variables.

      Importante

      No agregue la clave privada ni otra información confidencial a las variables de configuración.

      Si desea agregar, volver a configurar o suprimir variables en una pila, actualice la configuración de Terraform.

    • Para aprovisionar recursos automáticamente cuando se actualiza la pila, seleccione Ejecutar aplicación.

      La opción Ejecutar aplicación se muestra en la página Revisar. Haga clic en Revisar a la izquierda para verlo.

  5. Haga clic en Guardar Cambios.

    Aparece la página de detalles de pila para la pila editada.

    Si se ha seleccionado Ejecutar aplicación, Gestor de recursos ejecuta la acción de aplicación en la pila actualizada.

Para utilizar Terraform Registry con una pila anterior

Actualice pilas antiguas para recuperar proveedores del registro de Terraform.

Atención

  • Para evitar versiones de proveedores incompatibles, actualice la configuración para especificar restricciones de versión, mostrando las versiones que existen en el origen de proveedor configurado (proveedor de Terraform o proveedores personalizados).
  • Para evitar fallos de trabajo en versiones de proveedores no disponibles, asegúrese de que las versiones que aparecen en las restricciones de versión de la configuración existan en el origen de proveedor configurado (proveedor de Terraform o proveedores personalizados) o elimine por completo las restricciones de versión (resultados de la recuperación de las últimas versiones).

Para determinar el origen de los proveedores de la pila, revise los logs de un trabajo reciente.

La siguiente frase indica que la pila está recuperando proveedores del registro de Terraform:

Getting providers from hashicorp registry and/or custom terraform providers
Las pilas que se crearon antes de que estuviera disponible el abastecimiento de Terraform Registry continuarán recuperando proveedores desde el gestor de recursos hasta que se actualicen. Cuando se actualizan, las pilas recuperan proveedores de Terraform Registry y proveedores personalizados están disponibles.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.
  3. Haga clic en la pila que desee.
  4. En la página de detalles de la pila, haga clic en Más acciones y, a continuación, seleccione Usar registro de Terraform.
Para utilizar proveedores personalizados con una pila

Descubra cómo actualizar una pila existente para utilizar proveedores personalizados.

Pilas anteriores: si la pila se creó antes de que los proveedores personalizados estuvieran disponibles, primero actualice la pila para utilizar Terraform Registry. Esta actualización permite que la pila utilice proveedores personalizados.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.
  3. Busque la pila que desea, haga clic en el menú Acciones y, a continuación, seleccione Editar.
  4. En el cuadro de diálogo Editar pila, seleccione Usar proveedores personalizados.
  5. Seleccione el cubo que contiene los proveedores personalizados.
  6. Haga clic en Guardar Cambios.
Para ver el estado de una pila

Descargue el archivo de estado correspondiente al trabajo de ejecución más reciente para la pila.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila para mostrar su página de detalles.
  4. Vaya a Más acciones y seleccione Descargar estado de Terraform.
Para gestionar las etiquetas de una pila

Las etiquetas son pares clave/valor que puede asociar a recursos para ayudarle a organizar y rastrear sus recursos a través de los compartimentos. Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre al mismo. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si debe aplicar etiquetas, omita esta opción (puede aplicar etiquetas más tarde) o consulte con el administrador.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila que desee.

    La página Detalles de pila muestra los detalles del trabajo seleccionado.

  4. Haga clic en Etiquetas para ver o editar etiquetas existentes o haga clic en Agregar etiquetas para agregar otras nuevas.
Para mover una pila a un compartimento diferente
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila.
  4. En la página Detalles de pila, vaya a Más acciones y, a continuación, seleccione Mover recurso.
  5. En el cuadro de diálogo Mover recurso, seleccione el compartimento al que desea mover la pila.
  6. Haga clic en Mover recurso.
Para suprimir una pila
Nota

Los recursos asociados se mantienen después de suprimir la pila. Al suprimir una pila, también se suprime su archivo de estado asociado; por lo tanto, pierde el seguimiento del estado de los recursos asociados. La limpieza de recursos asociados a una pila suprimida puede ser difícil sin el archivo de estado, especialmente cuando esos recursos se distribuyen entre varios compartimientos. Para evitar una limpieza complicada más adelante, le recomendamos que primero libere los recursos asociados a los recursos mediante ejecución de un trabajo de destrucción.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el menú Acciones, seleccione Suprimir y confirme la operación cuando se le solicite.

    Nota

    No puede deshacer la operación de supresión de pila.

    También puede suprimir una pila de su página de detalles. Haga clic en el nombre de la pila para mostrar la página Detalles de la pila, vaya a Más acciones y, a continuación, seleccione Suprimir pila.

Gestión de Trabajos (Consola)

Para ver los trabajos y los detalles del trabajo

Puede ver el nombre, el tipo, el estado y otra información clave sobre los trabajos de un compartimento o pila determinado. Puede ver el nombre, el tipo, el estado y otra información clave sobre un trabajo determinado. También puede acceder al plan de ejecución del trabajo (representado por el log del trabajo), a la configuración de Terraform y al estado de Terraform, así como a las variables utilizadas en el trabajo.

Para las configuraciones almacenadas en un sistema de control de código fuente, como GitHub o GitLab, los detalles del trabajo incluyen el identificador de confirmación pertinente.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Gestor de recursos, haga clic en Trabajos.

    También puede acceder a los trabajos desde una página de detalles de pila. Haga clic en Pilas y, a continuación, en el nombre de la pila que desee.

  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Para ver los detalles del trabajo, haga clic en el nombre del trabajo que desee.

    La página Detalles del trabajo muestra los detalles del trabajo seleccionado.

  4. Para ver las variables utilizadas en el trabajo, haga clic en Variables en Recursos.
Para gestionar las etiquetas de un trabajo

Las etiquetas son pares clave/valor que puede asociar a recursos para ayudarle a organizar y rastrear sus recursos a través de los compartimentos. Si tiene permisos para crear un recurso, también tiene permisos para aplicar etiquetas de formato libre al mismo. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si debe aplicar etiquetas, omita esta opción (puede aplicar etiquetas más tarde) o consulte con el administrador.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Gestor de recursos, haga clic en Trabajos.

    También puede acceder a los trabajos desde una página de detalles de pila. Haga clic en Pilas y, a continuación, en el nombre de la pila que desee.

  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre del trabajo que desea.

    La página Detalles del trabajo muestra los detalles del trabajo seleccionado.

  4. Haga clic en Etiquetas para ver o editar etiquetas existentes o haga clic en Agregar etiquetas para agregar otras nuevas.
Para recuperar las últimas versiones de los proveedores

En las restricciones de versión de la configuración de Terraform, recupere las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

Requisitos previos:

Upgrade provider versions is available for the following jobs: Plan, Apply, Destroy, Import state, and Run drift detection.

Al recuperar las últimas versiones de proveedores para un trabajo, el gestor de recursos gestiona automáticamente los archivos de bloqueo de dependencia de la pila.

Para obtener más información sobre las opciones de trabajo avanzado, consulte Para configurar opciones de trabajo avanzadas.

  1. Abra el panel para ejecutar un trabajo en la pila.
  2. En Mostrar opciones avanzadas, seleccione Actualizar versiones de proveedor.
  3. Ejecute el trabajo.
Para configurar opciones de trabajo avanzadas
  1. Visualice el panel de trabajo para el tipo de trabajo que desea ejecutar (Plan, Aplicar o Destruir):
    1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
    2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

    3. Haga clic en el nombre de la pila que desea usar.

      Se mostrará la página Detalles de pila.

    4. Haga clic en la opción del tipo de trabajo que desee:

      • Plan
      • Aplicar
      • Destruir
      • Estado de importación (en Más acciones)
      • Ejecutar detección de cambios (en Más acciones)

      Se muestra el panel de trabajo para el tipo de trabajo seleccionado.

  2. En el panel de trabajo, haga clic en Mostrar opciones avanzadas.
  3. Configure las opciones que desee.
    Note

    Upgrade provider versions is available for the following jobs: Plan, Apply, Destroy, Import state, and Run drift detection. Advanced job options for debugging, parallel operations, and refreshing resources are available for the following jobs: Plan, Apply, and Destroy.
    • Actualizar versiones de proveedor (la pila debe ser Terraform 0.14 y posterior; se deben actualizar las pilas anteriores para utilizar Terraform Registry): Recupera las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

      Necesario si las versiones de proveedor en la configuración de Terraform cambiaron desde la última vez que se ejecutó un trabajo en la pila. Los archivos de bloqueo de dependencia se gestionan automáticamente para pilas nuevas y actualizadas. Los proveedores se actualizan dentro de las restricciones de versión de la configuración de Terraform.

    • Nivel de log detallado: detalle que se utilizará para el contenido del log detallado de Terraform para este trabajo. Por defecto: Ninguno (no se genera contenido de log detallado).

      Para obtener más información, consulte Debugging Terraform.

    • Número máximo de operaciones paralelas: operaciones simultáneas mientras Terraform recorre el gráfico. Valor por defecto: 10.

      Utilice esta opción para acelerar el trabajo.

      Nota

      Un valor alto puede provocar que se limiten los recursos. Por ejemplo, considere una configuración de Terraform que defina cientos de instancias informáticas. Un trabajo de Aplicar intenta crear tantas instancias como sea posible al mismo tiempo. En este ejemplo, un valor de 100 puede provocar la limitación por parte del servicio Compute.

    • Refresque los estados de recursos antes de comprobar las diferencias: recupere el último estado de la infraestructura de pila antes de ejecutar el trabajo. Valor por defecto: Activado.

      Utilice esta opción para refrescar primero el estado. Por ejemplo, considere utilizar esta opción con un trabajo Aplicar para ejecutarse en la infraestructura existente que se actualizó manualmente.

      Nota

      El refrescamiento del estado puede afectar al rendimiento. Considere la posibilidad de desactivar si la configuración incluye varios recursos.

    • Opcionalmente, etiquete el trabajo.
  4. Siga el resto del flujo de trabajo del tipo de trabajo seleccionado.

    El trabajo se ejecuta mediante las opciones configuradas.

Para cancelar un trabajo

Puede cancelar un trabajo que se esté ejecutando.

  1. Si necesita mostrar la página de detalles del trabajo que desea cancelar, haga lo siguiente:
    1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Gestor de recursos, haga clic en Trabajos.

      También puede acceder a los trabajos desde una página de detalles de pila. Haga clic en Pilas y, a continuación, en el nombre de la pila que desee.

    2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

    3. Haga clic en el nombre del trabajo que desea cancelar.

      Se muestra la página de detalles del trabajo.

  2. En la página de detalles, haga clic en Cancelar trabajo.

    Se muestra el cuadro de diálogo Cancelar trabajo.

  3. Si el trabajo es para Estado de importación, Aplicar o Destruir, seleccione la opción que desee:

    • Cancelar tarea

      El gestor de recursos intenta cancelar el trabajo correctamente. Internamente, el proceso de Terraform en ejecución señala a los procesos secundarios que deben terminar. El trabajo puede ejecutarse parcialmente según las respuestas de los procesos secundarios, aunque el estado del trabajo final sea Cancelado.

    • Fuerza la cancelación del trabajo

      Nota

      Forzar la cancelación de un trabajo puede provocar una discrepancia entre el archivo de estado y los estados de recursos reales.
  4. Haga clic en Sí, cancelar trabajo.

Para generar un plan de ejecución (ejecute un trabajo de planificación)

La ejecución de un trabajo de planificación analiza su configuración de Terraform y la convierte en un plan de ejecución que muestra los recursos y las acciones que resultarán al ejecutar un trabajo de aplicación. Para las configuraciones almacenadas en un sistema de control de código fuente, como GitHub o GitLab, el trabajo utiliza la confirmación más reciente. Se recomienda generar un plan de ejecución antes de ejecutar un trabajo de aplicación.

Nota

Un trabajo puede fallar debido a un problema de servicio descendente. Por ejemplo, un trabajo de aplicación destinado a crear una instancia informática puede fallar debido a un problema de conectividad temporal en el servicio Compute. Cuando un trabajo falla debido a un problema de servicio descendente, el trabajo vuelve a intentarlo de acuerdo con la política de reintento por defecto de Go SDK. Consulte SDK de Go para Oracle Cloud Infrastructure.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila que desea usar.

    Se mostrará la página Detalles de pila.

  4. Haga clic en Plan.

  5. (Opcional) En el panel Plan, revise el nombre del trabajo de planificación y actualícelo si es necesario.

  6. (Opcional) Configuración de opciones avanzadas
    • Actualizar versiones de proveedor (la pila debe ser Terraform 0.14 y posterior; se deben actualizar las pilas anteriores para utilizar Terraform Registry): Recupera las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

      Necesario si las versiones de proveedor en la configuración de Terraform cambiaron desde la última vez que se ejecutó un trabajo en la pila. Los archivos de bloqueo de dependencia se gestionan automáticamente para pilas nuevas y actualizadas. Los proveedores se actualizan dentro de las restricciones de versión de la configuración de Terraform.

    • Nivel de log detallado: detalle que se utilizará para el contenido del log detallado de Terraform para este trabajo. Por defecto: Ninguno (no se genera contenido de log detallado).

      Para obtener más información, consulte Debugging Terraform.

    • Número máximo de operaciones paralelas: operaciones simultáneas mientras Terraform recorre el gráfico. Valor por defecto: 10.

      Utilice esta opción para acelerar el trabajo.

      Nota

      Un valor alto puede provocar que se limiten los recursos. Por ejemplo, considere una configuración de Terraform que defina cientos de instancias informáticas. Un trabajo de Aplicar intenta crear tantas instancias como sea posible al mismo tiempo. En este ejemplo, un valor de 100 puede provocar la limitación por parte del servicio Compute.

    • Refresque los estados de recursos antes de comprobar las diferencias: recupere el último estado de la infraestructura de pila antes de ejecutar el trabajo. Valor por defecto: Activado.

      Utilice esta opción para refrescar primero el estado. Por ejemplo, considere utilizar esta opción con un trabajo Aplicar para ejecutarse en la infraestructura existente que se actualizó manualmente.

      Nota

      El refrescamiento del estado puede afectar al rendimiento. Considere la posibilidad de desactivar si la configuración incluye varios recursos.

    • Opcionalmente, etiquete el trabajo.
  7. En el panel Plan, haga clic en Plan.

    El nuevo trabajo de planificación se muestra en Puestos, con el estado inicial Aceptado. En breve, el estado cambia a En curso. Una vez terminado el trabajo, puede revisar el plan de ejecución o descargar la información del trabajo.

Para ver el log de trabajo
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Gestor de recursos, haga clic en Trabajos.

    También puede acceder a los trabajos desde una página de detalles de pila. Haga clic en Pilas y, a continuación, en el nombre de la pila que desee.

  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre del trabajo de planificación que ha ejecutado.

  4. En la página Detalles del trabajo, en Recursos, haga clic en Logs.

    Para los trabajos de planificación, el archivo log es el plan de ejecución. Consulte el archivo log del trabajo de planificación y anote los campos de "mensaje" en la secuencia de entradas de log del archivo log. Estos valores representan la secuencia de operaciones especificada en la configuración.

    También puede descargar la información del trabajo.

Para actualizar la configuración de una pila
Importante

Asegúrese de que el archivo de configuración de Terraform es válido. Consulte Configuraciones de creación y Configuraciones de Terraform para el gestor de recursos.
Nota

Como alternativa a estos pasos, edite el archivo de configuración de Terraform generado en el editor de códigos. Para obtener más información, consulte Edición de configuraciones mediante el editor de códigos.

Si la configuración se almacena en un sistema de control de código fuente, como GitHub o GitLab, confirme los cambios allí. La confirmación más reciente se utiliza al ejecutar trabajos en la pila.

Si la configuración se almacena en un cubo, no puede cambiar el cubo de la pila existente, pero puede cambiar el contenido del cubo. El contenido más reciente del cubo se utiliza al ejecutar trabajos en la pila.

Para obtener información sobre los orígenes de configuración de Terraform admitidos con el gestor de recursos, consulte Dónde almacenar las configuraciones de Terraform.

  1. Si solo está cambiando la configuración de un proveedor de origen de configuración o un bloque de almacenamiento de objetos configurado originalmente para esta pila, omita este paso.

    De lo contrario, asegúrese de que tiene la configuración de Terraform revisada (archivo o carpeta .zip) lista para cargar.

    Para editar una configuración de Terraform generada a partir de una plantilla o un compartimento existente mediante la detección de recursos, primero descargue la configuración. A continuación, utilice el archivo .zip de configuración editada para la actualización.

  2. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  3. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  4. Haga clic en el nombre de la pila que desea actualizar.

    Se mostrará la página Detalles de pila.

  5. En el separador Información de pila, junto a Configuración de Terraform, haga clic en Cargar.

  6. En el cuadro de diálogo Editar pila, en Configuración de pila, realice una de las siguientes acciones:

    El cuadro de diálogo se rellena con la información que incluye la configuración de Terraform.

  7. Haga clic en Siguiente según sea necesario.

  8. Para aprovisionar recursos automáticamente cuando se actualiza la pila, seleccione Ejecutar aplicación.

    La opción Ejecutar aplicación se muestra en la página Revisar. Haga clic en Revisar a la izquierda para verlo.

  9. Haga clic en Guardar Cambios.

    Aparece la página de detalles de pila para la pila editada.

    Si se ha seleccionado Ejecutar aplicación, Gestor de recursos ejecuta la acción de aplicación en la pila actualizada.

    De lo contrario, considere ejecutar la acción Plan en la pila actualizada mediante la configuración revisada.

Para descargar información del trabajo

Puede descargar archivos asociados a trabajos: configuraciones de Terraform, estados de Terraform y logs, incluidos archivos log de Terraform detallados.

  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Gestor de recursos, haga clic en Trabajos.

    También puede acceder a los trabajos desde una página de detalles de pila. Haga clic en Pilas y, a continuación, en el nombre de la pila que desee.

  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre del trabajo que desea.

    Aparece la página Detalles del trabajo.

    Puede ver el log haciendo clic en Logs en Recursos.

    Puede ver el estado de los recursos (para los trabajos relevantes) haciendo clic en Ver estado en Recursos. Opcionalmente, seleccione Mostrar cambios en esta versión.

  4. Descargue la información del trabajo que desee:

    Para descargar este archivo asociado a trabajo Hacer clic en la
    configuración de Terraform (archivo .zip)

    Descargar configuración de Terraform

    Nota: Como alternativa a estos pasos, edite el archivo de configuración de Terraform generado en el Editor de códigos. Para obtener más información, consulte Edición de configuraciones mediante el editor de códigos.

    Estado de Terraform (archivo .json) Descargar estado de Terraform
    Logs (archivo .txt) Download logs (sección Logs en Recursos)
    Archivo log detallado (archivo .log)* Descargar archivo log detallado (en el separador Información del trabajo, a la derecha de Nivel de log detallado)
    Salida del plan (archivo binario o .json) Descargar plan de Terraform y, a continuación, seleccionar la opción de formato de archivo que desea

    *No se genera ningún archivo log detallado para el trabajo a menos que se seleccione un nivel de archivo log detallado. Para obtener instrucciones, consulte Para configurar opciones de trabajos avanzados.

Para ejecutar un trabajo de aplicación

Al ejecutar un trabajo de aplicación para una pila, Terraform crea los recursos y ejecuta las acciones definidas en la configuración de Terraform. Para las configuraciones almacenadas en un sistema de control de código fuente, como GitHub o GitLab, el trabajo utiliza la confirmación más reciente. El tiempo necesario para completar un trabajo de aplicación depende del número y el tipo de recursos en la nube que se van a crear.

Nota

Un trabajo puede fallar debido a un problema de servicio descendente. Por ejemplo, un trabajo de aplicación destinado a crear una instancia informática puede fallar debido a un problema de conectividad temporal en el servicio Compute. Cuando un trabajo falla debido a un problema de servicio descendente, el trabajo vuelve a intentarlo de acuerdo con la política de reintento por defecto de Go SDK. Consulte SDK de Go para Oracle Cloud Infrastructure.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila que desea usar.

    Se mostrará la página Detalles de pila.

  4. Haga clic en Aplicar.

  5. (Opcional) En el panel Aplicar, revise el Nombre del trabajo de aplicación y otros valores, y actualice si es necesario.

  6. (Opcional) Para Aplicar resolución de plan de trabajo, seleccione el nombre del último trabajo de plan generado.

    Solo está disponible el último trabajo de plan generado. Si no se ha generado ningún trabajo de plan para esta pila, solo está disponible el valor predeterminado (Aprobación automática). Para obtener más información sobre Aprobación automática, consulte Opción de aprobación automática para el comando de aplicación de Terraform.

  7. (Opcional) Configuración de opciones avanzadas
    • Actualizar versiones de proveedor (la pila debe ser Terraform 0.14 y posterior; se deben actualizar las pilas anteriores para utilizar Terraform Registry): Recupera las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

      Necesario si las versiones de proveedor en la configuración de Terraform cambiaron desde la última vez que se ejecutó un trabajo en la pila. Los archivos de bloqueo de dependencia se gestionan automáticamente para pilas nuevas y actualizadas. Los proveedores se actualizan dentro de las restricciones de versión de la configuración de Terraform.

    • Nivel de log detallado: detalle que se utilizará para el contenido del log detallado de Terraform para este trabajo. Por defecto: Ninguno (no se genera contenido de log detallado).

      Para obtener más información, consulte Debugging Terraform.

    • Número máximo de operaciones paralelas: operaciones simultáneas mientras Terraform recorre el gráfico. Valor por defecto: 10.

      Utilice esta opción para acelerar el trabajo.

      Nota

      Un valor alto puede provocar que se limiten los recursos. Por ejemplo, considere una configuración de Terraform que defina cientos de instancias informáticas. Un trabajo de Aplicar intenta crear tantas instancias como sea posible al mismo tiempo. En este ejemplo, un valor de 100 puede provocar la limitación por parte del servicio Compute.

    • Refresque los estados de recursos antes de comprobar las diferencias: recupere el último estado de la infraestructura de pila antes de ejecutar el trabajo. Valor por defecto: Activado.

      Utilice esta opción para refrescar primero el estado. Por ejemplo, considere utilizar esta opción con un trabajo Aplicar para ejecutarse en la infraestructura existente que se actualizó manualmente.

      Nota

      El refrescamiento del estado puede afectar al rendimiento. Considere la posibilidad de desactivar si la configuración incluye varios recursos.

    • Opcionalmente, etiquete el trabajo.
  8. En el panel Aplicar, haga clic en Aplicar.

    El nuevo trabajo de aplicación se muestra en Trabajos. Supervisar su estado: Correcto indica que el trabajo ha terminado. Mientras se ejecuta el trabajo, o cuando termine, puede descargar su archivo log.

  9. Para ver el archivo de estado de Terraform (muestra el estado de los recursos después de ejecutar el trabajo), haga clic en el nombre del trabajo de aplicación y, a continuación, en Ver estado en Recursos.

Para ver el estado de un trabajo
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Gestor de recursos, haga clic en Trabajos.

    También puede acceder a los trabajos desde una página de detalles de pila. Haga clic en Pilas y, a continuación, en el nombre de la pila que desee.

  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre del trabajo que desea.

  4. En la página Detalles del trabajo, haga clic en Ver estado en Recursos.

    Opcionalmente, seleccione Mostrar cambios en esta versión.

Para importar un archivo de estado de Terraform existente (ejecute un trabajo de importación)

Puede importar archivos de estado para recursos existentes que ya gestiona Terraform.

Nota

Un trabajo puede fallar debido a un problema de servicio descendente. Por ejemplo, un trabajo de aplicación destinado a crear una instancia informática puede fallar debido a un problema de conectividad temporal en el servicio Compute. Cuando un trabajo falla debido a un problema de servicio descendente, el trabajo vuelve a intentarlo de acuerdo con la política de reintento por defecto de Go SDK. Consulte SDK de Go para Oracle Cloud Infrastructure.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila que desea usar.

    Aparece la página Detalles de pila.

  4. Vaya a Más acciones y seleccione Importar estado.

  5. (Opcional) En el panel Importar, revise el trabajo Nombre y actualícelo si es necesario. Evite introducir información confidencial.

  6. En el panel Importar, agregue el archivo de estado de Terraform; para ello, arrástrelo y suéltelo en el control del cuadro de diálogo o haga clic en Examinar y vaya a la ubicación del archivo.

  7. (Opcional) Configure las opciones avanzadas:

    • Actualizar versiones de proveedor (la pila debe ser Terraform 0.14 y posterior; se deben actualizar las pilas anteriores para utilizar Terraform Registry): Recupera las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

      Necesario si las versiones de proveedor en la configuración de Terraform cambiaron desde la última vez que se ejecutó un trabajo en la pila. Los archivos de bloqueo de dependencia se gestionan automáticamente para pilas nuevas y actualizadas. Los proveedores se actualizan dentro de las restricciones de versión de la configuración de Terraform.

    • Opcionalmente, etiquete el trabajo.
  8. Haga clic en Importar

Para liberar los recursos de una pila (ejecute un trabajo de destrucción)

Ejecute un trabajo de destrucción para eliminar los recursos y limpiar el arrendamiento.

Nota

  • Recomendamos ejecutar un trabajo de destrucción antes de suprimir una pila para liberar primero los recursos asociados. Al suprimir una pila, también se suprime su archivo de estado asociado; por lo tanto, pierde el seguimiento del estado de los recursos asociados. La limpieza de recursos asociados a una pila suprimida puede ser difícil sin el archivo de estado, especialmente cuando esos recursos se distribuyen entre varios compartimientos. Para evitar una limpieza difícil más adelante, recomendamos liberar primero los recursos asociados ejecutando un trabajo de destrucción.

    Los datos no se pueden recuperar de los recursos destruidos.

  • Es posible que un trabajo falle debido a un problema de servicio descendente. Por ejemplo, un trabajo de aplicación destinado a crear una instancia informática puede fallar debido a un problema de conectividad temporal en el servicio Compute. Cuando un trabajo falla debido a un problema de servicio descendente, el trabajo vuelve a intentarlo de acuerdo con la política de reintento por defecto de Go SDK. Consulte SDK de Go para Oracle Cloud Infrastructure.
  1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En Resource Manager, haga clic en Pilas.
  2. Seleccione un compartimento en el que tenga permiso para trabajar (en la parte izquierda de la página). La página se actualiza para mostrar solo los recursos en ese compartimento. Si no está seguro de qué compartimento utilizar, póngase en contacto con un administrador.

  3. Haga clic en el nombre de la pila que desea usar.

    Se mostrará la página Detalles de pila.

  4. Haga clic en Destruir.

  5. (Opcional) En el panel Destruir, revise el trabajo Nombre y actualícelo si es necesario. Evite introducir información confidencial.

  6. (Opcional) Configuración de opciones avanzadas
    • Actualizar versiones de proveedor (la pila debe ser Terraform 0.14 y posterior; se deben actualizar las pilas anteriores para utilizar Terraform Registry): Recupera las últimas versiones disponibles del origen configurado de los proveedores de Terraform.

      Necesario si las versiones de proveedor en la configuración de Terraform cambiaron desde la última vez que se ejecutó un trabajo en la pila. Los archivos de bloqueo de dependencia se gestionan automáticamente para pilas nuevas y actualizadas. Los proveedores se actualizan dentro de las restricciones de versión de la configuración de Terraform.

    • Nivel de log detallado: detalle que se utilizará para el contenido del log detallado de Terraform para este trabajo. Por defecto: Ninguno (no se genera contenido de log detallado).

      Para obtener más información, consulte Debugging Terraform.

    • Número máximo de operaciones paralelas: operaciones simultáneas mientras Terraform recorre el gráfico. Valor por defecto: 10.

      Utilice esta opción para acelerar el trabajo.

      Nota

      Un valor alto puede provocar que se limiten los recursos. Por ejemplo, considere una configuración de Terraform que defina cientos de instancias informáticas. Un trabajo de Aplicar intenta crear tantas instancias como sea posible al mismo tiempo. En este ejemplo, un valor de 100 puede provocar la limitación por parte del servicio Compute.

    • Refresque los estados de recursos antes de comprobar las diferencias: recupere el último estado de la infraestructura de pila antes de ejecutar el trabajo. Valor por defecto: Activado.

      Utilice esta opción para refrescar primero el estado. Por ejemplo, considere utilizar esta opción con un trabajo Aplicar para ejecutarse en la infraestructura existente que se actualizó manualmente.

      Nota

      El refrescamiento del estado puede afectar al rendimiento. Considere la posibilidad de desactivar si la configuración incluye varios recursos.

    • Opcionalmente, etiquete el trabajo.
  7. En el panel Destruir, haga clic de nuevo en Destruir para confirmar la acción.

    Puede supervisar el estado y revisar los resultados de un trabajo de destrucción mediante la visualización del estado o los logs.

  8. Para ver el archivo de estado de Terraform ( muestra el estado de los recursos después de ejecutar el trabajo), haga clic en el nombre del trabajo para mostrar la página Detalles del trabajo y, a continuación, haga clic en Ver estado en Recursos.

    Opcionalmente, seleccione Mostrar cambios en esta versión.

  9. Para ver los logs del trabajo, haga clic en el nombre del trabajo para mostrar la página Detalles del trabajo y, a continuación, haga clic en Logs en Recursos.

Note

You can recreate destroyed resources by running an apply job. Los recursos recreados tienen diferentes OCID y otros metadatos.
Para volver a crear los recursos destruidos de una pila

Utilice este procedimiento para volver a crear los recursos de una pila después de destruir los recursos. Los nuevos recursos difieren de los recursos destruidos anteriormente por sus OCID únicos.

Nota

Los datos no se pueden recuperar de los recursos destruidos.

Uso de la CLI

En esta sección, se proporcionan comandos de la CLI de ejemplo básicos para gestionar pilas y trabajos. Para obtener información sobre el uso de la CLI, consulte la sección sobre Interfaz de línea de comandos (CLI). Para obtener una lista completa de los indicadores y las opciones disponibles para los comandos de la CLI, consulte Ayuda de CLI.

Para obtener un repaso mediante el uso de la CLI para el aprovisionamiento en la nube en un pipeline de integración y despliegue continuos, consulte IaC en la nube: integración de Terraform y el gestor de recursos en su pipeline de integración y despliegue continuos - Creación con la CLI de OCI.

Gestión de pilas (CLI)

Para crear una pila a partir de un archivo (CLI)

Utilice el comando relacionado con la ubicación del archivo. Para obtener información sobre los orígenes de configuración de Terraform admitidos con el gestor de recursos, consulte Dónde almacenar las configuraciones de Terraform.

Importante

Asegúrese de que el archivo de configuración de Terraform es válido. Consulte Authoring Configurations y Terraform Configurations for Resource Manager.
Para crear una pila a partir de un archivo alojado en un sistema de control de código fuente

Abra un comando y ejecute oci resource-manager stack create-from-git-provider para crear una pila a partir de un archivo rastreado con un proveedor de origen de configuración:

oci resource-manager stack create-from-git-provider --compartment-id <compartment_OCID> --config-source-configuration-source-provider-id <configuration_source_provider_OCID> --config-source-repository-url <repository_url> --config-source-branch-name <branch_name> --display-name "<friendly_name>" --description "<description>" --terraform-version "<version>" --variables <var_file_path> --working-directory "<directory>"
Nota

Puede volver más adelante para actualizar la configuración de la pila o agregar variables después de crear la pila.

Por ejemplo:

oci resource-manager stack create-from-git-provider --compartment-id ocid1.tenancy.oc1..uniqueid --config-source-configuration-source-provider-id ocid.ormconfigsourceprovider.oc1..uniqueid --config-source-repository-url https://github.com/user/repo.git --config-source-branch-name mybranch --display-name "My Stack from Git" --description "My Test" --variables file://variables.json --working-directory ""
Para crear una pila a partir de un archivo cargado

En esta sección se describe cómo crear una pila a partir de un archivo de configuración cargado (.zip).

Nota

También puede crear pilas a partir de archivos de configuración almacenados en sistemas de control de código fuente, como Git, y a partir de plantillas.

En Windows, asegúrese de que el archivo .zip y los archivos de variables.json estén en el mismo directorio desde el que está ejecutando la CLI. Actualmente, la CLI tiene una limitación en Windows que evita el manejo correcto de los archivos si uno está en un subdirectorio.

Abra un símbolo del sistema y ejecute oci resource-manager stack create para crear una pila:

oci resource-manager stack create --compartment-id <compartment_OCID> --config-source <config_file_name> --variables <var_file_path> --display-name "<friendly_name>" --description "<description>" --working-directory ""
Nota

Puede volver más adelante para actualizar la configuración de la pila o agregar variables después de crear la pila.

Por ejemplo:

oci resource-manager stack create --compartment-id ocid1.tenancy.oc1..uniqueid --config-source vcn.zip --variables file://variables.json --display-name "My Example Stack" --description "My Tutorial to Create a VCN" --working-directory ""
Respuesta de ejemplo
{
  "data": {
    config-source": 
    {
      "working-directory": null,
      "config-source-type": "ZIP_UPLOAD"
    },
    "defined-tags": {},
    "description": "My Tutorial to Create a VCN",
    "display-name": "My Example Stack",
    "freeform-tags": {},
    "id": "ocid1.ormstack.oc1..uniqueid",
    "lifecycle-state": "ACTIVE",
    "time-created": "2019-04-03T18:26:56.299000+00:00",
    "variables": 
    {
      "compartment_ocid": "ocid1.compartment.oc1..uniqueid", 
      "region": "us-phoenix-1"
    }
  }
}
Para crear una pila a partir de una configuración de Terraform en un cubo de Object Storage

Abra un símbolo del sistema y ejecute la pila del gestor de recursos deoci create-from-object-storage para crear una pila a partir de una configuración de Terraform almacenada en un cubo de Object Storage:

oci resource-manager stack create-from-object-storage --compartment-id <compartment_OCID> --config-source-namespace <bucket_namespace> --config-source-bucket-name <bucket_name> --config-source-region <bucket_region> --display-name "<friendly_name>"  --description "<description>" --variables <var_file_path>
Nota

Puede volver más adelante para actualizar la configuración de la pila o agregar variables después de crear la pila.

Por ejemplo:

oci resource-manager stack create-from-object-storage 
--compartment-id ocid1.tenancy.oc1..uniqueid 
--config-source-namespace MyNamespace
--config-source-bucket-name MyBucket
--config-source-region PHX
--display-name "My Stack from Object Storage" 
--description "My Test" 
--variables file://variables.json
Para copiar una pila

Abra un símbolo del sistema y ejecute oci resource-manager stack copy para copiar una pila en otro compartimento:

oci resource-manager stack copy --stack-id <stack_OCID> --destination-compartment-id <compartment_OCID> --destination-region <region> --display-name "<friendly_name>" --description "<description>" --variables <var_file_path> --access-token <token> --freeform-tags <freeform-tags> --defined-tags <defined-tags>

Utilice las opciones para especificar los siguientes campos de la pila copiada:

  • compartimento de destino
  • región de destino
    Nota

    Cualquier proveedor de origen de configuración utilizado por la pila se copia en la región de destino y el compartimento de origen especificados.
  • nombre mostrado (por defecto cuando no se especifica: copy-from-<source_region>-<originalStackDisplayName>)
  • descripción
  • variables (se retienen los valores de variables existentes a menos que se sobrescriban explícitamente)
  • etiquetas, formato libre y definición (los valores de etiquetas existentes se conservan, a menos que se sobrescriban explícitamente)
  • token de acceso para el proveedor de origen de configuración de la pila (necesario al copiar en una región diferente)

Para obtener una lista completa de los indicadores y las opciones disponibles para los comandos de la CLI, consulte Ayuda de CLI.

Ejemplos
Crear una copia de una pila en el compartimento y la región actuales
oci resource-manager stack copy --stack-id <stack_OCID>
Copiar una pila en otro compartimento
oci resource-manager stack copy --stack-id <stack_OCID> --destination-compartment-id <compartment_OCID>
Copie una pila que utilice CI/CD en otra región

En este ejemplo, la pila utiliza un proveedor de origen de configuración que especifica GitHub, lo que ayuda a lograr una integración continua y una entrega continua (CI/CD). El token de acceso de GitHub es necesario al copiar una pila a otra región.

oci resource-manager stack copy --stack-id <stack_OCID> --destination-region <region> --access-token <token>
Para detectar recursos (crear una pila a partir de un compartimento)

Abra un símbolo del sistema y ejecute oci resource-manager stack create-from-compartment para crear una pila a partir del compartimento y la región especificados:

oci resource-manager stack create-from-compartment --config-source-compartment-id <source_compartment_OCID> --config-source-region <source_region> --config-source-services-to-discover [<services>] –-compartment-id <compartment_OCID> --terraform-version <version --display-name "<friendly_name>" --description "<description>" 

Por ejemplo (detecta recursos soportados de los servicios core y database; el compartimento de origen no es un compartimento raíz):

oci resource-manager stack create-from-compartment --config-source-compartment-id ocid1.tenancy.oc1..uniqueid1 --config-source-region PHX --config-source-services-to-discover [core,database] –-compartment-id ocid1.tenancy.oc1..uniqueid2 --terraform-version 0.13.X --display-name "Stack From Compartment ABC" --description "List of Resources to Duplicate"
Respuesta de ejemplo
{
  "data": {
    "config-source": {
      "config-source-type": "COMPARTMENT_CONFIG_SOURCE"
    },
    "defined-tags": {},
    "display-name": "Stack from Compartment ABC",
    "freeform-tags": {},
    "id": "ocid1.ormstack.oc1..uniqueid",
    "lifecycle-state": "CREATING",
    "time-created": "2019-04-03T18:26:56.299000+00:00",
    "variables": {
      "compartment_ocid": "ocid1.compartment.oc1..uniqueid1", 
      "region": "us-phoenix-1"
    }
  }
}
{
  "data": {
    "compartment-id": "ocid1.compartment.oc1..uniqueid2",
    "config-source": {
      "compartment-id": "ocid1.compartment.oc1..uniqueid1",
      "config-source-type": "COMPARTMENT_CONFIG_SOURCE",
      "region": "PHX",
      "working-directory": null
    },
    "defined-tags": {},
    "description": "List of Resources to Duplicate",
    "display-name": "Stack From Compartment ABC",
    "freeform-tags": {},
    "id": "ocid1.ormstack.oc1.phx.uniqueid",
    "lifecycle-state": "CREATING",
    "stack-drift-status": "NOT_CHECKED",
    "terraform-version": "0.12.x",
    "time-created": "2020-06-01T18:25:56.102000+00:00",
    "time-drift-last-checked": null,
    "variables": {}
  },
  "etag": "009010cb57f5162655c6a34f5ef8834f204a734df81e4baa696a7d830488ea25",
  "opc-work-request-id": "ocid1.ormworkrequest.oc1.phx.uniqueid"
}
Para mostrar recursos para la detección

En esta sección se describe cómo determinar qué servicios están soportados para la detección de recursos desde un OCID de compartimento determinado.

Al crear una pila a partir de un compartimento, la pila representa todos los recursos soportados del compartimento completo, en el ámbito correspondiente. Si selecciona el compartimento raíz para su arrendamiento, el ámbito es el nivel de arrendamiento, como usuarios y grupos. Si selecciona un compartimento no raíz, el ámbito es el nivel de compartimento, como las instancias de Compute.

Abra un símbolo del sistema y ejecute oci resource-manager stack list-resource-discovery-services para recuperar una lista de servicios soportados para la detección de recursos (el OCID de compartimento solo se utiliza para autorización):

oci resource-manager stack list-resource-discovery-services --compartment-id <compartment_OCID>
Para mostrar las pilas de un compartimento

Abra un símbolo del sistema y ejecute oci resource-manager stack list para mostrar las pilas de un compartimento:

oci resource-manager stack list –-compartment-id <compartment_OCID>
Para mostrar los detalles completos de una pila

Abra un símbolo del sistema y ejecute oci resource-manager stack get para mostrar los detalles de la pila especificada:

oci resource-manager stack get –-stack-id <stack_OCID>
Para detectar los cambios de una pila

Abra un símbolo del sistema y ejecute oci resource-manager stack get para mostrar los detalles de la pila especificada: 

oci resource-manager stack detect-drift --stack-id <stack_OCID>
Para mostrar los detalles del recurso en el último informe de detección de cambios de la pila

Abra un símbolo del sistema y ejecute oci resource-manager stack get para mostrar los detalles del recurso para el último informe de detección de cambios de una pila especificada: 

oci resource-manager stack list-resource-drift-details --stack-id <stack_OCID>
Para suprimir una pila
Nota

Los recursos asociados se mantienen después de suprimir la pila. Al suprimir una pila, también se suprime su archivo de estado asociado; por lo tanto, pierde el seguimiento del estado de los recursos asociados. La limpieza de recursos asociados a una pila suprimida puede ser difícil sin el archivo de estado, especialmente cuando esos recursos se distribuyen entre varios compartimientos. Para evitar una limpieza difícil más adelante, recomendamos liberar primero los recursos asociados ejecutando un trabajo de destrucción.

Abra un símbolo del sistema y ejecute oci resource-manager stack delete para suprimir la pila especificada:

oci resource-manager stack delete –-stack-id <stack_OCID>

Gestión de trabajos (CLI)

Para generar un plan de ejecución (ejecute un trabajo de planificación)

Abra un símbolo del sistema y ejecute oci resource-manager job create-plan-job para ejecutar un trabajo de planificación en la pila especificada (--display-name es opcional): 

oci resource-manager job create-plan-job –-stack-id <stack_OCID> --display-name "<friendly_name>"

En función de la complejidad de la configuración, el trabajo de planificación puede tardar varios minutos en completarse. Cuando finalice el trabajo, asegúrese de revisar el plan de ejecución generado antes de ejecutar un trabajo de aplicación.

Para comprobar el estado actual del trabajo de planificación

Abra un símbolo del sistema y ejecute oci resource-manager job get para recuperar la información sobre el trabajo: 

oci resource-manager job get –-job-id <plan_job_OCID>
Estado del ciclo de vida
Valores posibles para lifecycle-state:
  • ACCEPTED: el trabajo está en cola para su ejecución.
  • IN_PROGRESS: el trabajo se está ejecutando.
  • FAILED: el trabajo ha fallado y se ha parado su ejecución.
  • SUCCEEDED: el trabajo ha terminado correctamente.
  • CANCELING: se ha notificado al trabajo la cancelación pero aún no se ha parado la ejecución.
  • CANCELED: el trabajo se ha cancelado y se ha parado su ejecución.
Respuesta de ejemplo

Este ejemplo muestra ACCEPTED para lifecycle-state.

{
  "data": 
  {
    "compartment-id": " ocid1.compartment.oc1..uniqueid",
    "defined-tags": null,
    "display-name": "Example Plan Job",
    "freeform-tags": {},
    "id": "ocid1.ormjob.oc1..uniqueid",
    "lifecycle-state": "ACCEPTED",
    "operation": "PLAN",
    "jobOperationDetails": 
    {
      "operation": "PLAN"
    },
    "stack-id": " ocid1.ormstack.oc1..uniqueid",
    "time-created": "2019-03-09T20:52:13.922000+00:00",
    "time-finished": null,
    "variables": 
    {
      "compartment_ocid": "ocid1.compartment.oc1..uniqueid",
      "region": "us-phoenix-1"
    }
  }
}
Para revisar un plan de ejecución (consulte el log de un trabajo de planificación)

Revise el plan de ejecución para asegurarse de que refleja con precisión las intenciones. Consulte el archivo log y anote los campos de "mensaje" en la secuencia de entradas de log del archivo log. Estos valores representan la secuencia de operaciones especificada en la configuración.

Abra un símbolo del sistema y ejecute oci resource-manager job get-job-logs para ver el archivo log del trabajo especificado: 

oci resource-manager job get-job-logs --job-id <plan_job_OCID>

Si observa problemas o errores y desea realizar cambios, actualice el archivo de configuración (archivo .tf), actualice la pila para usar la configuración revisada, genere un plan de ejecución nuevo y, a continuación, revise el nuevo plan de ejecución.

Respuesta de ejemplo

El comando devuelve objetos JSON que describen las entradas log. Cada objeto tiene un miembro de mensaje con una propiedad que muestra una línea del plan de ejecución. En el ejemplo que se muestra a continuación, la planificación crea una única red virtual en la nube (VCN); los demás miembros muestran detalles sobre VCN.

...
                {
                "level": "INFO",
                "message": "Terraform will perform the following actions:",
                "timestamp": "2018-05-24T00:57:14.170000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "",
                "timestamp": "2018-05-24T00:57:14.170000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "+ oci_core_virtual_network.vcn1",
                "timestamp": "2018-05-24T00:57:14.170000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "id: <computed>",
                "timestamp": "2018-05-24T00:57:14.172000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "cidr_block:  \"10.0.0.0/16\",
                "timestamp": "2018-05-24T00:57:14.172000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "compartment_id:  \"ocid1.tenancy.oc1..exampleaqnpcpfqfmrf6dw5gcew7yqpirvarueirj2mv4jzn5goejsxma\",
                "timestamp": "2018-05-24T00:57:14.172000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "default_dhcp_options_id:  <computed_value>",
                "timestamp": "2018-05-24T00:57:14.172000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "      default_route_table_id: <computed_value>",
                "timestamp": "2018-05-24T00:57:14.172000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                {
                "level": "INFO",
                "message": "      default_security_list_id: <computed_value>",
                "timestamp": "2018-05-24T00:57:14.172000+00:00",
                "type": "TERRAFORM_CONSOLE"
                },
                ...
              
Para actualizar un plan de ejecución (actualice la configuración cargada de una pila)
Nota

Estas instrucciones no se aplican a las configuraciones almacenadas en sistemas de control de código fuente. Para obtener información sobre los orígenes de configuración de Terraform admitidos con el gestor de recursos, consulte Dónde almacenar las configuraciones de Terraform.

Para editar una configuración de Terraform generada a partir de una plantilla o un compartimento existente mediante la detección de recursos, primero descargue la configuración. A continuación, utilice el archivo .zip de configuración editada para la actualización.

Abra un símbolo del sistema y ejecute oci resource-manager stack update con la opción --config-source para actualizar la configuración de Terraform para la pila especificada: 

oci resource-manager stack update --stack-id <stack_OCID> --config-source <config_file_name>

Después de actualizar la pila, vuelva a generar y revisar un plan de ejecución (ejecute un nuevo trabajo del planificación y, a continuación, consulte el archivo log).

Para ejecutar un trabajo de aplicación

Para comprobar el estado actual del trabajo de aplicación

Abra un símbolo del sistema y ejecute oci resource-manager job create-apply-job con el valor relevante para --execution-plan-strategy (uso de ejemplos --display-name, que es opcional): 

  • Para especificar un trabajo de planificación ("aplicar" un plan de ejecución), utilice FROM_PLAN_JOB_ID:

    oci resource-manager job create-apply-job --stack-id <stack_OCID> --execution-plan-strategy FROM_PLAN_JOB_ID --execution-plan-job-id <plan_job_OCID> --display-name "Example Apply Job"

    Utilice esta opción para "aplicar" el plan de ejecución confirmado a la pila, ejecutar las instrucciones y aprovisionar la pila con los recursos especificados.

  • Para aprobar automáticamente el trabajo de aplicación (no se ha especificado ningún trabajo de planificación), utilice AUTO_APPROVED:

    oci resource-manager job create-apply-job --stack-id <stack_OCID> --execution-plan-strategy AUTO_APPROVED --display-name "Example Apply Job"

En función de la complejidad del plan de ejecución, la operación puede tardar un tiempo. Compruebe de forma periódica el estado del ciclo de vida del trabajo de aplicación para ver si cambia de IN_PROGRESS a SUCCEEDED.

Para comprobar el estado actual del trabajo de aplicación

Abra un símbolo del sistema y ejecute oci resource-manager job get para recuperar la información sobre el trabajo: 

oci resource-manager job get –-job-id <apply_job_OCID>
Estado del ciclo de vida
Valores posibles para lifecycle-state:
  • ACCEPTED: el trabajo está en cola para su ejecución.
  • IN_PROGRESS: el trabajo se está ejecutando.
  • FAILED: el trabajo ha fallado y se ha parado su ejecución.
  • SUCCEEDED: el trabajo ha terminado correctamente.
  • CANCELING: se ha notificado al trabajo la cancelación pero aún no se ha parado la ejecución.
  • CANCELED: el trabajo se ha cancelado y se ha parado su ejecución.

Para confirmar la existencia de recursos aprovisionados recientemente, inspeccione los recursos en el compartimento.

Para descargar o ver la información de trabajo

Puede descargar las configuraciones de Terraform y los estados de Terraform asociados a los trabajos. También puede ver los logs asociados a los trabajos.

Para las configuraciones almacenadas en un sistema de control de código fuente, como GitLab, los detalles del trabajo incluyen el identificador de confirmación pertinente.

Para descargar la configuración de un trabajo

Abra un símbolo del sistema y ejecute oci resource-manager job get-job-tf-config para descargar la configuración de Terraform del trabajo especificado en el archivo especificado:

oci resource-manager job get-job-tf-config –job-id <job_OCID> --file <output_file_name>
Para descargar el archivo de estado de un trabajo

Abra un símbolo del sistema y ejecute oci resource-manager job get-job-tf-state para descargar el estado de Terraform del trabajo especificado en el archivo concreto: 

oci resource-manager job get-job-tf-state --job-id <job_OCID> --file <output_file_name>
Ejemplo de respuesta para un trabajo de aplicación
{
  "data": 
  {
    "lineage": "57ef4f0c-c8cd-8a32-d45f-d2c40be7b915",
    "modules": 
    [
      {
        "depends_on": [],
        "outputs": {},
        "path": 
        [
          "root"
        ],
        "resources": 
        {
          "oci_core_virtual_network.vcn1": {
          "depends_on": [],
          "deposed": [],
          "primary": 
          {
            "attributes": {
            "cidr_block": "10.0.0.0/16",
            "compartment_id": "ocid1.tenancy.oc1..uniqueid",
            "default_dhcp_options_id": "ocid1.dhcpoptions.oc1.phx.uniqueid",
            "default_route_table_id": "ocid1.routetable.oc1.phx.uniqueid",
            "default_security_list_id": "ocid1.securitylist.oc1.phx.uniqueid",
            "display_name": "My VCN display name",
            "dns_label": "myvcntest",
            "id": "ocid1.vcn.oc1.phx.uniqueid",
            "state": "AVAILABLE",
            "time_created": "2018-05-24 01:13:05.855 +0000 UTC",
            "vcn_domain_name": "myvcntest.oraclevcn.com"
          },
          "id": "ocid1.vcn.oc1.phx.uniqueid",
          "meta": 
          {
            "e2bfb730-ecaa-11e6-8f88-34363bc7c4c0": {
            "create": 300000000000,
            "delete": 300000000000,
            "update": 300000000000
          }
        },
        "tainted": false
      },
      "provider": "provider.oci",
      "type": "oci_core_virtual_network"
          }
        }
      }
    ],
  "serial": 4,
  "terraform_version": "0.11.7",
  "version": 3
}
                }
Para descargar la salida de un trabajo de plan

Abra un símbolo del sistema y ejecute oci resource-manager job get-job-tf-plan para descargar la salida de un trabajo de planificación:

oci resource-manager job get-job-tf-plan --job-id <job_OCID> --file <output_file_name> --tf-plan-format <binary_or_json>

Por ejemplo, el siguiente comando descarga la salida de un trabajo de plan en formato JSON:

oci resource-manager job get-job-tf-plan --job-id ocid1.ormjob.oc1.phx.<uniqueid> --file tfplan.json --tf-plan-format JSON
Para consultar el log de un trabajo

Consulte el archivo log y anote los campos de "mensaje" en la secuencia de entradas de log del archivo log. Puede ver el archivo log para el trabajo especificado como una lista paginada de entradas o en formato raw.

Para consultar el log como una lista paginada de entradas, abra un símbolo del sistema y ejecute oci resource-manager job get-job-logs:

oci resource-manager job get-job-logs --job-id <job_OCID>

Para ver el log en formato raw, abra un símbolo del sistema y ejecute oci resource-manager job get-job-logs-content:

oci resource-manager job get-job-logs-content --job-id <job_OCID>
Para importar un archivo de estado de Terraform existente (ejecute un trabajo de importación)

Abra un símbolo del sistema y ejecute oci resource-manager x para importar un archivo de estado existente para los recursos que ya gestiona Terraform: 

oci resource-manager job create-import-tf-state-job --stack-id stack_id --tf-state-file state_file
Para inspeccionar recursos en un compartimento

La inspección de recursos en un compartimento le permite confirmar la existencia de un recurso que haya aprovisionado (mediante la ejecución de un trabajo de aplicación) o la ausencia de un recurso que haya liberado (mediante la ejecución un trabajo de destrucción).

Abra un símbolo del sistema y ejecute el comando de CLI correspondiente a los recursos que desee inspeccionar.

Por ejemplo, ejecute oci network vcn list para inspeccionar los recursos de VCN en el compartimento especificado.

oci network vcn list --compartment-id <compartment_OCID>
Para liberar los recursos de una pila (ejecute un trabajo de destrucción)
Nota

Se recomienda ejecutar un trabajo de destrucción antes de suprimir una pila para liberar primero los recursos asociados primero. Al suprimir una pila, también se suprime su archivo de estado asociado; por lo tanto, pierde el seguimiento del estado de los recursos asociados. La limpieza de recursos asociados a una pila suprimida puede ser difícil sin el archivo de estado, especialmente cuando esos recursos se distribuyen entre varios compartimientos. Para evitar una limpieza difícil más adelante, recomendamos liberar primero los recursos asociados ejecutando un trabajo de destrucción.

Abra un símbolo del sistema y ejecute oci resource-manager job create-destroy-job para eliminar y limpiar los recursos aprovisionados por la pila especificada: 

oci resource-manager job create-destroy-job --stack-id <stack_OCID> --execution-plan-strategy=AUTO_APPROVED

Para confirmar la supresión de los recursos, inspeccione los recursos en el compartimento.

Uso de la API

Para obtener más información sobre el uso de la API y las solicitudes de firma, consulte API de REST y Credenciales de seguridad. Para obtener información sobre los SDK, consulte Software development kits e interfaz de línea de comandos.

Utilice estas operaciones de la API para gestionar las pilas:

Utilice estas operaciones de API para gestionar trabajos:

Use estas operaciones de API para gestionar solicitudes de trabajo: