Compartilhar via

Configurar um feed interno como uma fonte upstream

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

As fontes upstream do Azure Artifacts simplificam o gerenciamento de pacotes, permitindo que os desenvolvedores armazenem pacotes de várias fontes em um único feed. Quando um pacote é instalado pela primeira vez de uma fonte upstream, o Azure Artifacts salva automaticamente uma cópia no feed para garantir o acesso contínuo, mesmo que a fonte upstream fique temporariamente indisponível. Este tutorial orienta você sobre como configurar um feed interno da organização como uma fonte upstream no Azure Artifacts.

Pré-requisitos

Produto Requisitos
Azure DevOps - Uma organização do Azure DevOps.
- Um projeto do Azure DevOps .

Criar um feed

Se você ainda não tiver um feed, siga estas etapas para criar um e adicionar registros públicos comuns como fontes upstream:

  1. Entre no Azure DevOps e acesse seu projeto.

  2. Selecione Artefatos e, em seguida, selecione Criar feed.

  3. Insira um nome para o feed e escolha as configurações apropriadas de Visibilidade e Escopo .

  4. Selecione Incluir pacotes de fontes públicas comuns para adicionar registros públicos comuns como fontes upstream.

  5. Selecione Criar quando terminar.

Conectar-se ao seu feed

Use as etapas a seguir para configurar seu projeto e autenticar com o feed. Este exemplo usa um projeto rust. Para outras tecnologias, consulte os links de instalação do projeto na seção a seguir.

  1. Entre no Azure DevOps e acesse seu projeto.

  2. Selecione Artefatos, selecione seu feed no menu suspenso e, em seguida, selecione Conectar ao feed.

    Uma captura de tela exibindo como selecionar um feed na lista suspensa no Azure Artifacts.

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

  4. Na seção Configuração do Project , copie o primeiro snippet e adicione-o ao arquivo cargo/config.toml no repositório de origem. O 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. Fazer logon no Registro

Configuração do projeto para outros tipos de pacote

Se você estiver usando uma tecnologia diferente, use os links abaixo para seguir as diretrizes apropriadas de configuração do projeto para se conectar ao feed:

Configurar o feed upstream

Para configurar um feed interno da mesma organização como fonte upstream, siga estas etapas:

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

  2. Selecione Artefatos e, em seguida, no menu suspenso do feed, selecione o feed criado anteriormente.

  3. Selecione o ícone de engrenagem para acessar as configurações do Feed.

  4. Selecione fontes upstream e, em seguida, selecione Adicionar Upstream.

  5. Na guia Tipo , selecione o feed do Azure Artifacts nesta organização.

  6. Na guia Configuração, no menu suspenso Feed, selecione o feed que você deseja adicionar como uma fonte ascendente. Selecione a Exibição desejada, escolha os Tipos de Pacotes a serem incluídos e, opcionalmente, atualize o nome de origem Upstream.

  7. Selecione Adicionar, quando terminar.

    Uma captura de tela mostrando como adicionar um novo feed interno como uma fonte upstream no Azure Artifacts.

  8. Selecione Salvar para aplicar suas alterações.

    Uma captura de tela mostrando como salvar fontes upstream no Azure Artifacts.

Instalar pacotes do upstream

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

Quando um colaborador (ou superior) instala um pacote de Test_Feed que está disponível no CargoDemoFeed upstream, o Azure Artifacts copia esse pacote no Test_Feed downstream e o baixa como parte do fluxo normal cargo install . Após essa cópia pela primeira vez, todos os downloads futuros desse pacote de Test_Feedexigem apenas permissões de Leitor de Feed (ou superior), pois esses downloads posteriores não modificam o feed downstream. Somente a primeira instalação copia o pacote de upstream para downstream, de modo que apenas essa ação inicial requer permissões elevadas.

  1. Entre no Azure DevOps e navegue até o projeto que hospeda o feed upstream (neste exemplo, CargoDemoFeed).

  2. Selecione Artefatos, e, no menu drop-down, selecione o feed upstream (CargoDemoFeed).

  3. Localize o pacote que você deseja instalar e anote seu nome. Neste exemplo, atomic-waker é o nome do pacote. Você também pode pesquisar pacotes upstream diretamente no feed downstream pela interface de usuário do Azure Artifacts. Consulte pacotes de pesquisa de fontes upstream para obter mais detalhes.

  4. Navegue até a raiz do projeto e abra Cargo.toml. Adicione o pacote em [dependências]. Como essa é uma dependência de crate privado, você deve especificar o nome do registro em seu arquivo Cargo.toml . Cargo pressupõe crates.io como o registro padrão, a menos que especificado de outra forma. Adicione a dependência da seguinte maneira:

    CRATE_NAME = { version = "VERSION_NUMBER", registry = "FEED_NAME" }

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

  5. Abra um prompt de comando local, navegue até a raiz do projeto e execute o seguinte comando para criar seu projeto e baixar o crate:

    cargo build

  6. Depois que o build for concluído, retorne ao Azure DevOps Artifacts> e selecione o feed de consumo (neste exemplo, Test_Feed).

  7. Verifique se o pacote instalado localmente agora aparece no feed downstream. O Azure Artifacts salva automaticamente uma cópia do pacote quando ele é instalado de uma fonte upstream.

    Uma captura de tela mostrando um pacote salvo de um upstream interno no Azure Artifacts.

Conteúdo relacionado

  • Last updated on