Tutorial: Como utilizar origens a montante

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 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

Entre em 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.

Nota

Para adicionar um feed de uma organização diferente como uma fonte upstream, o proprietário do feed de destino deve compartilhar a exibição de destino com Todos os feeds e pessoas em organizações associadas ao meu locatário do Microsoft Entra navegando até Configurações de>Feed Visualizações 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 tal, é necessário:

Obter o URL da fonte
Atualizar o ficheiro 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 trecho 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 o tenha feito.
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/
```

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

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>

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>

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.

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

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)
    }
}

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>

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.

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

npm install --force