Usar paquetes de Maven Central

  • Artículo

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

El uso de orígenes ascendentes de Azure Artifacts permite usar una sola fuente para hospedar los paquetes que genera y los paquetes de registros públicos, como Maven Central. Al agregar orígenes ascendentes a la fuente, Azure Artifacts guarda una copia de cualquier paquete instalado desde la cadena ascendente. Esto garantiza la accesibilidad continua para el desarrollo, incluso si un registro público sufre una interrupción. Además, Azure Artifacts admite otros orígenes ascendentes de Maven, como el repositorio de Google Maven, los complementos de Gradle y JitPack.

Requisitos previos

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

  • Una fuente de Azure Artifacts.

Nota:

Las instantáneas de Maven no se admiten con orígenes ascendentes de Maven.

Habilitación de orígenes ascendentes

Si aún no tiene una fuente, siga estas instrucciones para crear una y asegúrese de activar la casilla orígenes ascendentes para habilitarlas. Si ya tiene una fuente, vaya al paso siguiente para agregar Maven Central como origen ascendente.

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

  2. Seleccione Artefactos y, a continuación, seleccione Crear fuente para crear una nueva fuente.

  3. Escriba un nombre descriptivo para la fuente y defina su visibilidad (que indica quién puede ver los paquetes dentro de la fuente). Especifique el ámbito de la fuente y, si desea incluir paquetes de orígenes públicos, marque la casilla Orígenes ascendentes .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una fuente de necesidad.

Nota:

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

Adición de Maven Central ascendente

Si activa la casilla orígenes ascendentes al crear la fuente, Maven Central ya debería agregarse como origen ascendente. Si no es así, puede agregarlo manualmente mediante los pasos siguientes:

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

  2. Seleccione Artefactos y, a continuación, seleccione en engranaje la esquina superior derecha para ir a la Configuración de fuente.

  3. Seleccione Orígenes ascendentes y, a continuación, seleccione Agregar ascendente.

  4. Seleccione Origen público, Maven Central (https://repo.maven.apache.org/maven2/) en el menú desplegable y, a continuación, seleccione Guardar cuando haya terminado.

    Captura de pantalla que muestra cómo agregar el origen ascendente central de Maven.

  5. Seleccione Guardar en la esquina superior derecha para guardar los cambios.

    Captura de pantalla que muestra cómo guardar orígenes ascendentes.

Guardar paquete desde Maven Central

Antes de guardar paquetes desde Maven Central, asegúrese de que ha configurado el proyecto para conectarse a la fuente. Si aún no lo ha hecho, siga las instrucciones de la configuración del proyecto para configurar el proyecto de Maven y conectarse a la fuente.

En este ejemplo, guardaremos la biblioteca De fecha y hora de Kotlin desde Maven Central.

  1. Vaya a Maven Central en https://mvnrepository.com/.

  2. Busque la biblioteca De fecha y hora de Kotlin. Seleccione el paquete Kotlinx Datetime y, a continuación, seleccione la versión que desea instalar.

  3. Copie el <dependency> fragmento de código de la pestaña Maven .

    <dependency>
    <groupId>org.jetbrains.kotlinx</groupId>
    <artifactId>kotlinx-datetime-jvm</artifactId>
    <version>0.4.1</version>
    <scope>runtime</scope>
</dependency>

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

  5. Ejecute el siguiente comando desde la misma ruta de acceso que el archivo de pom.xml para instalar las dependencias:

    mvn install

Nota:

Para guardar paquetes de nivel superior, debe tener el rol Lector de fuente y ascendente (colaborador) o superior. Para más información, consulte Permisos.

Visualización de paquetes guardados

Puede ver los paquetes que guardó en los canales ascendentes seleccionando el origen de Maven Central en el menú desplegable.

  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 Maven Central en el menú desplegable de origen para filtrar los paquetes de esta cadena ascendente.

  4. El paquete Datetime de Kotlinx que guardamos en el paso anterior ahora está disponible en nuestra fuente. Azure Artifacts guardó automáticamente una copia en nuestra fuente cuando ejecutamos el comando mvn install.

Captura de pantalla que muestra un paquete que se guardó desde Maven Central.

Sugerencia

Si Maven no descarga todas las dependencias, ejecute el siguiente comando desde el directorio del proyecto para volver a generar los archivos del proyecto: mvn eclipse:eclipse -DdownloadSources=true -DdownloadJavadocs=true