Restaurar pacotes Maven do feed do Azure Artifacts

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 do Azure Artifacts e de registros públicos. Este artigo orientará você na configuração do projeto Maven, na conexão com o feed do Azure Artifacts e na restauração dos pacotes Maven.

Pré-requisitos

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

Conectar-se a um feed

Entre na sua organização do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione o 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 você usa o Azure Artifacts com o Maven, verifique se você 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. Seus arquivos devem ser semelhantes 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 de Leitura e gravação de Empacotamento>e cole-o na <password> marca.

Entre na sua coleção do Azure DevOps e navegue até seu projeto.
Selecione Artefatos e, em seguida, selecione o 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 você usa o Azure Artifacts com o Maven, verifique se você 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. Seus arquivos devem ser semelhantes 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 de Leitura e gravação de Empacotamento>e cole-o na <password> marca.

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

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

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

Adicione o segundo snippet ao pom.xml do seu projeto dentro das <repositories> tags e <distributionManagement> . O arquivo deverá ser 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>

Dica

Se o arquivo settings.xml for compartilhado com sua equipe, você poderá usar o Maven para criptografar suas senhas.