Documentación de Oracle Cloud Infrastructure

Adición de un artefacto de Artifact Registry

Cree una referencia a artefactos ubicados en un repositorio del registro de artefactos.

En el pipeline de compilación, para almacenar la salida de la etapa Compilación gestionada, necesita un repositorio Container Registry o un repositorio Artifact Registry de OCI.

Debe crear una referencia de artefacto para que apunte a la ubicación del repositorio que contiene la salida de compilación. Antes de crear una referencia de artefacto, debe tener un proyecto de DevOps y tener acceso al repositorio de Artifact Registry. Consulte Acceso a Artifact Registry.

Oracle Cloud Infrastructure Artifact Registry es un servicio de repositorio para almacenar, compartir y gestionar paquetes de desarrollo de software.

Puede crear una referencia a tres tipos de artefactos en Artifact Registry: configuraciones de despliegue de grupo de instancias, artefactos generales, manifiestos de Kubernetes y especificaciones de comando.

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. En la página DevOps Proyectos, seleccione el proyecto para el que desea agregar un artefacto.
    3. En la página de detalles del proyecto, en el lado izquierdo, haga clic en Artefactos.
    4. En la página Artefactos, haga clic en Agregar artefacto.
    5. En el panel Agregar artefacto, proporcione los siguientes detalles:
      1. Introduzca un nombre para el artefacto.
      2. Para Tipo, seleccione Configuración de despliegue de grupo de instancias, Artefacto general, Manifiesto de Kubernetes o Especificación de comando.

        Un archivo de configuración de despliegue define los artefactos que se van a descargar en la instancia y la ubicación en la que se deben copiar los artefactos. Para obtener más información, consulte Archivo de configuración de despliegue.

        Un archivo de especificación de comando contiene comandos y pasos definidos por el usuario que se ejecutan en un pipeline de despliegue. Para obtener más información, consulte Especificación de comando.

      3. En Origen de artefacto, seleccione Repositorio de Artifact Registry.

        Para obtener más información, consulte Artifact Registry.

      4. Para seleccionar un repositorio de Artifact Registry, haga clic en Seleccionar.
      5. Seleccione la región y el compartimento en el que se encuentra el artefacto.
      6. Seleccione un repositorio de la lista disponible.
      7. Seleccione la ubicación del artefacto. Las opciones disponibles son las siguientes:
        • Seleccionar ubicación existente: seleccione un artefacto del repositorio seleccionado.
        • Definir ubicación personalizada: introduzca la ruta (ubicación) del artefacto que desea agregar e introduzca la versión del artefacto. La versión del artefacto también se puede configurar como un parámetro. Para obtener más información, consulte Configuración de parámetros.
      8. Seleccione Permitir parametrización si desea sustituir los marcadores de posición en el contenido del artefacto por valores de argumento proporcionados durante el despliegue.

        Para obtener más información, consulte Configuración de parámetros.

      9. (Opcional) Para agregar etiquetas al artefacto, haga clic en Mostrar opciones de etiquetado. El etiquetado es un sistema de metadatos que permite organizar los recursos de su arrendamiento y realizar su seguimiento.

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

        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.

    6. Haga clic en Agregar.

    Se crea una referencia al artefacto en el repositorio de Artifact Registry.

  • Para crear una referencia de artefacto de Artifact Registry, ejecute el comando create-generic-artifact:

    oci devops deploy-artifact create-generic-artifact

    Parámetros necesarios para el comando create-generic-artifact:

    • --argument-substitution-mode
    • --artifact-path
    • --artifact-version
    • --repository-id
    • --artifact-type
    • --project-id

    Para obtener todos los comandos para deploy-artifact:

    oci devops deploy-artifact -h

    Para obtener ayuda para el comando create-generic-artifact:

    oci devops deploy-artifact create-generic-artifact -h

  • Para crear una referencia de artefacto de Artifact Registry, utilice la operación CreateDeployArtifact. Para el atributo deployArtifactType, seleccione uno de los siguientes valores:

    • DEPLOYMENT_SPEC
    • KUBERNETES_MANIFEST
    • GENERIC_FILE