Galería de PowerShell origen ascendente

  • Artículo

La habilitación de orígenes ascendentes para la fuente amplía el acceso de los desarrolladores a los paquetes de los registros públicos. En este artículo, aprenderá a configurar el Galería de PowerShell como origen ascendente y a consumir paquetes de PowerShell desde el registro público.

Requisitos previos

Si el Galería de PowerShell origen ascendente no está disponible en la fuente de forma predeterminada, puede agregarlo de la manera siguiente:

  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 botón engranaje de icono de engranaje para ir al Configuración de fuente.

  4. Seleccione Orígenes ascendentes y, después, Agregar ascendente.

    Captura de pantalla que muestra cómo agregar un nuevo origen ascendente.

  5. Seleccione Origen público y, a continuación, seleccione Galería de PowerShell en el menú desplegable. Cuando haya terminado, haga clic en Guardar.

    Captura de pantalla que muestra cómo agregar el Galería de PowerShell como origen ascendente.

  6. Seleccione Guardar en la esquina superior derecha para guardar los cambios. Seleccione Guardar de nuevo si se le pide que confirme las opciones.

Conexión a la fuente

  1. Cree un token de acceso personal con permisos de lectura y escritura de empaquetado>.

  2. Ejecute los siguientes comandos en una ventana del símbolo del sistema de PowerShell y reemplace los marcadores de posición por la información adecuada:

    $patToken = "<YOUR_PERSONAL_ACCESS_TOKEN>" | ConvertTo-SecureString -AsPlainText -Force

    $myCredentialsObject = New-Object System.Management.Automation.PSCredential("<USER_NAME>", $patToken)

  3. Ejecute el siguiente comando para registrar la fuente como PSRepository. Reemplace los marcadores de posición por los valores adecuados:

    • Fuente con ámbito de proyecto:

      Register-PSRepository -Name "PSGalleryUpstream" -SourceLocation "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2" -PublishLocation "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2" -InstallationPolicy Trusted -Credential $myCredentialsObject

    • Fuente con ámbito de organización:

      Register-PSRepository -Name "PSGalleryUpstream" -SourceLocation "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2" -PublishLocation "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2" -InstallationPolicy Trusted -Credential $myCredentialsObject

Guardar paquetes de nivel superior

Ahora que agregó el Galería de PowerShell como origen ascendente y registró la fuente como PSRepository, cada vez que instale un paquete desde la cadena ascendente, se guardará una copia en la fuente. En el ejemplo siguiente, instalaremos el módulo PSScriptAnalyzer :

Install-Module -Name PSScriptAnalyzer -Repository PSGalleryUpstream

Nota:

Para guardar paquetes de nivel superior, debe tener el rol Lector de fuente y ascendente (colaborador) o superior. Para más información, consulte Permisos.

Visualización de paquetes guardados

Puede acceder a los paquetes que ha guardado en el Galería de PowerShell eligiendo el origen adecuado en el menú desplegable.

  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 Origen a la derecha y, a continuación, seleccione Galería de PowerShell para filtrar los paquetes guardados desde la cadena ascendente. Puede ver que el paquete PSScriptAnalyzer , que se instaló en el paso anterior, se ha guardado en nuestra fuente.

    Captura de pantalla que muestra los paquetes guardados de nivel superior en una fuente de Azure Artifacts.