Compartilhar via


Usar pacotes do Maven Central

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020

O uso de fontes upstream do Azure Artifacts permite que você use um único feed para hospedar seus próprios pacotes e pacotes de repositórios públicos, como o Maven Central. Quando as fontes upstream estão habilitadas, o Azure Artifacts salva automaticamente uma cópia de qualquer pacote instalado de uma fonte upstream. Isso garante que seu processo de desenvolvimento possa continuar perfeitamente mesmo se um registro público sofrer uma interrupção.

Observação

Não há suporte para snapshots do Maven em fontes upstream do Maven.

Pré-requisitos

Produto Requisitos
Azure DevOps - Uma organização do Azure DevOps.
- Um projeto do Azure DevOps .
- Baixe e instale o Apache Maven.

Criar um feed

Se você já tiver um feed do Azure Artifacts, vá para a próxima seção. Caso contrário, siga estas etapas para criar uma:

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

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

  3. Forneça um nome para o feed, defina a Visibilidade para controlar quem pode acessar seus pacotes e escolha o escopo do feed. Certifique-se de verificar Incluir pacotes de fontes públicas comuns para habilitar fontes upstream e permitir o consumo de pacotes de repositórios públicos.

  4. Selecione Criar para concluir a criação do feed.

Adicionar upstream do Maven Central

Se você tiver selecionado a caixa de seleção de fontes upstream ao configurar o feed, o Maven Central já deverá ser adicionado como uma fonte upstream. Caso contrário, você poderá adicioná-lo manualmente seguindo estas etapas:

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

  2. Selecione Artefatos e selecione o botão ícone de engrenagem no canto superior direito para navegar até as Configurações do Feed.

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

  4. Selecione fonte pública, selecione Maven Central (https://repo.maven.apache.org/maven2/) no menu suspenso e, em seguida, selecione Adicionar quando terminar.

  5. Selecione Salvar no canto superior direito para salvar suas alterações.

    Uma captura de tela mostrando como salvar fontes upstream.

Conectar-se ao seu feed

Antes de começar a salvar pacotes de fontes upstream, primeiro você deve configurar seu projeto e conectar-se ao feed.

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

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

  3. Selecione Conectar ao Feed e selecione Maven no painel esquerdo.

  4. Verifique se você instalou os pré-requisitos e siga as etapas na seção de instalação do Project para configurar seus arquivospom.xml e settings.xml e conectar-se ao feed. Consulte a configuração do Project – Maven para obter mais detalhes.

Usar pacotes do Maven Central

O exemplo a seguir ilustra como consumir o pacote Apache HttpClient do Maven Central usando a linha de comando.

Observação

Para salvar pacotes de upstreams, você deve ter a função Feed e Leitor upstream (Colaborador) ou superior. Consulte as funções e permissões do Feed para obter mais detalhes.

  1. Navegue até o Maven Central https://mvnrepository.com/.

  2. Pesquise por Apache HttpClient. Selecione o pacote e, em seguida, selecione a versão que você deseja instalar.

  3. Na guia Maven, copie o <dependency> trecho de código.

    <dependency>
      <groupId>org.apache.httpcomponents.client5</groupId>
      <artifactId>httpclient5</artifactId>
      <version>5.5.1</version>
    </dependency>
    
  4. Abra o arquivo pom.xml e cole o snippet dentro da <dependencies> marca e salve o arquivo.

  5. Execute o seguinte comando no mesmo diretório que o arquivopom.xml para instalar suas dependências:

    mvn install
    

Exibir pacotes salvos

Agora que você instalou um pacote do Maven Central, você pode ver como o Azure Artifacts salvou automaticamente uma cópia desse pacote no feed. Você pode filtrar sua exibição de feed para ver pacotes salvos de diferentes fontes upstream.

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

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

  3. Na lista suspensa de origem, selecione Maven Central para filtrar pacotes desse upstream.

  4. O pacote Apache HttpClient* salvo na etapa anterior agora está disponível no feed.

    Uma captura de tela exibindo o pacote Apache HttpClient que foi salvo do Maven Central.

Dica

Se o Maven não estiver baixando todas as suas dependências, execute o seguinte comando no diretório do projeto para regenerar os arquivos do projeto: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true