Introducción a las fuentes y las fuentes de Maven Artifacts

  • Artículo
  • Tiempo de lectura: 4 minutos

Azure DevOps Services | TFS 2018

Esta guía de inicio rápido le guiará a través de la configuración de Maven para publicar y consumir Artifacts de la fuente.

En esta guía se da por supuesto que ya ha configurado Azure Artifacts. Consulte Empezar a usar Azure Artifacts para obtener información sobre cómo obtener licencias de la extensión.

Nota

Azure Artifacts es una extensión que viene preinstalada en TFS 2017 o posterior (Maven solo está disponible en 2018 o posterior), si se quitó de su organización, puede instalarla desde Visual Studio Marketplace.

Requisitos previos

  1. Apache Maven instalado. Puede descargarlo desde el proyecto de Apache Maven.

  2. Tener Azure Artifacts instalado en su organización.

Creación de una fuente

¿Ya tiene una fuente?Vaya al paso siguiente.

  1. Desde dentro del proyecto, vaya a Azure Artifacts.

    Vaya a Azure Artifacts

  2. Seleccione Crear fuente.

    Botón Nueva fuente

  3. Asigne un nombre a la fuente y elija su visibilidad, orígenes ascendentesy configuración de ámbito.

    Cuadro de diálogo Nueva fuente

  4. Seleccione Crear cuando haya terminado.

Azure Artifacts está instalado de forma predeterminada para los clientes de TFS 2017. Debe actualizar a TFS 2017 para poder usar Azure Artifacts. Si es la primera vez que usa la fuente, es posible que se le pida que asigne una licencia.

  1. Vaya a Build Release (Versión de compilación) y seleccione Packages (Paquetes).

    Vaya a Azure Artifacts TFS

  2. Seleccione + Nueva fuente.

    Nuevo botón de fuente TFS

  3. Asigne a la fuente un nombre, una descripcióny configure quién puede leer ,quién puede contribuir y si desea incluir paquetes externos.

    Cuadro de diálogo Nueva fuente TFS

  4. Seleccione Crear cuando haya terminado.

Configuración de la autenticación

Para hablar con Azure Artifacts fuente, necesitará un token en el equipo local que Maven pueda recoger y pasar a Azure DevOps Services.

  1. En la página Azure Artifacts, seleccione Conectar a Fuente.

    Conectar botón de fuente en la esquina superior derecha de la página

  1. En la página Paquetes,seleccione Conectar a Fuente.

    Conectar botón de fuente en la esquina superior derecha de la página

  1. Abra la pestaña Maven en el encabezado de Maven.

    • Maven extrae las credenciales del settings.xml archivo.

    • En Linux, la ruta de acceso del archivo suele ser "${user.home}/.m2/settings.xml" .

    • En macOS, la ruta de acceso del archivo suele ser "~/.m2/settings.xml" .

    • En Windows, la ruta de acceso del archivo suele ser "%USERPROFILE%/.m2/settings.xml" .

    • Si el archivo no existe, cree uno ahora.

    Sugerencia

    Para asegurarse de crear y guardar el nuevo archivo XML en el formato correcto, establezca Explorador de archivos para mostrar las extensiones de nombre de archivo:

    1. En Explorador de archivos, seleccione la pestaña Ver.
    2. En Mostrar u ocultar, active la casilla Extensiones de nombre de archivo para ver las extensiones de archivos en Explorador de archivos.

  2. Si no ha instalado Maven en la máquina, puede seleccionar Obtener las herramientas para descargarla e instalarla.

  3. Siga la sección Project configuración, incluida la generación de un token de acceso personal.

    Configuración de la autenticación de Maven

Puede encontrar más información sobre el archivo settings.xml en la settings.xml referencia .

Publicación de un artefacto

Para publicar un artefacto de Maven en la fuente, siga estos pasos:

  1. Si no tiene un paquete de Maven, puede crear uno ejecutando el siguiente comando:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="myFirstApp"

    Si recibe el siguiente error Debe especificar una fase de ciclo de vida válida o un objetivo (..) después de ejecutar el comando anterior, siga estos pasos para agregar un objetivo en la configuración de ejecución:

    Haga clic con el botón derecho en el proyecto, seleccione Ejecutar como y, a continuación, Compilación de Maven. Escriba package en el cuadro de texto Goals (Objetivos) y seleccione Run (Ejecutar).

  2. Configure el cliente de Maven con la fuente.

  3. Vaya al directorio del archivo pom.xml archivo. De forma predeterminada, pom.xml archivo está en la ruta de acceso raíz del proyecto.

  4. Ejecute los siguientes comandos para compilar e implementar el artefacto de Maven:

    • Compile el paquete:
    • Implemente el paquete:

Si desea publicar un artefacto de terceros, puede usar el mojo deploy:deploy-file. Se puede usar con o sin un archivo POM implementar los paquetes.

mvn deploy:deploy-file -Dpackaging="jar" -DrepositoryId="MyFeedName" -Durl="MyFeedURL" -DgroupId="MyGroup" -DartifactId="myFirstApp" -Dversion="jarFileVersion" -Dfile="jarFileLocalPath"

Nota

Puede almacenar hasta 30 instantáneas de Maven en la fuente. Una vez que alcance el límite máximo, Azure Artifacts automáticamente eliminará las instantáneas hasta 25. Este proceso se desencadenará automáticamente cada vez que se publiquen más de 30 instantáneas en la fuente. Consulte Control de instantáneas de Maven para obtener más detalles.

Nota

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

[IMPORTANTE] Para autenticarse automáticamente con la fuente de Maven, debe establecer el mavenAuthenticateFeed argumento en true en la tarea mavenAuthenticateFeed.

Instalación de un artefacto desde la fuente

Instale artefactos de Maven desde la fuente mediante el cliente de Maven.

La manera más común de instalar un artefacto de Maven es como dependencia de otro artefacto.

  1. Cree un artefacto de Maven mediante el comando siguiente:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="mySecondApp"

  2. En Azure Artifacts, vaya al artefacto que desea instalar y copie el contenido del elemento.

  3. Pegue el <dependency> contenido del elemento dentro del elemento del pom.xml <dependencies> archivo.

  4. Ejecute mvn install desde el directorio que contiene el pom.xml archivo.

Consulte los documentos de la CLI de Maven para obtener más opciones de instalación.

  1. Cree un artefacto de Maven mediante el comando siguiente:

    mvn -B archetype:generate -DarchetypeGroupId="org.apache.maven.archetypes" -DgroupId="MyGroup" -DartifactId="mySecondApp"

  2. En el Conectar cuadro de diálogo de la fuente en TFS, copie la información. Péguelo en el pom.xml archivo de ejemplo dos veces (consulte el archivo de ejemplo anterior):

    • Entre las <repositories> etiquetas
    • Entre las <distributionManagement> etiquetas

  3. En la página Paquetes, vaya al artefacto que desea instalar y copie el contenido del elemento.

  4. Pegue el <dependency> contenido del elemento dentro del elemento del pom.xml <dependencies> archivo.

  5. Ejecute mvn install desde el directorio que contiene el pom.xml archivo.

Consulte los documentos de la CLI de Maven para obtener más opciones de instalación.

Pasos adicionales

Consulte la página de Azure Artifacts de destino para obtener información sobre otros temas.