Introdução aos pacotes do Maven no Azure Artifacts

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

Os pacotes maven são binários Java criados usando a ferramenta de build do Apache Maven. Com os feeds do Azure Artifacts, você pode armazenar vários tipos de pacote em um único feed. Os pacotes armazenados podem então ser restaurados para criar seu projeto ou compartilhados com sua equipe e clientes. Os feeds do Azure Artifacts também dão suporte ao consumo de pacotes de registros públicos, como Maven Central, repositório do Google Maven, plugins Gradle e JitPack por meio de fontes upstream.

Este artigo orientará você na configuração do projeto Maven, conectando-o a um feed do Azure Artifacts e publicando e restaurando seus pacotes do Maven.

Pré-requisitos

Criar um feed

Se você já tiver um feed, poderá pular para a próxima seção. Caso contrário, crie um novo feed da seguinte maneira:

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

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

3. Forneça um nome para o feed, selecione a Visibilidade para definir quem pode exibir seus pacotes e escolha o Escopo do feed. Se você quiser incluir pacotes de repositórios públicos, como o Maven Central ou o Repositório do Google Maven, marque incluir pacotes de fontes públicas comuns.

4. Selecione Criar quando terminar.

Conectar-se a um feed

Agora que você tem um feed, precisa configurar seu arquivo de configuração para se autenticar com o feed, também precisará criar um token de acesso pessoal para autenticar com o Azure DevOps. Siga as etapas abaixo para autenticar e conectar-se ao feed:

1. Gere um token de acesso pessoal com empacotamento> e escopo de leitura e gravação. Copie seu PAT e salve-o em um local seguro, como você precisará nas próximas etapas.

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

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

4. Selecione Conectar ao feed e selecione Maven no painel de navegação esquerdo.

5. Se esta for a primeira vez que você usa o Azure Artifacts com o Maven neste computador, verifique se você instalou os pré-requisitos.

6. Abra o arquivo pom.xml e adicione o trecho fornecido na seção de configuração do projeto dentro de ambas as seções <repositories> e <distributionManagement>. Seu pom.xml deve ser semelhante ao seguinte:

       <repositories>
           <repository>
               <id>FEED_NAME</id>
               <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
               <releases>
               <enabled>true</enabled>
               </releases>
               <snapshots>
               <enabled>true</enabled>
               </snapshots>
           </repository>
       </repositories>
       <distributionManagement>
           <repository>
               <id>FEED_NAME</id>
               <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
               <releases>
               <enabled>true</enabled>
               </releases>
               <snapshots>
               <enabled>true</enabled>
               </snapshots>
           </repository>
       </distributionManagement>
   

7. Abra o settings.xml no nível do usuário e adicione o PAT na etiqueta <password>. Esse arquivo deve ser mantido localmente, portanto, certifique-se de não confirmar isso no código-fonte para não expor suas credenciais. Seu arquivo settings.xml deve ser semelhante ao seguinte:

       <servers>
           <server>
               <id>MavenDemo</id>
               <username><ORGANIZATION_NAME></username>
               <password>[PERSONAL_ACCESS_TOKEN]</password>
           </server>
       </servers>
   

Publicar pacotes

Agora que você se autenticou com o feed, está pronto para publicar e restaurar pacotes:

1. Se você ainda não tiver criado seu pacote, abra uma janela de prompt de comando e navegue até o diretório do projeto em que o arquivo pom.xml está localizado e execute o comando a seguir para empacotar seu projeto. Esse comando compila seu código, executa testes incluídos e empacota seu projeto em um formato distribuível (como um arquivo JAR).

   mvn package
   

2. Execute o seguinte comando no diretório do projeto para publicar o pacote no feed:

   mvn deploy
   

3. Depois de publicar o pacote com êxito, ele estará disponível em breve no feed do Azure Artifacts.

   

Restaurar pacotes

Para restaurar pacotes do feed, execute o mvn install comando do diretório do projeto para instalar todas as dependecies listadas em seu pom.xml. Se o pacote que você deseja instalar do feed não estiver em seu pom.xml, veja como adicioná-lo e restaurá-lo do 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 o pacote que você deseja instalar, navegue até>Visão Geral do Maven e copie o trecho de dependência. Ele deve ser semelhante a este:

   <dependency>
     <groupId>MyGroup</groupId>
     <artifactId>MavenQuickStartDemo</artifactId>
     <version>1.0-SNAPSHOT</version>
   </dependency>
   

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

5. Execute o seguinte comando no diretório em que seu arquivo pom.xml esteja localizado para restaurar seus pacotes:

   mvn install
   

Conteúdo relacionado

• Publicar artefatos do Maven com o Azure Pipelines (Clássico/YAML)

• Usar pacotes do Maven Central

• Usar fontes upstream em um feed público