Publicación y descarga de paquetes universales

  • Artículo
  • 3 minutos para leer

Con los paquetes universales, los usuarios pueden almacenar distintos tipos de paquetes distintos de los ampliamente usados, como los paquetes NuGet, npm, Maven o Python. Los paquetes cargados pueden variar de tamaño (probados hasta 4 TB), pero siempre deben tener un nombre y un número de versión. Puede publicar y descargar paquetes universales desde la línea de comandos mediante el CLI de Azure.

Esta guía de inicio rápido le guía por los pasos necesarios para publicar y descargar su primer paquete universal hacia y desde la fuente mediante la línea de comandos.

Requisitos previos

  1. Descargue e instale la versión CLI de Azure más reciente.
  2. Si usa Linux, asegúrese de que tiene la versión adecuada de .NET en Linux.

Para comprobar la versión de CLI de Azure módulos y extensiones que tiene actualmente, ejecute el siguiente comando:

az --version

Puede instalar la extensión Azure DevOps mediante el siguiente comando:

az extension add --name azure-devops

Si ya tiene la extensión Azure DevOps pero desea actualizar a la versión más reciente, ejecute el siguiente comando:

az extension update --name azure-devops

Creación de una fuente

Una fuente es una construcción organizativa que permite almacenar y administrar los paquetes y controlar quién puede acceder a ellos.

  1. Desde dentro del proyecto, vaya a Azure Artifacts.

    Vaya a Azure Artifacts

  2. Seleccione Crear fuente.

    Botón Nueva fuente

  3. Asigne un nombre a la fuente y elija su visibilidad, orígenes ascendentesy configuración de ámbito.

    Cuadro de diálogo Nueva fuente

  4. Seleccione Crear cuando haya terminado.

Azure Artifacts está instalado de forma predeterminada para los clientes de TFS 2017. Debe actualizar a TFS 2017 para poder usar Azure Artifacts. Si es la primera vez que usa la fuente, es posible que se le pida que asigne una licencia.

  1. Vaya a Build Release (Versión de compilación) y seleccione Packages (Paquetes).

    Vaya a Azure Artifacts TFS

  2. Seleccione + Nueva fuente.

    Nuevo botón de fuente TFS

  3. Asigne a la fuente un nombre, una descripcióny configure quién puede leer ,quién puede contribuir y si desea incluir paquetes externos.

    Cuadro de diálogo Nueva fuente TFS

  4. Seleccione Crear cuando haya terminado.

Inicie sesión en Azure DevOps

Después de instalar el CLI de Azure, ejecute el siguiente comando en una ventana del símbolo del sistema con privilegios elevados para iniciar sesión en Azure. Reemplace el texto entre corchetes [] por los nombres adecuados.

az login

Sugerencia

Para acceder a los inquilinos sin suscripciones, ejecute az login --allow-no-subscription .

A continuación, establezca el proyecto y la organización como valor predeterminado de la CLI.

az devops configure --defaults organization=https://dev.azure.com/[your-organization] project=[your-project-name]

Publicación de un paquete universal

Ahora podemos usar el comando az artifacts universal para administrar nuestros paquetes universales. En el ejemplo siguiente publicaremos my-first-package, versión 1.0.0 en la fuente FabrikamFiber de la organización fabrikam. FibrikamFiber es una fuente de ámbito de organización.

Los nombres de paquete deben estar en minúsculas y solo pueden usar letras, números y guiones. Las versiones del paquete deben estar en minúsculas sin metadatos de compilación (+ sufijo). Consulte SemVer para obtener más información sobre el control de versiones semántico.

az artifacts universal publish --organization https://dev.azure.com/Fabrikam --feed FabrikamFiber --name my-first-package --version 1.0.0 --description "My first universal package" --path .

Visualización del paquete en la fuente

Para ver el paquete que acaba de publicar, vaya a su organización, seleccione el proyecto, seleccione Artifacts y, acontinuación, seleccione la fuente en el menú desplegable.

Visualización del paquete universal publicado

Descarga de un paquete universal

Ahora que ha publicado su primer paquete universal, vamos a intentar descargarlo mediante CLI de Azure. En el ejemplo siguiente se descargará el paquete que se publicó anteriormente.

az artifacts universal download --organization https://dev.azure.com/Fabrikam --feed FabrikamFiber --name my-first-package --version 1.0.0 --path .

Nota

Azure DevOps no admite vínculos de descarga HTTP/HTTPS directos.

Descarga de archivos específicos

Si no necesita todo el paquete universal y solo necesita archivos específicos, puede usar el parámetro --file-filter para descargar un subconjunto de archivos.

El ejemplo siguiente *logs/*.log coincidiría con cualquier archivo que termine *logs/*.log y con la extensión .log. Ejemplo: build123_logs.log

Consulte Referencia de patrones de coincidencia de archivos para obtener más detalles.

az artifacts universal download --organization https://dev.azure.com/fabrikam --feed FabrikamFiber --name my-first-package --version 1.0.0 --path .  --file-filter *logs/*.log

Descarga de la versión más reciente

Puede usar caracteres comodín para descargar la versión más reciente de su Universal Packages.

Sintaxis:

--version -v: versión del paquete, por ejemplo, "2.1.0".

Ejemplos:

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

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

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

Nota

Los caracteres comodín no se admiten en la versión anterior.