Partilhar via


Conectar seu projeto Maven a um feed de Artefatos do Azure

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

Com o Azure Artifacts, você pode publicar e restaurar pacotes Maven diretamente de feeds e registros públicos. O Azure Artifacts suporta upstreaming do Maven Central, Google Maven Repository, Gradle Plugins e JitPack. Este guia irá guiá-lo através do processo de configuração do seu projeto Maven e de ligação ao seu feed de Artefactos do Azure.

Pré-requisitos

Configuração do projeto

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

  2. Selecione Artefatos e, em seguida, selecione seu 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 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.

  5. 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>
      
  6. Gere um Token de Acesso Pessoal com o escopo Packaging>Read & write e cole-o <password> na tag .

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

  2. Selecione Artefatos e, em seguida, selecione seu 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 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.

  5. 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>
      
  6. Gere um Token de Acesso Pessoal com o escopo Packaging>Read & write e cole-o <password> na tag .

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

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

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

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

Nota

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