Documentación de Oracle Cloud Infrastructure

Adición de una etapa Compilación gestionada

Agregue una etapa Compilación gestionada en el pipeline de compilación.

Debe agregar repositorios de código en esta etapa de la compilación. Los repositorios se deben configurar antes de agregar la etapa Compilación gestionada. Para crear repositorios, consulte Gestión de repositorios de código.

Antes de agregar una etapa, debe tener un pipeline de compilación.

Para acceder a DevOps mediante la consola de Oracle Cloud, la API de REST y la CLI, consulte Acceso a DevOps.

    1. Abra el menú de navegación y haga clic en Servicios para desarrolladores. En DevOps, haga clic en Proyectos.
    2. Seleccione un proyecto y un pipeline de compilación.
    3. Para agregar una etapa al pipeline, haga clic en el icono + y seleccione Agregar etapa.
    4. Para el tipo de etapa, seleccione Compilación gestionada y, a continuación, haga clic en Siguiente.
    5. Introduzca un nombre y una descripción para la etapa. La adición de una descripción es opcional.
    6. Seleccione la unidad de ejecutor de compilación.

      Puede seleccionar la unidad por defecto (opción de inicio rápido) o personalizarla seleccionando el número de OCPU y la cantidad de memoria (en GB) que necesita. Si personaliza la unidad, tardará más en aprovisionarse.

    7. Seleccione Oracle Linux 7 como imagen de contenedor base.
    8. (Opcional) Para acceder a la red virtual privada:
      1. Seleccione una red virtual en la nube (VCN) y una subred regional en el arrendamiento.
      2. (Opcional) Para restringir el acceso a la VCN, puede seleccionar grupos de seguridad de red (NSG) en las VCN.

      La resolución interna del sistema de nombres de dominio (DNS) de las redes virtuales en la nube no está soportada para el acceso privado. Utilice las IP para comunicarse con los servicios alojados en la red privada.

    9. (Opcional) Introduzca la ruta del archivo de especificación de compilación.

      La especificación de compilación contiene los pasos y la configuración de compilación que utiliza el pipeline de compilación para ejecutar una compilación.

      Nota

      Este paso solo es necesario si el archivo de especificación de creación, build_spec.yaml, no se encuentra en el directorio raíz del repositorio de código principal.
    10. Seleccione el repositorio de código principal para la compilación.
      • Seleccione el tipo de conexión y una conexión para el repositorio. Los tipos de conexión soportados son:

        Solo se pueden seleccionar las conexiones externas que ya haya configurado. Si no existe ninguna conexión, haga clic en el enlace Crear una conexión.

      • Si selecciona GitHub o GitLab, seleccione un repositorio.
      • Si selecciona Bitbucket Cloud, escoja un espacio de trabajo y un repositorio.
      • Si ha seleccionado Visual Builder Studio (VBS), escoja un repositorio y un proyecto de VBS externo.
      • Si selecciona Bitbucket Server o GitLab Server, introduzca la URL del repositorio que contiene el origen de la compilación.
      • Seleccione o introduzca una rama para el repositorio de código seleccionado.

        La compilación se produce en la rama que dispara la ejecución de compilación, en lugar de en la rama configurada al agregar la etapa de generación. La rama configurada se puede utilizar cuando la ejecución de compilación se dispara manualmente mediante la consola de OCI.

      • En Nombre de origen de compilación, introduzca un nombre único para la carpeta donde se descarga el código fuente en el programa de ejecución de compilación. Ejemplos: Source1, Source2.
      • Guarde los cambios.
    11. Para agregar más repositorios de código, haga clic en Agregar origen de compilación y seleccione los repositorios.
    12. (Opcional) Introduzca un valor de timeout (en segundos) para la etapa.
    13. (Opcional) Para agregar etiquetas a la etapa, haga clic en Mostrar opciones de etiquetado. El etiquetado es un sistema de metadatos que permite organizar los recursos del arrendamiento y realizar su seguimiento.

      Si tiene permisos para crear un recurso, también los tiene para agregarle etiquetas de formato libre.

      Para agregar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de etiqueta.

      Para obtener más información, consulte Etiquetas de recurso.

    14. Para agregar la etapa al pipeline, haga clic en Agregar.

      Una vista previa de etapa proporciona una instantánea de la configuración.

    Puede agregar las siguientes etapas de forma secuencial o en paralelo al pipeline:
    • Enviar artefactos: almacene las aplicaciones de software creadas desde la etapa Compilación gestionada en los repositorios de Oracle Cloud Infrastructure (OCI) Artifact Registry o OCI Container Registry.
    • Despliegue de disparador: inicie un pipeline de despliegue para desplegar la salida del pipeline de compilación.
    • Espera: realiza una pausa de una duración específica para probar el pipeline de compilación.

    Puede ejecutar la creación manualmente o disparar una ejecución de creación automáticamente al confirmar los cambios en el repositorio de código. La ejecución manual utiliza la última confirmación en el repositorio de código. Puede ejecutar la compilación basándose en una confirmación específica observando los detalles de la confirmación.

  • Para crear un pipeline de compilación, ejecute el comando create:

    oci devops build-pipeline create --project-id

    Para agregar una etapa Compilación gestionada para el pipeline, ejecute el comando create-build-stage:

    oci devops build-pipeline-stage create-build-stage

    Los parámetros necesarios son:

    • --build-pipeline-id
    • --build-source-collection
    • --image
    • --stage-predecessor-collection

    El parámetro opcional para configurar la unidad del programa de ejecución de compilación es:

    --build-runner-config

    Para obtener todos los comandos para build-pipeline y build-pipeline-stage:

    oci devops build-pipeline -h
    oci devops build-pipeline-stage -h

    Para obtener ayuda para el comando create-build-stage:

    oci devops build-pipeline-stage create-build-stage -h

  • Para crear un pipeline de compilación, utilice la operación CreateBuildPipeline.

    Para agregar una etapa Compilación gestionada para el pipeline, utilice la operación CreateBuildPipelineStage. Para el atributo buildPipelineStageType, especifique el valor como BUILD.

    Además de la solicitud CreateBuildStageDetails, debe agregar uno de los atributos proporcionados para personalizar la unidad del programa de ejecución de compilación:

    .buildRunnerShapeConfig(CustomBuildRunnerShapeConfig.builder().ocpus(<no_of_ocpus>).memoryInGBs(<memory_in_gbs>).build())
    .buildRunnerShapeConfig(DefaultBuildRunnerShapeConfig.builder().build())