Share via

Promoción de paquetes y administración de vistas de fuente en Azure Artifacts

  • Artículo

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Las vistas de fuente son una manera de permitir que los usuarios compartan algunos paquetes al tiempo que mantienen otros paquetes privados. Las vistas filtran la fuente a un subconjunto de paquetes que cumplen un conjunto de criterios definidos por esa vista.

De forma predeterminada, Azure Artifacts incluye tres vistas: @Local, @Prerelease y @Release. @local es la vista predeterminada que contiene todos los paquetes publicados y todos los paquetes guardados de orígenes ascendentes. Todas las vistas admiten paquetes NuGet, npm, Maven, Python y Universal.

Nota:

Azure Artifacts solo admite la publicación y restauración de paquetes desde y en la vista predeterminada: @Local.

Promover paquetes

  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 el paquete que desea promocionar y, a continuación, seleccione Promover.

    Captura de pantalla que muestra cómo promover un paquete a una vista.

  4. Seleccione una vista en el menú desplegable y, a continuación, seleccione Promover.

    Captura de pantalla que muestra las vistas de fuente disponibles.

Nota:

No se admite la degradación de paquetes. Si desea que esta característica se agregue a una versión futura, no dude en Sugerir una característica en la Comunidad de desarrolladores de Azure DevOps.

Promoción de paquetes mediante la API REST

Además de usar la interfaz de usuario de Azure Artifacts, también puede promover paquetes mediante la API REST. El URI varía en función del tipo de paquete:

Use el nombre y la versión reales del paquete para los {packageName} campos y {packageVersion} , respectivamente. Si la fuente tiene el ámbito de la organización, omita el {project} campo .

El cuerpo de la solicitud es un documento de revisión JSON que agrega la vista al final de la views matriz. Consulte Introducción a la API REST y los ejemplos de la API REST para obtener más información sobre cómo interactuar con la API rest de Azure DevOps.

  • Fuente con ámbito de la organización:

    PATCH https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1-preview.1

  • Fuente con ámbito de proyecto:

    PATCH https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1-preview.1

    Use JsonPatchOperation para construir el cuerpo de la solicitud. Consulte NuGet: actualización de la versión del paquete para obtener más detalles.

  • Ejemplo:
PATCH https://pkgs.dev.azure.com/fabrikam-fiber-inc/litware/_apis/packaging/feeds/litware-tools/nuget/packages/LitWare.Common/versions/1.0.0?api-version=5.1-preview.1 HTTP/1.1
Content-Type: application/json-patch+json

{
  "views": {
    "op": "add",
    "path": "/views/-",
    "value": "Release"
  }
}

Administrar vistas

Puede crear sus propias vistas o cambiar el nombre y eliminar las existentes de la configuración de la fuente.

Nota:

Todas las vistas de fuente de un proyecto público son accesibles para todos los usuarios de Internet.

  1. Seleccione Artifacts (Artefactos).

  2. Seleccione la fuente en el menú desplegable.

  3. Seleccione el icono de engranaje para acceder a la configuración de la fuente.

    Captura de pantalla que muestra cómo acceder a la configuración de la fuente.

  4. Seleccione Vistas.

    Captura de pantalla que muestra cómo navegar a las vistas.

  5. Seleccione una vista y, a continuación, seleccione Editar para editar la vista o seleccione Agregar vista si desea agregar una nueva vista.

  6. Cuando haya terminado, haga clic en Guardar.

Importante

En el caso de las fuentes públicas, si cambia los permisos de acceso de una vista determinada a Usuarios específicos, la vista no estará disponible como origen ascendente.