Introdução aos pacotes Maven e aos Artefatos do Azure

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

Este guia de início rápido irá guiá-lo através da configuração do seu projeto Maven para se conectar aos feeds do Azure Artifacts e publicar e baixar seus pacotes Maven.

Pré-requisitos

Configurar a autenticação

  1. Selecione Artefatos e, em seguida, selecione Conectar ao feed.

    Uma captura de tela mostrando como se conectar a um feed.

  1. Selecione Maven.

  2. Se esta for a primeira vez que usar o Azure Artifacts com o Maven, selecione Obter as ferramentas para baixar e instalar o Maven.

  3. Siga as instruções na configuração do Project para configurar seus arquivos pom.xml e settings.xml. Se o seu ficheiro settings.xml for partilhado com a sua equipa, pode utilizar o Maven para encriptar as suas palavras-passe.

    Uma captura de tela mostrando como configurar seu projeto.

Gorjeta

Se você estiver usando a tarefa Maven, defina o mavenAuthenticateFeed argumento como true para autenticar automaticamente com seu feed Maven.

Publicar artefatos

  1. Se você ainda não tiver um pacote Maven, poderá criar um executando o seguinte comando:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="myFirstApp"
    

    Se você receber o seguinte erro: Você deve especificar uma fase válida do ciclo de vida ou uma meta (..), siga as etapas abaixo para adicionar uma meta à sua configuração:

    Clique com o botão direito do mouse em seu projeto, selecione Executar como>Maven Build. Insira o pacote na caixa de texto Metas e selecione Executar.

  2. Navegue até o caminho do arquivo pom.xml e execute os seguintes comandos para criar e implantar seu artefato Maven:

    mvn build
    mvn deploy
    

Se você receber o seguinte erro: Fase de ciclo de vida desconhecida "build"(...) quando você executa mvn buildo , você pode usar o Eclipse IDE para construir seu projeto maven da seguinte maneira:

  1. Clique com o botão direito do rato no seu projeto.

  2. Selecione Executar como e, em seguida, selecione Maven Build....

  3. Escreva o pacote na caixa de texto Metas .

  4. Selecione Executar.

    Uma captura de tela mostrando como criar um projeto usando o Eclipse.

Se quiser publicar um artefato de terceiros, você pode usar o mojo deploy:deploy-file . Isso pode ser usado com ou sem um arquivo POM para implantar seus pacotes.

mvn deploy:deploy-file -Dpackaging="jar" -DrepositoryId="MyFeedName" -Durl="MyFeedURL" -DgroupId="MyGroup" -DartifactId="myFirstApp" -Dversion="jarFileVersion" -Dfile="jarFileLocalPath"

Nota

Se a sua organização estiver a utilizar uma firewall ou um servidor proxy, certifique-se de que permite URLs de Domínio de Artefactos do Azure e endereços IP.

Instalar artefatos

  1. Navegue até Artefatos do Azure e selecione o pacote que deseja instalar e copie o <dependency> trecho.

  2. Abra o arquivo pom.xml e cole o código dentro da <dependencies> tag .

  3. Execute mvn install a partir do mesmo caminho que o arquivo pom.xml.