Compartilhar via


Usar pacotes do Maven Central

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 produzidos e os pacotes de registros públicos, como o Maven Central. Quando você adiciona fontes upstream ao feed, o Azure Artifacts salva uma cópia de qualquer pacote instalado do upstream. Isso garante acessibilidade contínua para seu desenvolvimento, mesmo que um registro público sofra uma interrupção. Além disso, o Azure Artifacts dá suporte a várias outras fontes upstream do Maven, incluindo o Repositório Maven do Google, os Plug-ins do Gradle e o 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 certifique-se de marcar a caixa de seleção de fontes upstream para ativá-los. 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 vá para o projeto.

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

  3. Em Nome, insira um nome descritivo para seu feed.

    Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.

    Se você quiser incluir pacotes de fontes públicas, marque a caixa de seleção em Fontes upstream.

    Em Escopo, especifique se o escopo do feed é o projeto ou a organização.

  4. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed em Azure DevOps Services.

  1. Entre no servidor Azure DevOps e vá para o projeto.

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

  3. Em Nome, insira um nome descritivo para seu feed.

    Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.

    Se você quiser incluir pacotes de fontes públicas, marque a caixa de seleção em Fontes upstream.

    Em Escopo, especifique se o escopo do feed é o projeto ou a organização.

  1. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed no Azure DevOps 2022.

  1. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed no Azure DevOps 2020.

  1. Entre no servidor Azure DevOps e vá para o projeto.

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

  3. Em Nome, insira um nome descritivo para seu feed.

    Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.

    Se você quiser 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.

    Captura de tela que mostra as seleções para criar um novo feed no Azure DevOps 2019.

Observação

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

Adicionar o Maven Central upstream

Se você marcou a caixa de seleção de fontes upstream ao criar seu feed, o Maven Central já deve ter sido 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 ícone de engrenagem í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.

    Uma captura de tela mostrando como adicionar a fonte upstream central 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, certifique-se de ter configurado 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 de data e hora do Kotlin do Maven Central.

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

  2. Pesquise a biblioteca de data e hora do Kotlin. Selecione o pacote Kotlinx Datetime e, em seguida, selecione a versão que deseja instalar.

  3. Copie o <dependency> snippet 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 , cole o snippet dentro <dependencies> da tag e salve o arquivo.

  5. Execute o seguinte comando no mesmo caminho do 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 Leitor Upstream (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Exibir pacotes salvos

Você pode visualizar os pacotes salvos de upstreams selecionando a fonte 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. O Azure Artifacts salvou 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 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