Tutorial: como usar fontes upstream

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

O uso de fontes upstream em seu feed permite que você gerencie suas dependências de aplicativo a partir de um único feed. O uso de fontes upstream facilita o consumo de pacotes de registros públicos e, ao mesmo tempo, tem proteção contra interrupções ou pacotes comprometidos. Você também pode publicar seus próprios pacotes no mesmo feed e gerenciar todas as suas dependências em um único local.

Este tutorial orientará você sobre como habilitar fontes upstream em seu feed e consumir pacotes de registros públicos, como NuGet.org ou npmjs.com.

Neste tutorial, você irá:

• Crie um novo feed e habilite fontes upstream.
• Configure o arquivo de configuração.
• Execute uma restauração de pacote inicial para preencher seu feed.
• Verifique seu feed para exibir a cópia salva dos pacotes que você consumiu do registro público.

Criar um feed e habilitar fontes upstream

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

2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

   

3. Forneça um nome para seu feed e escolha sua visibilidade. Marque a caixa de seleção Incluir pacotes de fontes públicas comuns para habilitar fontes upstream e selecione Criar quando terminar.

   

Configurar o arquivo de configuração

Agora que criamos nosso feed, precisamos atualizar o arquivo de configuração para apontar para nosso feed. Para isso, devemos:

1. Obter o URL da fonte
2. Atualizar o arquivo de configuração

npm

1. Selecione Artefatos e, em seguida, selecione Conectar ao feed.

   

2. No lado esquerdo da página, selecione a guia npm .

3. Siga as instruções na seção Configuração do projeto para configurar o arquivo de configuração.

   

Se você ainda não tiver um arquivo .npmrc, crie um novo na raiz do projeto (na mesma pasta do package.json). Abra o novo arquivo .npmrc e cole o trecho que você acabou de copiar na etapa anterior.

NuGet

1. Selecione Artefatos e, em seguida, selecione o feed.

2. Selecione Conectar ao feed e escolha NuGet.exe.

   

3. Copie o snippet XML na seção Configuração do Projeto .

4. Crie um novo arquivo chamado nuget.config na raiz do seu projeto.

5. Cole o trecho XML no arquivo de configuração.

Pip

1. Selecione Artefatos e, em seguida, selecione seu feed na lista suspensa.

2. Selecione Conectar ao feed e, em seguida, selecione pip na seção Python.

   

3. Crie um ambiente virtual, caso ainda não o tenha feito.

4. Adicione um arquivo pip.ini (Windows) ou pip.conf (Mac/Linux) ao seu virtualenv e cole o seguinte trecho:

   [global]
   index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
   

Maven

1. Selecione Artefatos e, em seguida, selecione seu feed na lista suspensa.

2. Selecione Conectar ao feed e, em seguida, selecione Maven.

   

3. Adicione o seguinte snippet às <repositories> seções e <distributionManagement> em seu pom.xml:

   <repository>
     <id>[FEED-NAME]</id>
     <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
     <releases>
       <enabled>true</enabled>
     </releases>
     <snapshots>
       <enabled>true</enabled>
     </snapshots>
   </repository>
   

4. Adicione um <server> ao seu arquivo settings.xml:

   <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                                 https://maven.apache.org/xsd/settings-1.0.0.xsd">
     <servers>
       <server>
         <id>[FEED-NAME]</id>
         <username>[ORGANIZATION-NAME]</username>
         <password>[PERSONAL_ACCESS_TOKEN]</password>
       </server>
     </servers>
   </settings>
   

5. Crie um token de acesso pessoal com escopos de gravação Packaging>Read & e cole seu token de acesso pessoal na <password> tag no arquivo settings.xml.

Gradle

1. Selecione Artefatos e, em seguida, selecione seu feed na lista suspensa.

2. Selecione Conectar ao feed e, em seguida, selecione Gradle.

   

3. Adicione o seguinte trecho aos repositórios e seções de publicação em seu arquivo build.gradle:

   maven {
       url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
       name '[FEED-NAME]'
       authentication {
           basic(BasicAuthentication)
       }
   }
   

4. Adicione um <server> ao seu arquivo settings.xml:

   <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                                 https://maven.apache.org/xsd/settings-1.0.0.xsd">
     <servers>
       <server>
         <id>[FEED-NAME]</id>
         <username>[ORGANIZATION-NAME]</username>
         <password>[PERSONAL_ACCESS_TOKEN]</password>
       </server>
     </servers>
   </settings>
   

5. Crie um token de acesso pessoal com escopos de leitura e gravação de empacotamento>. Cole seu token de acesso pessoal na <password> tag no arquivo settings.xml.

Restaurar pacotes

Agora que você habilitou os códigos-fonte upstream e configurou seu arquivo de configuração, podemos executar o comando package restore para consultar a origem upstream e recuperar os pacotes upstream.

npm

Remova a pasta node_modules do seu projeto e execute o seguinte comando em uma janela de prompt de comando elevada:

npm install --force

Observação

O --force argumento forçará os controles remotos de pull mesmo se existir uma cópia local.

Seu feed agora deve ter uma cópia salva de todos os pacotes que você instalou a partir do upstream.

NuGet

1. Limpe o cache local:

   nuget locals -clear all
   

2. Restaure seus pacotes NuGet:

   nuget.exe restore
   

Seu feed agora deve ter uma cópia salva de todos os pacotes que você instalou a partir do upstream.

Pip

Execute este comando no diretório do projeto:

pip install

Seu feed agora deve ter uma cópia salva de todos os pacotes que você instalou a partir do upstream.

Maven

Execute este comando no diretório do projeto:

mvn install

Seu feed agora deve ter uma cópia salva de todos os pacotes que você instalou a partir do upstream.

Gradle

Execute este comando no diretório do projeto:

gradle build

Seu feed agora deve ter uma cópia salva de todos os pacotes que você instalou a partir do upstream.

Artigos relacionados

• Configurar fontes upstream
• Fontes upstream de Pacotes Universais
• Permissões do feed
• Publicar pacotes no NuGet.org