Crear y utilizar activos Maven

Si ha habilitado la biblioteca Maven, puede crear y utilizar activos que se pueden utilizar con Maven.

Antes de empezar

Para poder crear y utilizar activos de Maven, un administrador de repositorio debe habilitar la biblioteca de modelos Maven. Para obtener más información, consulte Habilitar la biblioteca Maven.

El cliente mvn se puede integrar con Rational Asset Manager utilizando Rational Asset Manager como repositorio de Maven.

Se necesita realizar pasos de configuración del cliente Maven adicionales si el servidor Rational Asset Manager utiliza el protocolo HTTPS. Si utiliza certificados firmados por una autoridad emisora de certificados, consulte Remote repository access through authenticated HTTPS en la documentación de Maven para obtener más información. Si utiliza certificados autofirmados, debe añadir el certificado del servidor como un certificado de confianza al almacén de claves en el sistema cliente. Los detalles sobre este procedimiento van más allá del ámbito de esta documentación. Una opción consiste en utilizar InstallCert.java, que puede descargar en la web, para añadir el certificado autofirmado al almacén de claves local.

Procedimiento

  1. Cree y someta un activo para cada activo Maven. Añada el atributo Group.Id al activo. Para obtener más información sobre cómo crear y someter activos, consulte Creación y sometimiento de activos. El nombre del activo en Rational Asset Manager corresponde al elemento artifactId de Maven. La versión del activo corresponde al elemento version de Maven.
  2. Si ha creado un archivo pom.xml para el proyecto Maven, añada el archivo pom.xml al activo. Para obtener más información sobre el Modelo de objeto de proyecto (POM), consulte POM Reference en la documentación de Maven.
  3. Ejecute la política Generación de POM sobre el activo. Para aprender más sobre las políticas, consulte Políticas para ciclos de vida en Rational Asset Manager. La política Generación de POM añade metadatos necesarios para Maven al activo.
  4. En el sistema en el que desea ejecuta Maven, abra el archivo settings.xml en el directorio inicio_usuario/.m2.
  5. En el archivo settings.xml, añada los elementos server, profile y activeProfile para el servidor Rational Asset Manager tal como se describe en el ejemplo siguiente.
    <?xml version="1.0" encoding="UTF-8"?>
    <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" 
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
              xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    
    <servers>
        <server>
          <id>rational.repo</id>
          <username>user</username>
          <password>pass</password>
        </server>
      </servers>
    
      <profiles>
        <profile>
          <id>assetmanager</id>
    	  <repositories>
            <repository>
              <id>rational.repo</id>
    		  		  <url>http://server.example.com:9080/ram.ws/maven2/Sample%20Open%20Source/Maven%20Artifact/</url>
            </repository>
    	  </repositories>
        </profile>
      </profiles>
    
      <activeProfiles>
        <activeProfile>assetmanager</activeProfile>
      </activeProfiles>
    
    </settings>
    id
    Hay dos tipos distintos de elementos id que debe configurar. Los elementos id pueden ser cualesquiera identificadores exclusivos. Tal como se muestra en el archivo de ejemplo, el id del elemento server debe coincidir con id del parámetro repository. El id del elemento profile debe coincidir con el elemento activeProfile.
    username
    El nombre de usuario que se debe utilizar para la autenticación con el servidor Rational Asset Manager.
    password
    La contraseña que se va a utilizar para la autenticación con el servidor Rational Asset Manager.
    url
    Especifique el repositorio de Rational Asset Manager escribiendo un URL con el formato siguiente: http://nombre_host:número_puerto/raíz_de_contexto_de_servicios_web/maven2/nombre_comunidad/tipo_activo. El archivo de ejemplo muestra un URL típico para un servidor Rational Asset Manager que se esté ejecutando en el puerto 9080 en server.example.com, para activos de tipo Maven Artifact en la comunidad Sample Open Source
    activeProfile
    El elemento activeProfile debe coincidir con el id del elemento profile.
    Para obtener información general sobre la edición del archivo settings.xml en Maven, consulte Settings Reference en la documentación de Maven.

Resultados

Cuando se ejecuta Maven (el cliente mvn), accede a los archivos almacenados en Rational Asset Manager.
Nota: Sólo se da soporte a Maven 2.

Comentarios