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

• Cree una organización de Azure DevOps y un proyecto si aún no lo ha hecho.

• Descargue e instale Apache Maven.

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.

   

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.

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.

   

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
   

Artículos relacionados

• Publicación de artefactos de Maven con Azure Pipelines
• Usar paquetes de Maven Central
• Uso de orígenes ascendentes en una fuente pública