Compartir vía


Introducción a los paquetes de Maven en Azure Artifacts

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

Azure Artifacts permite a los desarrolladores administrar sus dependencias desde una sola fuente, al tiempo que proporcionan control sobre el uso compartido de paquetes. Con las fuentes de Azure Artifacts, puede publicar y restaurar paquetes de Maven y configurar orígenes ascendentes para consumir paquetes de registros públicos como Maven Central, Google Maven Repository, Complementos de Gradle y JitPack. Este artículo le guiará a través de la configuración del proyecto de Maven, la conexión a una fuente de Azure Artifacts y la publicación y restauración de los paquetes de Maven.

Requisitos previos

Crear feed

  1. Inicie sesión en su organización de Azure DevOps y vaya al proyecto.

  2. Seleccione Artefactos y, a continuación, Crear feed.

  3. En Nombre, escriba un nombre descriptivo para la fuente.

    En Visibilidad, seleccione una opción para indicar quién puede ver los paquetes dentro de la fuente.

    Si desea incluir paquetes de orígenes públicos, active la casilla en Orígenes ascendentes.

    En Ámbito, especifique si el ámbito de la fuente es el proyecto o la organización.

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps Services.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

  2. Seleccione Artefactos y, a continuación, Crear feed.

  3. En Nombre, escriba un nombre descriptivo para la fuente.

    En Visibilidad, seleccione una opción para indicar quién puede ver los paquetes dentro de la fuente.

    Si desea incluir paquetes de orígenes públicos, active la casilla en Orígenes ascendentes.

    En Ámbito, especifique si el ámbito de la fuente es el proyecto o la organización.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2022.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2020.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione Nueva fuente.

  3. En Nombre, escriba un nombre descriptivo para la fuente.

    En Visibilidad, seleccione una opción para indicar quién puede ver los paquetes dentro de la fuente.

    Si desea incluir paquetes de orígenes públicos, seleccione la opción Usar paquetes de orígenes públicos a través de esta fuente .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2019.

Nota:

De forma predeterminada, las fuentes recién creadas tienen el valor del servicio de compilación del proyecto establecido en Fuente y Lector ascendente (Colaborador).

Conexión a una fuente

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione la fuente en el menú desplegable.

  3. Seleccione Conectar a la fuente y, a continuación, seleccione Maven en el área de navegación izquierda.

  4. Si es la primera vez que usa Azure Artifacts con Maven, asegúrese de que ha instalado los requisitos previos. De lo contrario, seleccione Obtener las herramientas en la esquina superior derecha para instalarlas.

  5. Siga las instrucciones de la sección Configuración del proyecto para configurar los archivos pom.xml y settings.xml . Los archivos deben ser similares a los ejemplos siguientes:

    • 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. Genere un token de acceso personal con el ámbito de lectura y escritura de empaquetado>y péguelo en la <password> etiqueta.

  1. Inicie sesión en su colección de Azure DevOps y vaya a su proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione la fuente en el menú desplegable.

  3. Seleccione Conectar a fuente y, a continuación, seleccione Maven en el panel de navegación izquierdo.

  4. Si esta es la primera vez que usa Azure Artifacts con Maven, asegúrese de que ha instalado los requisitos previos; de lo contrario, seleccione Obtener las herramientas en la esquina superior derecha para instalarlas.

  5. Siga las instrucciones de la sección Configuración del proyecto para configurar los archivos pom.xml y settings.xml . Los archivos deben ser similares a los ejemplos siguientes:

    • 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. Genere un token de acceso personal con el ámbito de lectura y escritura de empaquetado>y péguelo en la <password> etiqueta.

  1. Inicie sesión en su colección de Azure DevOps y vaya a su proyecto.

  2. Seleccione Artefactos y, a continuación, seleccione la fuente.

  3. Seleccione Conectar a fuente y, a continuación, seleccione Maven en el panel de navegación izquierdo.

  4. Seleccione Generar credenciales de Maven y agregue las credenciales al archivo settings.xml de usuario dentro de la <servers> etiqueta. El archivo debe tener un aspecto similar al de el siguiente ejemplo:

      <servers>
        <server>
          <id>server-2019-defaultcollection-demo</id>
          <username><FEED_NAME></username>
          <password>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</password>
        </server>
      </servers>
    
  5. Agregue el segundo fragmento de código a la pom.xml del proyecto dentro de las <repositories> etiquetas y <distributionManagement> . El archivo debe tener un aspecto similar al de el siguiente ejemplo:

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

Publicar paquetes

  1. Abra una ventana del símbolo del sistema y vaya al directorio del proyecto donde se encuentra el archivo pom.xml y, a continuación, ejecute el siguiente comando para empaquetar el proyecto. Este comando compila el código, ejecuta pruebas incluidas y empaqueta el proyecto en un formato distribuible (como un archivo JAR).

    mvn package
    
  2. Ejecute el siguiente comando desde el directorio del proyecto para publicar el paquete en la fuente:

    mvn deploy
    
  3. Después de implementar correctamente el paquete, estará disponible en breve en la fuente.

    Captura de pantalla que muestra un paquete de Maven implementado en una fuente.

Nota:

Si su organización usa un firewall o un servidor proxy, asegúrese de permitir direcciones IP y direcciones URL de dominio de Azure Artifacts.

Restaurar paquetes

  1. Vaya a Artefactos en el proyecto de Azure DevOps, seleccione la fuente en el menú desplegable y, a continuación, seleccione el paquete que desea instalar.

  2. Vaya a Información general>de Maven y copie el fragmento de código de dependencia.

  3. Abra el archivo pom.xml y pegue el fragmento de código dentro de la <dependencies> etiqueta .

  4. Ejecute el siguiente comando desde el directorio donde se encuentra el archivo pom.xml para restaurar los paquetes:

    mvn install