Publicación y descarga de paquetes universales en Azure Artifacts

Azure DevOps Services

Los paquetes universales permiten a los desarrolladores almacenar una amplia gama de tipos de paquetes más allá de los tradicionales, como NuGet, npm, paquetes de Python, etc. Con la CLI de Azure, puede publicar y descargar paquetes universales directamente desde la línea de comandos. Aunque el tamaño de los paquetes publicados puede variar, alcanzar hasta 4 TB, siempre debe mantener el requisito esencial de incluir un nombre y un número de versión. Este artículo le guiará por los pasos necesarios para publicar y descargar paquetes universales desde la fuente de Azure Artifacts.

Requisitos previos

• Una organización de Azure DevOps y un proyecto. Cree una organización o un proyecto si aún no lo ha hecho.

• Instalación de la CLI de Azure.

• Instale la versión 0.14.0 o posterior de la extensión de Azure DevOps.

Crear feed

Si ya tiene una fuente, puede pasar a la sección siguiente. De lo contrario, siga los pasos siguientes para crear una nueva fuente de Azure Artifacts:

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Artefactos y, a continuación, Crear feed.

3. Proporcione un nombre descriptivo para la fuente y establezca su visibilidad (que puede ver los paquetes en la fuente). Defina el ámbito de la fuente y, a continuación, active la casilla Orígenes ascendentes si desea incluir paquetes de registros públicos.

4. Seleccione Crear cuando haya terminado.

   

Nota:

Las fuentes recién creadas designan el rol servicio de compilación del proyecto como Fuente y Lector ascendente (Colaborador) de forma predeterminada.

Instalación de la extensión de Azure DevOps

El uso de la CLI ayuda a simplificar las tareas. Antes de continuar, asegúrese de que ha instalado la CLI de Azure (versión 2.10.1 o posterior). Además, es necesario instalar la extensión de Azure DevOps para administrar los servicios de Azure DevOps desde la línea de comandos.

1. Ejecute el siguiente comando para instalar la extensión de Azure DevOps:

   az extension add --name azure-devops
   

2. Si ya tiene instalada la extensión de Azure DevOps y quiere actualizarla a la versión más reciente, ejecute el siguiente comando:

   az extension update --name azure-devops
   

Conexión a la fuente

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Artefactos y, a continuación, seleccione la fuente en el menú desplegable.

3. Seleccione Conectar para alimentar y, a continuación, seleccione Paquetes universales en el panel de navegación izquierdo.

4. Siga las instrucciones de la sección Configuración del proyecto para conectarse a la fuente.

Windows

1. Ejecute el siguiente comando para iniciar sesión en la CLI de Azure:

   az login
   

2. Ejecute el siguiente comando para establecer el proyecto y la organización como configuración predeterminada de la CLI:

   az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME> 
   

Otros

1. Cree un token de acceso personal con el ámbito de lectura y escritura de empaquetado y, a continuación, cópielo en el Portapapeles.

2. Ejecute el siguiente comando para iniciar sesión. Cuando se le solicite, pegue el token de acceso personal que creó en el paso anterior y presione Entrar.

   az devops login --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> 
   

Publicación de Universal Packages

Para publicar un paquete universal en la fuente, debe proporcionar un nombre de paquete y un número de versión.

El nombre del paquete debe estar en minúsculas, iniciar y terminar con letras o números, y solo contener letras, números y guiones noconsecutivos, caracteres de subrayado y puntos. La versión del paquete también debe estar en minúsculas y no debe incluir metadatos de compilación (+ sufijo). Consulte Control de versiones semánticas para obtener más detalles.

1. Ejecute el siguiente comando para publicar el paquete universal en la fuente:

   • Feed con ámbito de organización:

     az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
     

   • Fuente con ámbito de proyecto:

     az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
     

Nota:

Si su organización usa un firewall o un servidor proxy, asegúrese de permitir direcciones IP y direcciones URL de dominio de Azure Artifacts.

Visualización de paquetes publicados

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Seleccione Artefactos y, a continuación, elija la fuente en el menú desplegable. Una vez completado correctamente el proceso de publicación, el paquete debe estar disponible en la fuente.

   

Descargar paquetes universales

Ejecute el siguiente comando para descargar un paquete universal determinado desde la fuente mediante la CLI de Azure:

• Feed con ámbito de organización:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
  

• Fuente con ámbito de proyecto:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
  

Descarga de archivos específicos

Si desea descargar solo archivos específicos, use el --file-filter parámetro para capturar un subconjunto de archivos. Consulte Referencia de patrones de coincidencia de archivos para obtener más detalles.

• Feed con ámbito de organización:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
  

• Fuente con ámbito de proyecto:

  az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
  

Ejemplo: por ejemplo, el uso de --file-filter logs/.log coincidiría con cualquier archivo con un nombre de archivo que contenga "registros" y terminar con la extensión ".log" (por ejemplo, build_logs.log).

Descargar la última versión

Puede usar caracteres * comodín para descargar la versión más reciente de los paquetes universales.

Ejemplos:

• --version '*': descargue la versión más reciente.

• --version '1.*': descargue la versión más reciente con la versión principal 1.

• --version '1.2.*': descargue la versión de revisión más reciente con la versión principal 1 y la secundaria 2.

Nota:

Los patrones comodín no se admiten con versiones preliminares (paquetes con guiones en su número de versión).

Artículos relacionados

• Publicación y descarga de Universal Packages con Azure Pipelines
• Orígenes ascendentes de paquetes universales
• Administración de permisos