Compartilhar via


Fonte upstream da Galeria do PowerShell

A ativação de fontes upstream para seu feed estende o acesso dos 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 fonte 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 Adicionar, quando 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 de empacotamento>.

  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 comando a seguir 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 no escopo da organização:

      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 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 Leitor Upstream (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 os 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 do Azure Artifacts.