Compartilhar via

Usar pacotes do Maven Central

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

O uso de fontes upstream do Azure Artifacts permite que você use um único feed para hospedar os pacotes que você produz e pacotes de registros públicos, como o Maven Central. Quando você adiciona fontes upstream ao seu feed, o Azure Artifacts salva uma cópia de qualquer pacote instalado a partir do upstream. Isso garante acessibilidade contínua para o seu desenvolvimento, mesmo que um registro público sofra uma interrupção. Além disso, o Azure Artifacts oferece suporte a várias outras fontes upstream do Maven, incluindo o Google Maven Repository, Gradle Plugins e JitPack.

Pré-requisitos

  • Uma organização do Azure DevOps e um projeto. Crie uma organização ou um projeto , caso ainda não tenha feito isso.

  • Um feed do Azure Artifacts.

Observação

Não há suporte para instantâneos do Maven com fontes de upstream do Maven.

Habilitar fontes upstream

Se você ainda não tiver um feed, siga estas instruções para criar um e marque a caixa de seleção Fontes upstream para habilitá-las. Se você já tiver um feed, vá para a próxima etapa para adicionar o Maven Central como uma fonte upstream.

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Especifique o Escopo do seu feed e, se desejar incluir pacotes de fontes públicas, marque a caixa de seleção Códigos-fonte upstream.

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed nos Serviços de DevOps do Azure.

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

  2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Especifique o Escopo do seu feed e, se desejar incluir pacotes de fontes públicas, marque a caixa de seleção Códigos-fonte upstream.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2022.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2020.

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

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

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Se você deseja incluir pacotes de fontes públicas, selecione a opção Usar pacotes de fontes públicas por meio deste feed .

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2019.

Observação

Por padrão, os feeds recém-criados têm o Serviço de Compilação do projeto definido como Feed e Leitor Upstream (Colaborador).

Adicionar Maven Central upstream

Se você marcou a caixa de seleção de fontes upstream ao criar seu feed, o Maven Central já deve ser adicionado como uma fonte upstream. Caso contrário, você pode adicioná-lo manualmente usando as seguintes etapas:

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

  2. Selecione Artefatos e, em seguida, selecione o no canto superior direito para navegar até as Configurações do ícone de engrenagem ícone de engrenagem 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 selecione Salvar quando terminar.

    Uma captura de tela mostrando como adicionar a fonte central upstream do Maven.

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

    Uma captura de tela mostrando como salvar fontes upstream.

Salvar pacote do Maven Central

Antes de salvar pacotes do Maven Central, verifique se você configurou seu projeto para se conectar ao seu feed. Se você ainda não tiver feito isso, siga as instruções na configuração do projeto para configurar seu projeto Maven e conectar-se ao seu feed.

Neste exemplo, salvaremos a Biblioteca Kotlin Datetime do Maven Central.

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

  2. Procure a Biblioteca Kotlin Datetime. Selecione o pacote Kotlinx Datetime e, em seguida, selecione a versão que deseja instalar.

  3. Copie o <dependency>trecho da guia Maven .

    <dependency>
    <groupId>org.jetbrains.kotlinx</groupId>
    <artifactId>kotlinx-datetime-jvm</artifactId>
    <version>0.4.1</version>
    <scope>runtime</scope>
</dependency>

  4. Abra o arquivo pom.xml e cole o trecho dentro <dependencies> da marca e salve o arquivo.

  5. Execute o seguinte comando a partir do mesmo caminho que o arquivo pom.xml para instalar suas dependências:

    mvn install

Observação

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

Exibir pacotes salvos

Você pode exibir os pacotes salvos do upstream selecionando o código-fonte do Maven Central no menu suspenso.

  1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

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

  3. Selecione Maven Central no menu suspenso de origem para filtrar pacotes desse upstream.

  4. O pacote Kotlinx Datetime , que salvamos na etapa anterior, agora está disponível em nosso feed. Os Artefatos do Azure salvaram automaticamente uma cópia em nosso feed quando executamos o comando mvn install.

Uma captura de tela mostrando um pacote que foi salvo do Maven Central.

Dica

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