Partilhar via


Origem upstream da Galeria do PowerShell

Habilitar fontes upstream para seu feed amplia o acesso de seus desenvolvedores a pacotes de registros públicos. Neste artigo, você aprenderá como 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 em sua organização do Azure DevOps e navegue até seu projeto.

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

  3. Selecione o botão ícone de engrenagem do ícone de engrenagem para navegar até as Configurações de 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 as alterações. Selecione Salvar novamente se solicitado para confirmar suas escolhas.

Ligar ao feed

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

  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 com escopo do projeto:

      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 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 do upstream, uma cópia será salva no seu feed. No exemplo a seguir, instalaremos o módulo PSScriptAnalyzer :

Install-Module -Name PSScriptAnalyzer -Repository PSGalleryUpstream

Nota

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.

Ver pacotes guardados

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

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

  2. Selecione Artefatos e, em seguida, selecione seu 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.