Configurar um feed interno como fonte upstream

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

As fontes a montante Azure Artifacts simplificam a gestão de pacotes ao permitir que os programadores armazenem pacotes de múltiplas fontes num único feed. Quando um pacote é instalado pela primeira vez a partir de uma fonte a montante, o Azure Artifacts guarda automaticamente uma cópia no seu feed para garantir o acesso contínuo, mesmo que a fonte a montante se torne temporariamente indisponível. Este tutorial explica como configurar um feed interno da mesma organização como uma fonte upstream no Azure Artifacts.

Pré-requisitos

Criar um feed

Se ainda não tiver um feed, siga estes passos para criar um e adicionar registos públicos comuns como fontes a montante:

1. Inicia sessão no Azure DevOps e vai ao teu projeto.

2. Selecione Artefactos, depois selecione Criar feed.

3. Introduza um Nome para o feed e escolha as definições de Visibilidade e Alcance apropriadas.

4. Selecione Incluir pacotes de fontes públicas comuns para adicionar registos públicos comuns como fontes a montante.

5. Selecione Criar quando terminar.

Conecte-se ao seu feed

Use os passos seguintes para configurar o seu projeto e autenticar com o seu feed. Este exemplo utiliza um projeto Rust. Para outras tecnologias, consulte os links para a configuração do projeto na secção seguinte.

1. Inicia sessão no Azure DevOps e vai ao teu projeto.

2. Seleciona Artefactos, escolhe o teu feed no menu suspenso e depois seleciona Ligar ao feed.

   

3. No painel de navegação esquerdo, selecione Carga.

4. Na secção de configuração do projeto , copia o primeiro excerto e adiciona-o ao ficheiro cargo/config.toml no teu repositório de código-fonte. Seu arquivo config.toml deve ser semelhante ao seguinte:

   [registries]
   FEED_NAME = { index = "sparse+https://pkgs.dev.azure.com/ORGANIZATION_NAME/PROJECT_NAME/_packaging/FEED_NAME/Cargo/index/" }
   

5. Configurar um provedor de credenciais

6. Iniciar sessão no registo

Configuração de projetos para outros tipos de pacotes

Se estiver a usar uma tecnologia diferente, utilize os links abaixo para seguir as orientações apropriadas de configuração do projeto e ligar-se ao seu feed:

Configurar o feed de dados a montante

Siga estes passos para configurar um feed interno da mesma organização que uma fonte upstream:

1. Entre no Azure DevOps e navegue até o seu projeto.

2. Seleciona Artefatos, depois seleciona o feed que criaste anteriormente no menu suspenso do feed.

3. Selecione o botão com o ícone de engrenagem para navegar até as definições do Feed.

4. Selecione Fontes Upstream e, em seguida, selecione Adicionar Upstream.

5. No separador Tipo, selecione o feed Azure Artifacts nesta organização.

6. No separador Configuração , no menu suspenso de Feed, selecione o feed que quer adicionar como fonte ascendente. Selecione a Vista desejada, depois escolha o(s) tipo(s) de pacote a incluir e, opcionalmente, atualize o nome da fonte upstream.

7. Selecione Adicionar quando terminar.

   

8. Selecione Guardar para aplicar as alterações.

   

Instalar pacotes do repositório upstream

O exemplo seguinte ilustra um cenário em que Test_Feed tem o CargoDemoFeed configurado como uma fonte upstream. Para fins de demonstração, Test_Feed está vazio e não contém embalagens.

Quando um colaborador (ou alguém de nível superior) instala um pacote do Test_Feed que está disponível a montante no CargoDemoFeed, o Azure Artifacts copia esse pacote para o Test_Feed a jusante e descarrega-o como parte do fluxo normal de trabalho. Depois desta primeira cópia, todos os downloads futuros desse pacote a partir de Test_Feed requerem apenas permissões de Leitor de Feed (ou superior), porque esses downloads posteriores não modificam o feed a jusante. Apenas a primeira instalação copia o pacote do upstream para o downstream, por isso só essa ação inicial requer permissões elevadas.

1. Inicie sessão no Azure DevOps e depois navegue até ao projeto que hospeda o feed upstream (neste exemplo, CargoDemoFeed).

2. Selecione Artefactos, e no menu suspenso, escolha o feed a montante (CargoDemoFeed).

3. Encontra o pacote que queres instalar e anota o nome. Neste exemplo, atomic-waker é o nome do pacote. Também podes pesquisar pacotes a montante diretamente do teu feed downstream na interface Azure Artifacts. Consulte os pacotes de pesquisa de fontes a montante para mais detalhes.

4. Navegue até à raiz do seu projeto e abra o Cargo.toml. Adicione o pacote em [dependências]. Como esta é uma dependência privada de crate, deve especificar o nome do registo no seu ficheiro Cargo.toml. A carga assume crates.io como registo padrão, salvo indicação em contrário. Adicione a dependência da seguinte forma:

   CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }
   
   # Example:
   # [dependencies]
   # atomic-waker = { version = "1.1.2", registry = "Test_Feed" }
   

5. Abra um prompt de comandos local, navegue até à raiz do seu projeto e execute o seguinte comando para construir o seu projeto e descarregar a caixa:

   cargo build
   

6. Quando a build estiver concluída, volte ao Azure DevOps>Artifacts e selecione o seu feed consumidor (neste exemplo, Test_Feed).

7. Verifica se o pacote que instalaste localmente aparece agora no teu feed a jusante. O Azure Artifacts guarda automaticamente uma cópia do pacote quando é instalado a partir de uma fonte upstream.

   

Conteúdo relacionado

• Proteja-se contra pacotes públicos maliciosos

• Use pacotes a partir do Maven Central

• Gerenciar permissões