Групповое обновление хранилища из файловой системы

Можно создать ресурсы или обновить существующие в файловой системе ресурсы в хранилище Rational Asset Manager. Метаданные ресурсов можно указать в файловой системе с помощью файлов и каталогов, соответствующих правилам источника ресурсов. Клиент Eclipse Rational Asset Manager может выполнять пакетный импорт или обновления ресурсов с учетом источника ресурсов.

Об этой задаче

Для загрузки ресурсов непосредственно из файловой системы в хранилище:
  1. Найдите каталоги локальной файловой системы, из которых требуется создать ресурсы.
  2. Создайте правила, определяющие, каким образом каталоги и их файлы будут связаны с ресурсом. Необходимо, например, определить, какие файлы являются артефактами, и какие значения следует присваивать в качестве версии сообщества и ресурса. Эти правила можно определить двумя способами:
    • Указать ряд правил
    • Создать файл manifest.rmd, содержащий определения.
      Прим.: При создании файла manifest.rmd его следует поместить в корневой каталог ресурса или архив ресурса перед добавлением этого каталога в качестве источника ресурса.
      Структура каталога файлов.
  3. Устраните все неполадки, связанные с новыми ресурсами, выберите целевое хранилище и обновите эти ресурсы в хранилище.

Процедура

Для выполнения группового обновления с помощью клиента Eclipse из файловой системы выполните следующие действия:

  1. Откройте меню в представлении Поиск ресурсов и выберите Пакетное обновление.
    Меню Групповое обновление
  2. В разделе Найти ресурсы Редактора пакетных задач удалите ненужное хранилище из области исходного хранилища.
    Удаление хранилище в разделе Поиск ресурсов
  3. Укажите целевое хранилище для импорта ресурса или создайте соединение с хранилищем.
    Выберите соединение с хранилищем для обновлений
  4. Щелкните правой кнопкой мыши на исходной области хранилища и выберите Добавить источник ресурсов > Файловая система.
    Добавить источник ресурсов > Файловая система
  5. Щелкните правой кнопкой мыши на корневой папке Источник ресурсов и окне выборе папок и нажмите кнопку Добавить правило....
    Внимание: Все корневые папки ресурсов следует разместить в корневой папке. Пример:
    Четыре корневых папки ресурсов в корневой папке

    Метаданные ресурсов (такие как файл Manifest.rmd) расположены в корневых папках ресурсов.

  6. Выберите Ресурс в качестве правила и нажмите кнопку Далее.
  7. Выберите Создать ресурсы с помощью всех архивов и папок для извлечения всех корневых папок ресурсов из корневой папки или выберите Создать ресурсы с помощью архивов и папок, соответствующих этому фильтру и укажите фильтр для настройки корневых папок ресурсов. Затем нажмите кнопку Готово.
  8. После завершения проверки ресурсов просмотрите список целевой области и устраните неполадки проверки ресурсов.
  9. Выберите Обновить все ресурсы, чтобы завершить групповое обновление.

Пример

В этом примере рассмотрено выполнение группового обновления. В этом примере ресурсы импортируются из четырех корневых папок ресурсов. Эти папки показаны ниже:

Четыре папки: bin asset, doc asset, source code asset и source code2 asset в папке Asset source
Source code asset и source code2 asset предназначены для ресурсов, которые в качестве артефакта содержат исходный код. Bin asset содержит двоичные файлы jar. Документация хранится в папке doc asset.

Необходимо импортировать метаданные ресурсов из файловой системы в хранилище Rational Asset Manager, а также указать сообщества и типы ресурсов с учетом использования артефактов.

Настройка манифеста и артефакта четырех ресурсов

В этом примере для ресурса bin asset требуется указать сообщество DevOps, а для ресурса doc asset - Documentation. Перед запуском пакетного обновления настройте манифест и артефакт четырех ресурсов:
  • Структура папок и манифест для 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

    Файл манифеста (в качестве артефакта передается файл .jar):

    <?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>
  • Структура папок и манифест для 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

    Файл манифеста, содержащий артефакт URL, указывающий на документацию в сети:

    <?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>
  • Структура папок и манифест ресурса source code:
    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

    Файл манифеста, содержащий исходный код в виде файла .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="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>
  • Структура папок и манифест ресурса source code2:
    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

    Файл манифеста, содержащий исходный код в виде файла .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>
Для каждого ресурса необходимо указать метаданные артефактов и разместить расположены в одном каталоге вместе с файлом manifest.rmd. Обратите внимание, что в файле манифеста должны быть указаны метаданные для типа ресурсов. Пример:
<classification>
  <descriptorGroup name="AssetType">
   <!-- укажите url типа ресурсов или добавьте значение и свяжите его с существующим url типа ресурсов в групповом обновлении -->
    <nodeDescriptor href="source code" />
    </descriptorGroup>
  </classification>

Указание сообществ ресурсов в редакторе пакетных задач

Поскольку сообщества указаны не для всех ресурсов, то с помощью правила ресурсов в редакторе пакетных задач можно задать сообщества ресурсов с учетом имен ресурсов. Выполните следующие действия.
  1. В редакторе пакетных задач импортируйте корневую папку, содержащую все четыре корневых папки ресурсов и укажите целевое хранилище.
  2. Для добавления правила ресурсов для ресурса исходного кода выберите Создать ресурсы с помощью архивов и папок, соответствующих этому фильтру и введите source code* в поле Фильтр. Затем нажмите кнопку Готово. Создано правило ресурсов для двух ресурсов исходного кода и клиент Eclipse загрузит две папки из корневой исходной папки ресурсов, имена которых соответствуют шаблону source code*.
  3. Для создания правила сообщества для исходных ресурсов щелкните правой кнопкой мыши на правиле ресурсов и выберите Добавить правило.... Во всплывающем окне выберите Сообщество > Далее.
  4. Укажите существующее сообщество в целевом хранилище и нажмите кнопку Готово.
    Введите Sample Open Source в поле Сообщество

    Новое правило сообщества добавляется в правило ресурсов для исходных ресурсов и для исходного ресурса задается сообщество Sample Open Source.

    Сообщество расположено в элементе Ресурс, а Sample Open Source - в элементе Сообщества(1)
  5. Выдается предупреждение о том, что тип ресурсов source code не существует.
    Предупреждение для типов ресурсов: file:/C:/Asset%20source/source%20code%20asset/source код и предупреждение для ресурсов (2): требуется тип ресурсов
    Неполадку можно устранить двумя способами:
    • Создайте правило типов ресурсов, аналогичное правилу для сообщества. Укажите существующий тип ресурсов для замены типа ресурсов двух исходных ресурсов.
    • Свяжите отсутствующий тип ресурсов с существующим типом в хранилище или создайте тип ресурсов в хранилище.
      • Для того чтобы связать типы ресурсов, выполните следующие действия:
        1. Щелкните правой кнопкой мыши на целевой области хранилища и выберите Связать типы ресурсов....
          Связывание типов ресурсов
        2. Укажите тип ресурса во всплывающем окне и нажмите кнопку Ok.
      • Для создания типов ресурсов щелкните правой кнопкой мыши на области целевого хранилища и выберите Создать типы ресурсов.
  6. Для того чтобы продолжить добавление правила ресурсов для двух других исходных ресурсов, добавьте их в другие сообщества с помощью правила сообществ. Исправьте выдаваемое для них предупреждение проверки и убедитесь, что отсутствует предупреждение проверки для ресурсов.
    Исправьте предупреждение проверки
  7. Нажмите кнопку Обновить все ресурсы и завершите групповое обновление.
    Групповое обновление завершено и показаны четыре ресурса
Дополнительная информация о выполнении пакетной задачи обновления из файловой системы в хранилище приведена в следующих разделах:

Отправить комментарий