Tutorial: como usar fontes upstream

Artigo
09/27/2024

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 aplicativos a partir de um único feed. O uso de fontes upstream facilita o consumo de pacotes de registros públicos, ao mesmo tempo em que oferece 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 as fontes upstream.
Configure seu 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 consumidos do registro público.

Criar um feed e ativar fontes upstream

Entre na sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione Criar Feed para criar um novo feed.
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.

Observação

Para adicionar um feed de uma organização diferente como uma fonte upstream, o proprietário do feed de destino deve compartilhar o modo de exibição de destino com Todos os feeds e pessoas em organizações associadas ao meu locatário do Microsoft Entra navegando até Modos de exibição> de configurações>de feed Selecione o botão de reticências à direita para o modo de exibição >especificado Editar.

Configurar o arquivo de configuração

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

Obter o URL da fonte
Atualizar o arquivo de configuração

Selecione Artefatos e, em seguida, selecione Conectar ao feed.
No lado esquerdo da página, selecione a guia npm .
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 snippet que você acabou de copiar na etapa anterior.

Selecione Artefatos e, em seguida, selecione seu feed na lista suspensa.
Selecione Conectar ao feed e, em seguida, selecione pip na seção Python.
Crie um ambiente virtual, caso ainda não tenha feito isso.
Adicione um arquivo pip.ini (Windows) ou pip.conf (Mac/Linux) ao seu virtualenv e cole o seguinte snippet:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Selecione Artefatos e, em seguida, selecione seu feed na lista suspensa.
Selecione Conectar ao feed e, em seguida, selecione Maven.

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>

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>

Crie um token de acesso pessoal com os escopos de leitura e gravação de empacotamento>e cole seu token de acesso pessoal na marca do <password> arquivo settings.xml.

Selecione Artefatos e, em seguida, selecione seu feed na lista suspensa.
Selecione Conectar ao feed e, em seguida, selecione Gradle.

Adicione o seguinte snippet aos repositórios e às seções de publicação no arquivo build.gradle:

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

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>

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

Restaurar pacotes

Agora que você habilitou as 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.

Remova a pasta node_modules do projeto e execute o seguinte comando em uma janela de prompt de comando com privilégios elevados:

npm install --force