Executando uma Atualização em Lote de um Sistema de Arquivos para um Repositório

É possível criar ativos ou atualizar ativos que existem em seu sistema de arquivos para um repositório do Rational Asset Manager. É possível definir os metadados de ativo em seu sistema de arquivos usando arquivos e diretórios que sigam regras específicas como uma origem de ativo. O cliente Eclipse do Rational Asset Manager pode executar a importação de ativo em lote ou atualizar de acordo com a origem de ativo.

Sobre Esta Tarefa

Para fazer upload de recursos diretamente de seu sistema de arquivos para um repositório:
  1. Localize os diretórios em seu sistema de arquivos local do qual você deseja criar recursos.
  2. Crie regras que definem como os diretórios e seus arquivos serão mapeados para um recurso. Por exemplo, você deve definir quais arquivos que são artefatos e qual valor designar como a versão do recurso e da comunidade. Você pode definir essas regras de duas formas:
    • Especifique uma série de regras
    • Crie um arquivo manifest.rmd que contém definições.
      Nota: Se criar um arquivo manifest.rmd, você deverá colocá-lo no diretório raiz de um ativo ou archive de ativo antes de incluir o diretório como origem do ativo.
      Estrutura de diretório de arquivo.
  3. Corrija todos os problemas com os novos recursos, selecione o repositório de destino e atualize os recursos para o repositório.

Procedimento

Para executar uma atualização de lote por meio do cliente Eclipse a partir do sistema de arquivos:

  1. Expanda o menu na visualização Procura de ativo e selecione Atualização de lote.
    Menu Atualização de lote
  2. Na seção Localizar ativos do Editor de lote, remova o repositório que não é necessário do espaço do repositório de origem.
    Excluir o repositório na seção Localizar ativos
  3. Especifique o repositório de destino para o qual você deseja importar o ativo ou crie uma conexão do repositório.
    Selecionar a conexão do repositório para essas atualizações
  4. Clique com o botão direito no espaço do repositório de origem e clique em Incluir origem de ativo > Sistema de arquivos.
    Incluir origem de ativo > Sistema de arquivos
  5. Clique com o botão direito na pasta-raiz Asset source no selecionador de pasta e clique em Incluir regra....
    Atenção: É necessário colocar todas as pastas-raiz de ativo sob a pasta-raiz. Aqui está um exemplo:
    Quatro pastas-raiz de ativo sob a pasta-raiz

    Os metadados de ativo (como Manifest.rmd) são incluídos em suas respectivas pastas-raiz de ativo.

  6. Selecione Ativo como o tipo de regra e clique em Avançar.
  7. Selecione Criar ativos usando todos os archives e pastas para buscar todas as pastas-raiz de ativo sob a pasta-raiz ou selecione Criar ativos usando archives e pastas que correspondam a esse filtro e especifique um filtro para customizar as pastas-raiz de ativo. Em seguida, clique em Concluir.
  8. Após a conclusão da validação de ativo, examine a lista no espaço de destino e resolva os problemas de validação de ativos.
  9. Clique em Atualizar todos os ativos para concluir a atualização de lote.

Exemplo

Esse exemplo descreve como executar uma atualização de lote. Nesse exemplo, há quatro pastas-raiz de ativo para você importar quatro ativos. Essas pastas são mostradas conforme abaixo:

Quatro pastas: bin asset, doc asset, source code asset e source code2 asset sob a pasta Asset source
Source code asset e source code2 asset são para ativos que contêm código-fonte como um artefato. Bin asset contém arquivos jar binários. A documentação é armazenada em doc asset.

O propósito é importar esses metadados de ativo do sistema de arquivos para o repositório Rational Asset Manager e configurar comunidades e tipos de ativo, de acordo com o uso do artefato.

Configurar o manifest e o artefato dos quatro ativos

Nesse exemplo, você deseja configurar a comunidade de bin asset como Comunidade DevOps e a de doc asset como Documentação. Antes de iniciar a atualização de lote, é necessário configurar o manifest e o artefato dos quatro ativos da maneira a seguir:
  • Estrutura de pasta e manifest 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

    Arquivo manifest (você fará upload do arquivo .jar como artefato):

    <?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>
  • Estrutura de pasta e manifest 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

    Arquivo manifest que contém um artefato de URL para a documentação online:

    <?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>
  • Estrutura de pasta e manifest de source code 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

    Arquivo manifest que contém o código-fonte compactado no arquivo .zip (o código-fonte é colocado em uma pasta):

    <?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>
  • Estrutura de pasta e manifest 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

    Arquivo manifest que contém o código-fonte compactado no arquivo .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>
Você precisa especificar os metadados para o artefato de cada ativo e colocar os artefatos no mesmo diretório com o arquivo manifest.rmd. Observe que, no arquivo manifest, os metadados para o tipo de ativo são necessários. A seguir há um exemplo:
<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>

Configurar comunidades de ativo no Editor de lote

Como você não configurou as comunidades para todos os ativos, é possível usar uma regra de ativo no Editor de lote para ajudar a configurar comunidades de ativo de acordo com o nome do ativo. Execute as etapas a seguir:
  1. No Editor de lote, importe a pasta-raiz que contém todas as quatro pastas-raiz de ativo e especifique o repositório de destino.
  2. Para incluir uma regra de ativo para o ativo de código-fonte, selecione Criar ativos usando archives e pastas que correspondam a esse filtro e digite source code* no campo Filtro. Em seguida, clique em Concluir. Uma regra de ativo para dois ativos de código-fonte agora é criada, e o cliente Eclipse selecionará duas pastas cujos nomes correspondam a source code* sob a pasta root asset source.
  3. Para criar uma regra de comunidade para ativos-fonte, clique com o botão direito na regra de ativo e clique em Incluir regra.... Na janela pop-up, clique em Comunidade > Avançar.
  4. Especifique uma comunidade existente no repositório de destino e clique em Concluir.
    Tipo em Software livre de amostra no campo Comunidade

    Uma nova regra de comunidade é incluída sob Regra de ativo para ativos-fonte, e a comunidade do ativo-fonte é configurada como Software livre de amostra.

    A Comunidade está sob Ativo e o Software livre de amostra está sob Comunidades(1)
  5. Uma mensagem de aviso de validação aparece, pois não há um tipo de ativo denominado código-fonte.
    Aviso sob Tipos de ativo: arquivo:/C:/Asset%20source/source%20code%20asset/source code e aviso sob Ativos (2): é necessário um tipo de ativo
    Há duas maneiras de corrigir esse problema:
    • Crie uma regra de tipo de ativo que seja como a regra para a comunidade. Especifique um tipo de ativo existente para sobrescrever o tipo de ativo dos dois ativos-fonte.
    • Mapeie o tipo de ativo ausente de cada ativo para um tipo existente no repositório ou crie o tipo de ativo no repositório.
      • Para mapear tipos de ativo:
        1. Clique com o botão direito no tipo de ativo no espaço do repositório de destino e clique em Mapear tipos de ativo....
          Mapear tipos de ativo
        2. Especifique um tipo de ativo na janela pop-up e clique em Ok.
      • Para criar tipos de ativo, clique com o botão direito no tipo de ativo no espaço do repositório de destino e clique em Criar tipos de ativo.
  6. Para continuar a incluir a regra de ativo para os outros dois ativos-fonte, use a regra de comunidade para incluí-los em comunidades diferentes. Corrija o aviso de validação deles e certifique-se de que não haja nenhuma mensagem de aviso de validação para os ativos.
    Corrigir o aviso de validação
  7. Clique no botão Atualizar todos os ativos e a atualização de lote será concluída.
    A atualização de lote é concluída e quatro ativos são mostrados
Para obter mais informações sobre como executar uma atualização em lote de um sistema de arquivos para um repositório, consulte os seguintes tópicos:

Feedback