Realizar una actualización por lotes desde un sistema de archivos en un repositorio

Se pueden crear activos o actualizar activos que existen en su sistema de archivos en un repositorio Rational Asset Manager. Se pueden definir metadatos de activos en su sistema de archivos utilizando archivos y directorios que siguen reglas específicas como origen de activos. El cliente de Rational Asset Manager Eclipse tiene la posibilidad de realizar una actualización o importación de activos por lotes de acuerdo al origen de activos.

Acerca de esta tarea

Para subir activos directamente desde su sistema de archivos a un repositorio:
  1. Busque los directorios en su sistema de archivos local desde los que quiera crear activos.
  2. Cree reglas que definan la forma en que los directorios y sus archivos se correlacionarán con un activo. Por ejemplo, debe definir qué archivos son artefactos y qué valor asignar como comunidad y versión de activo. Puede definir estas reglas de dos formas:
    • Especificar una serie de reglas
    • Crear un archivo manifest.rmd que contenga definiciones.
      Nota: Si crea un archivo manifest.rmd, debe colocarlo en el directorio raíz de un activo o archivo de activos antes de añadir el directorio como el origen de activo.
      Estructura de directorio de archivos.
  3. Corrija todos los problemas que haya con los activos nuevos, seleccione el repositorio de destino y actualice los activos en el repositorio.

Procedimiento

Para realizar una actualización por lotes a través de un cliente de Eclipse desde un sistema de archivos:

  1. Expanda el menú en la vista Búsqueda de activos y seleccione Actualización por lotes.
    Menú Actualización por lotes
  2. En la sección Buscar activos del Editor por lotes, elimine el repositorio que no necesita del espacio de repositorios de origen.
    Suprimir repositorio en la sección Buscar activos
  3. Especifique el repositorio de destino al que desea importar activos o crear una conexión de repositorio.
    Seleccionar la conexión de repositorio para estas actualizaciones
  4. Pulse con el botón derecho del ratón en el espacio de repositorios de origen y pulse Añadir origen de activos > Sistema de archivos.
    Añadir origen de activos > Sistema de archivos
  5. Pulse con el botón de la derecha en la carpeta raíz Origen de activos en el selector de carpetas y pulse Añadir regla....
    Atención: Debería colocar todas las carpetas raíz de activos bajo la carpeta raíz. Aquí hay un ejemplo:
    Cuatro carpetas raíz de activos bajo una carpeta raíz

    Los metadatos de los activos (como, por ejemplo, Manifest.rmd) se incluyen en sus respectivas carpetas raíz de activos.

  6. Seleccione Activo como tipo de regla y pulse Siguiente.
  7. Seleccione Crear activos con todos los archivadores y carpetas para recuperar todas las carpetas raíz de activos bajo la carpeta raíz, o seleccione Crear activos con archivadores y carpetas coincidentes con este filtro y especifique un filtro para personalizar las carpetas raíz de activos. A continuación, pulse Finalizar.
  8. Una vez se completada la validación, vaya por la lista en el espacio de destino y resuelva los problemas de validación de los activos.
  9. Pulse Actualizar todos los activos para completar la actualización por lotes.

Ejemplo

En este ejemplo se describe cómo realizar una actualización por lotes. En este ejemplo hay cuatro carpetas raíz de activos para importar activos. Estas carpetas se muestra más abajo:

Cuatro carpetas: bin asset, doc asset, source code asset y source code2 asset bajo la carpeta Asset source
Source code asset y source code2 asset son para activos que contienen código fuente como artefacto. Bin asset contiene los archivos jar binarios. La documentación se almacena en doc asset.

El propósito es importar estos metadatos de activos desde el sistema de archivos en el repositorio Rational Asset Manager y configurar comunidades y tipos de activos, de acuerdo a la utilización de los activos.

Configurar el manifiesto y el artefacto de los cuatro activos

En este ejemplo, desea establecer la comunidad de bin asset en DevOps Community y doc asset en Documentation. Antes de iniciar la actualización por lotes, debe configurar el manifiesto y el artefacto de los cuatro activos tal como se indica a continuación:
  • Manifiesto y estructura del directorio de bin asset:
    Directory of C:\Asset source\bin asset
    
    09/29/2014  01:24 PM    <DIR>          .
    09/29/2014  01:24 PM    <DIR>          ..
    03/20/2012  11:54 AM           350,627 log4j-1.2.11.jar
    09/29/2014  01:30 PM               475 manifest.rmd

    Archivo de manifiesto (cargará el archivo .jar como artefacto):

    <?xml version="1.0" encoding="UTF-8"?>
    <defaultprofile:Asset xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:defaultprofile="http:///defaultprofile.ecore" 
       name="log4j bin" version="1.2.11" shortDescription="log4j jar file">
     <classification>
      <descriptorGroup name="AssetType">
       <nodeDescriptor href="executable jar" />
      </descriptorGroup>
     </classification>
    <solution>
      <artifact name="log4j-1.2.11.jar">
       <reference><value>log4j-1.2.11.jar</value></reference>
      </artifact>
     </solution>
     </description><value>Longer description</value></description>
    </defaultprofile:Asset>
  • Manifiesto y estructura del directorio de doc asset:
    Directory of C:\Asset source\doc asset
    09/29/2014  01:24 PM    <DIR>          .
    09/29/2014  01:24 PM    <DIR>          ..
    09/29/2014  01:30 PM               560 manifest.rmd

    Archivo manifest que contiene un artefacto de URL a la documentación en línea:

    <?xml version="1.0" encoding="UTF-8"?>
    <defaultprofile:Asset xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:defaultprofile="http:///defaultprofile.ecore" 
       name="doc asset" version="1.0" shortDescription="short description">  
      <classification>
       <descriptorGroup name="AssetType">
        <nodeDescriptor href="documentation"/>
      </descriptorGroup>
     </classification>
    <solution>
     <artifact name="API reference" type="url">
         <reference value="http://logging.apache.org/log4j/1.2/apidocs/index.html">
            <referenceKind name="url"/>
         </reference>
       </artifact>
     </solution>
     <description><value>Longer description</value></description>
    </defaultprofile:Asset>
  • Manifiesto y estructura del directorio de source asset:
    Directory of C:\Asset source\source code asset
    
    09/29/2014  01:30 PM    <DIR>          .
    09/29/2014  01:30 PM    <DIR>          ..
    09/29/2014  11:17 AM    <DIR>          folder
    09/29/2014  01:38 PM               536 manifest.rmd
    
    Directory of C:\Asset source\source code asset\folder
    
    09/29/2014  11:17 AM    <DIR>          .
    09/29/2014  11:17 AM    <DIR>          ..
    09/29/2014  11:16 AM            27,008 log4j-1.2.11.zip

    Archivo manifest que contiene el código fuente comprimido en un archivo .zip (el código fuente está ubicado en una carpeta):

    <?xml version="1.0" encoding="UTF-8"?>
    <defaultprofile:Asset xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:defaultprofile="http:///defaultprofile.ecore" 
        name="log4j-src" version="1.2.11" shortDescription="short description">
       <classification>
        <descriptorGroup name="AssetType">
          <nodeDescriptor href="source code" />
        </descriptorGroup>
       </classification>
       <solution>
         <artifact name="folder" type="folder">
          <artifact name="log4j-1.2.11.zip" type="application/zip"/>
        <reference value="log4j-1.2.11.zip"/>
       </artifact>
      </artifact>
     </solution>
     <description><value>Longer description</value></description>
    </defaultprofile:Asset>
  • Manifiesto y estructura del directorio de source code2 asset:
    Directory of C:\Asset source\source code2 asset
    
    09/29/2014  01:32 PM    <DIR>          .
    09/29/2014  01:32 PM    <DIR>          ..
    09/29/2014  11:16 AM            27,008 log4j-1.2.11.zip
    09/29/2014  11:17 AM               911 manifest.rmd

    Archivo manifest que contiene el código fuente comprimido en un archivo .zip:

    <?xml version="1.0" encoding="UTF-8"?>
    <defaultprofile:Asset xmi:version="2.0" xmlns:xmi="http://www.omg.org/XMI" xmlns:defaultprofile="http:///defaultprofile.ecore" 
         name="log4j-src" version="1.2.11" shortDescription="short description">
      <classification>
        <descriptorGroup name="AssetType">
          <nodeDescriptor href="source code" />
        </descriptorGroup>
      </classification>
      <solution>
        <artifact name="log4j-12.11.zip" type="text/plain">
          <reference><value>log4j-12.11.zip</value></reference>
        </artifact>
      </solution>
    </defaultprofile:Asset>
Se tienen que especificar los metadatos para el artefacto de cada activo y ubicar dichos artefactos en el mismo directorio con el archivo manifest.rmd. Observe que en el archivo manifest, deben haber los metadatos para el tipo de activo. A continuación se muestra un ejemplo:
<classification>
  <descriptorGroup name="AssetType">
   <!-- specify the asset type url, or set a value here and map it to a existing asset type url in batch update later -->
    <nodeDescriptor href="source code" />
    </descriptorGroup>
  </classification>

Establecer comunidades de activos en el editor por lotes

Puesto que no ha establecido comunidades para los activos, se puede utilizar una regla de activos en el editor por lotes para ayudar a establecer comunidades de activo de acuerdo al nombre de activo. Siga los siguientes pasos:
  1. En el editor por lotes, importe la carpeta raíz que contiene las cuatro carpetas raíz de activos y especifique el repositorio de destino.
  2. Para añadir un regla de activo para source code asset, seleccione Crear activos con archivadores y carpetas coincidentes con este filtro y escriba source code* en el campo Filtro. A continuación, pulse Finalizar. De esta forma se creará una regla de activo para los activos de código fuente, y el cliente Eclipse escogerá dos carpetas cuyos nombres coincidan con source code* bajo la carpeta de origen de activos raíz.
  3. Para crear un regla de comunidad para los activos de origen, pulse el botón derecho del ratón sobre la regla de activo y pulse Añadir regla.... En la ventana emergente, pulse Comunidad > Siguiente.
  4. Especifique una comunidad existente en el repositorio de destino y pulse Finalizar.
    Escriba Sample Open Source en el campo Comunidad

    Se añade una nueva regla de comunidad bajo la regla Asset para los activos de origen, y la comunidad del activo de origen se estable como Sample Open Source.

    Community está bajo Asset y Sample Open Source está bajo Communities(1)
  5. Aparece un mensaje de aviso de validación puesto que no hay un tipo de activo denominado source code.
    Aviso bajo Asset Types: file:/C:/Asset%20source/source%20code%20asset/source code y un aviso bajo Assets (2): Se necesita un tipo de activo
    Hay dos formas de resolver este problema:
    • Crear una regla de tipo de activo que sea como una regla para la comunidad. Especifique un tipo de activo existente para sobrescribir el tipo de activo de los dos activos de origen.
    • Correlacione el tipo de activo que falta de cada activo con un tipo existente en el repositorio, o cree el tipo de activo en el repositorio.
      • Para correlacionar tipos de activo:
        1. Pulse en el botón de la derecha el tipo de activo en el espacio del repositorio de destino y pulse Correlacionar tipos de activos....
          Correlacionar tipos de activos
        2. Especifique un tipo de activo en la ventana emergente y pulse Aceptar.
      • Para crear tipos de activos, pulse con el botón derecho en el tipo de activo en el espacio del repositorio de destino y pulse Crear tipos de activos.
  6. Para continuar añadiendo una regla de activo para los otros dos activos de origen, utilice la regla de comunidad para añadirlos a diferentes comunidades. Corrija el aviso de validación y asegúrese de que no hay otro mensaje de aviso de validación para los activos.
    Corregir el aviso de validación
  7. Pulse el botón Actualizar todos los activos para completar la actualización por lotes.
    Actualización por lotes completada y los cuatro activos que se muestran
Para obtener más información sobre cómo realizar una actualización por lotes desde un sistema de archivos a un repositorio, consulte los temas siguientes:

Comentarios