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 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.

   

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 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.

   

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

   

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. Para obter mais informações, consulte Permissões.

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.

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

Artigos relacionados

• Pesquisar pacotes em fontes upstream
• Promover pacotes e gerenciar visualizações de feed
• Configurar permissões