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
- NuGet.exe
- Provedor de credenciais do Azure Artifacts
- Uma organização do Azure DevOps e um projeto. Crie uma organização ou um projeto , caso ainda não tenha feito isso.
- Um feed do Azure Artifacts. Crie um feed se você ainda não tiver um.
Adicionar fonte upstream da Galeria do PowerShell
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:
Entre na sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.
Selecione o botão do ícone de engrenagem para navegar até as configurações do feed.
Selecione Fontes upstream e, em seguida, selecione Adicionar Upstream.
Selecione Fonte pública e, em seguida, selecione Galeria do PowerShell no menu suspenso. Selecione Adicionar, quando terminar.
Selecione Salvar no canto superior direito para salvar suas alterações. Selecione Salvar novamente se solicitado a confirmar suas escolhas.
Conectar-se ao feed
Crie um token de acesso pessoal com permissões de leitura e gravação de empacotamento>.
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)
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.
Entre na sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.
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.