Tutorial: Como utilizar origens a montante

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

O uso de fontes upstream em seu feed permite que você gerencie as dependências do 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 irá orientá-lo sobre como habilitar fontes upstream em seu feed e consumir pacotes de registros públicos, como NuGet.org ou npmjs.com.

Neste tutorial, vai:

• Crie um novo feed e habilite fontes upstream.
• Configure o arquivo de configuração.
• Execute uma restauração inicial do pacote 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 em 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 tal, é necessário:

1. Obter o URL da fonte
2. Atualizar o ficheiro 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 seu arquivo de configuração.

   

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

NuGet

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

2. Selecione Conectar ao feed e, em seguida, escolha NuGet.exe.

   

3. Copie o trecho 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 trecho às <repositories> seções e <distributionManagement> no 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 ficheiro 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 Packaging>Read & escreva escopos e cole seu token de acesso pessoal na <password> tag em seu 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 ficheiro 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 Packaging>Read & write scopes. Cole seu token de acesso pessoal na tag em <password> seu arquivo settings.xml.

Restaurar pacotes

Agora que você habilitou fontes upstream e configurou seu arquivo de configuração, podemos executar o comando package restore para consultar a fonte 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

Nota

O --force argumento forçará os controles remotos de pull mesmo que exista 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 de feed
• Publicar pacotes para NuGet.org