Restaurar pacotes Maven a partir do feed de Artefatos do Azure

Artigo
11/21/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Com o Azure Artifacts, você pode publicar e restaurar pacotes Maven do feed de Artefatos do Azure e registros públicos. Este artigo irá guiá-lo através da configuração do seu projeto Maven, conectando-se ao seu feed de Artefatos do Azure e restaurando seus pacotes Maven.

Pré-requisitos

Uma organização Azure DevOps. Crie um gratuitamente.
Um projeto de DevOps do Azure. Crie um novo projeto se ainda não tiver um.
Um feed de Artefatos do Azure. Crie um gratuitamente.
Baixe e instale o Apache Maven.

Conectar-se a um feed

Entre em sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.
Selecione Conectar ao feed e, em seguida, selecione Maven na área de navegação esquerda.
Se esta for a primeira vez que utiliza os Artefactos do Azure com o Maven, certifique-se de que instalou os pré-requisitos. Caso contrário, selecione Obter as ferramentas no canto superior direito para instalá-las.

Siga as instruções na seção Configuração do projeto para configurar seus arquivos pom.xml e settings.xml . Os seus ficheiros devem assemelhar-se aos seguintes exemplos:

pom.xml:

  <repositories>
    <repository>
      <id>MavenDemo</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>MavenDemo</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>

settings.xml:

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

Gere um Token de Acesso Pessoal com o escopo Packaging>Read & write e cole-o <password> na tag .

Entre em sua coleção de DevOps do Azure e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.
Selecione Conectar ao feed e, em seguida, selecione Maven no painel de navegação esquerdo.
Se esta for a primeira vez que utiliza os Artefactos do Azure com o Maven, certifique-se de que instalou os pré-requisitos, caso contrário, selecione Obter as ferramentas no canto superior direito para as instalar.

Siga as instruções na seção Configuração do projeto para configurar seus arquivos pom.xml e settings.xml . Os seus ficheiros devem assemelhar-se aos seguintes exemplos:

pom.xml:

  <repositories>
    <repository>
      <id>MavenDemo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <distributionManagement>
    <repository>
      <id>MavenDemo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </distributionManagement>

settings.xml:

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

Gere um Token de Acesso Pessoal com o escopo Packaging>Read & write e cole-o <password> na tag .

Entre em sua coleção de DevOps do Azure e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione seu feed.
Selecione Conectar ao feed e, em seguida, selecione Maven no painel de navegação esquerdo.

Selecione Gerar credenciais Maven e adicione as credenciais ao seu arquivo de settings.xml de usuário dentro da <servers> tag . O ficheiro deverá ter um aspeto semelhante ao seguinte exemplo:

  <servers>
    <server>
      <id>server-2019-defaultcollection-demo</id>
      <username><FEED_NAME></username>
      <password>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</password>
    </server>
  </servers>

Adicione o segundo trecho ao pom.xml do seu projeto dentro das <repositories> tags e <distributionManagement> . O ficheiro deverá ter um aspeto semelhante ao seguinte exemplo:

  <repositories>
    <repository>
      <id>server-2019-defaultcollection-demo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </repositories>
  <distributionManagement>
    <repository>
      <id>server-2019-defaultcollection-demo</id>
      <url>http://<SERVER_NAME>/<COLLECTION_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
      <releases>
        <enabled>true</enabled>
      </releases>
      <snapshots>
        <enabled>true</enabled>
      </snapshots>
    </repository>
  </distributionManagement>

Gorjeta

Se o seu ficheiro settings.xml for partilhado com a sua equipa, pode utilizar o Maven para encriptar as suas palavras-passe.