Introdução aos pacotes Maven no Azure Artifacts

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Os pacotes Maven são binários Java construídos usando a ferramenta de construção Apache Maven. Com os feeds de Artefatos do Azure, você pode armazenar vários tipos de pacote em um único feed. Os pacotes armazenados podem ser restaurados para criar seu projeto ou compartilhados com sua equipe e clientes. Os feeds de Artefatos do Azure também oferecem suporte ao consumo de pacotes de registros públicos, como Maven Central, Google Maven Repository, Gradle Plugins, e JitPack por meio de fontes upstream.

Este artigo irá guiá-lo através da configuração do seu projeto Maven, conectando-o a um feed de Artefatos do Azure e publicando e restaurando seus pacotes Maven.

Pré-requisitos

Criar um feed

Se já tiver um feed, pode saltar para a secção seguinte. 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 seu feed, selecione a Visibilidade para definir quem pode visualizar seus pacotes e escolha o Escopo do feed. Se você quiser incluir pacotes de registros públicos, como o Maven Central ou o Google Maven Repository, 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 autenticar com seu feed, você 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 seu feed:

1. Gere um token de acesso pessoal com o escopo Packaging>Read & write . Copie o seu PAT e guarde-o num local seguro, como necessitará nos próximos passos.

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

3. Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.

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

5. Se esta for a primeira vez que utiliza Artefactos do Azure com Maven nesta máquina, certifique-se de que instalou os pré-requisitos.

6. Abra o arquivo pom.xml e adicione o trecho fornecido na seção Configuração do projeto dentro de ambas as seções <repositories> e <distributionManagement>. O 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 seu settings.xml a nível de utilizador e adicione o seu PAT na <password> tag. Esse arquivo deve ser mantido localmente, portanto, certifique-se de não confirmá-lo em seu 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 seu feed, está pronto para publicar e restaurar pacotes:

1. Se você ainda não compilou seu pacote, abra uma janela de prompt de comando e navegue até o diretório do projeto onde o arquivo pom.xml está localizado e, em seguida, execute o seguinte comando para empacotar seu projeto. Este 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 com êxito seu pacote, ele estará disponível em breve em seu feed de Artefatos do Azure.

   

Restaurar pacotes

Para restaurar pacotes do feed, execute o mvn install comando do diretório do projeto para instalar todas as dependências listadas no pom.xml. Se o pacote que pretende instalar a partir do feed não estiver no seupom.xml, eis como adicioná-lo e restaurá-lo a partir do seu feed:

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

2. Selecione Artefatose, em seguida, selecione o seu feed no menu suspenso.

3. Selecione o pacote que deseja instalar, navegue até Overview>Maven e copie o trecho de dependência. 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 trecho dentro da <dependencies> tag .

5. Execute o seguinte comando a partir do diretório onde o arquivo pom.xml está localizado para restaurar seus pacotes:

   mvn install
   

Conteúdo relacionado

• Publicar artefatos do Maven com o Azure Pipelines (Classic/YAML)

• Use pacotes do Maven Central

• Usar fontes upstream em um feed público