Share via

Origem upstream da Galeria do PowerShell

  • Artigo

Habilitar fontes upstream para seu feed amplia o acesso de seus desenvolvedores a pacotes de registros públicos. Neste artigo, você aprenderá a configurar a Galeria do PowerShell como uma fonte upstream e consumir pacotes do PowerShell do registro público.

Pré-requisitos

Se a origem upstream da Galeria do PowerShell não estiver disponível em seu feed por padrão, você poderá adicioná-la da seguinte maneira:

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.

  3. Selecione o botão ícone de engrenagem ícone de engrenagem do ícone de engrenagem para navegar até as Configurações do Feed.

  4. Selecione Fontes upstream e, em seguida, selecione Adicionar Upstream.

    Uma captura de tela mostrando como adicionar uma nova fonte upstream.

  5. Selecione Fonte pública e, em seguida, selecione Galeria do PowerShell no menu suspenso. Selecione Salvar ao terminar.

    Uma captura de tela mostrando como adicionar a Galeria do PowerShell como uma fonte upstream.

  6. Selecione Salvar no canto superior direito para salvar suas alterações. Selecione Salvar novamente se solicitado a confirmar suas escolhas.

Conectar-se ao feed

  1. Crie um token de acesso pessoal com permissões de leitura e gravação do Packaging>Reading.

  2. Execute os seguintes comandos em uma janela de prompt do PowerShell, substituindo os espaços reservados pelas informações apropriadas:

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

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

  3. Execute o seguinte comando para registrar seu feed como um PSRepository. Substitua os espaços reservados pelos valores apropriados:

    • Feed do projeto com escopo:

      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

    • Feed com escopo organizacional:

      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

Salvar pacotes do upstream

Agora que você adicionou a Galeria do PowerShell como uma fonte upstream e registrou seu feed como um PSRepository, toda vez que você instalar um pacote do upstream, uma cópia será salva em seu feed. No exemplo a seguir, instalaremos o módulo PSScriptAnalyzer :

Install-Module -Name PSScriptAnalyzer -Repository PSGalleryUpstream

Observação

Para salvar pacotes de upstreams, você deve ter a função Feed e Upstream Reader (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Exibir pacotes salvos

Você pode acessar os pacotes salvos na Galeria do PowerShell escolhendo a Origem apropriada no menu suspenso.

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.

  3. Selecione Origem à direita e, em seguida, selecione Galeria do PowerShell para filtrar pacotes salvos do upstream. Você pode ver que o pacote PSScriptAnalyzer , que instalamos na etapa anterior, foi salvo em nosso feed.

    Uma captura de tela mostrando pacotes salvos do upstream em um feed de Artefatos do Azure.