Compartilhar via


Conectar seu projeto Maven a um feed do Azure Artifacts

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

Com o Azure Artifacts, você pode publicar e restaurar pacotes Maven de feeds e registros públicos. O Azure Artifacts dá suporte ao upstreaming do Maven Central, do Google Maven Repository, dos Plug-ins do Gradle e do JitPack. Este guia orientará você pelo processo de configuração do projeto Maven e conexão com o feed do Azure Artifacts.

Pré-requisitos

Configuração do projeto

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

  2. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.

  3. Selecione Conectar ao feed e, em seguida, selecione Maven na área de navegação à esquerda.

  4. 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.

  5. 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>
      
  6. Gere um Token de Acesso Pessoal com o escopo de Leitura e gravação de Empacotamento>e cole-o na <password> marca.

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

  2. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.

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

  4. 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.

  5. 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>
      
  6. Gere um Token de Acesso Pessoal com o escopo de Leitura e gravação de Empacotamento>e cole-o na <password> marca.

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

  2. Selecione Artefatos e, em seguida, selecione o feed.

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

  4. 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>
    
  5. 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>
    

Observação

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