Integrando com o Rational Build Forge

É possível usar o IBM® Rational Asset Manager e o IBM Rational Build Forge para entregar, rastrear e controlar construções de software confiáveis.

O Rational Asset Manager complementa os sistemas de aplicativos de construção existentes, como o Rational Build Forge. É possível usar o Rational Build Forge para criar uma construção baseada nos recursos no Rational Asset Manager e também é possível usar a integração para publicar os resultados da construção como novos recursos no Rational Asset Manager. Um conjunto de scripts fornecido permite fazer download de recursos, verificar dependências, compilar, construir e entregar resultados como novos recursos.

O processo para ativar a integração e usar o Rational Asset Manager como uma biblioteca de software definitiva é o seguinte:
A imagem mostra uma caixa que representa o Rational Asset Manager com caixas menores que representam uma biblioteca ANT, ferramentas de compilação, componentes comuns, componentes de software livre e uma imagem de implementação dentro dessa caixa maior. Também há três outras caixas que representam o Rational Build Forge, um servidor de construção e o IBM Rational Team Concert. As setas apontam a partir dos componentes para o Rational Asset Manager, Rational Team Concert, e Rational Build Forge para o servidor de construção, onde a compilação e o teste são executados. O resultado é então publicado de volta no Rational Asset Manager a partir do servidor de construção.
  1. Copie os scripts necessários do Rational Asset Manager e seus arquivos jar dependentes da biblioteca ANT para o servidor de construção.
  2. Faça o download das ferramentas de construção necessárias a partir do Rational Asset Manager (como o compilador, ferramentas de teste e scripts comuns).
  3. Prepare a origem a partir do controle de origem.
  4. Busque artefatos dependentes a partir do Rational Asset Manager (como software livre, modelos, wsdls e xsds marcados como links nos projetos de origem).
  5. Compile e teste.
  6. Publique as construções finais no Rational Asset Manager com dependências para todos os componentes dependentes e relacionamentos necessários.

No Rational Build Forge, defina um novo projeto de construção para construir e publicar ativos. As origens para a construção são recursos e artefatos no Rational Asset Manager e as construções podem ser publicadas como recursos no Rational Asset Manager.

Por exemplo, quando os arquivos necessários forem configurados para a construção e, em seguida, depois de executar a construção e concluí-la, será possível implementar os resultados da construção (como um arquivo .ear) como ativos no Rational Asset Manager. Ou então, depois que os resultados da construção forem salvos como recursos do Rational, será possível colocar os novos recursos e artefatos associados em um processo de revisão para certificar-se de que eles estejam aprovados para implementação (por exemplo, antes de serem publicados como uma construção de Marco).

É possível marcar um Tipo de Construção (como um Marco ou um Golden Master) no Rational Build Forge para especificar o tipo do processo de revisão para os novos ativos criados a partir dos resultados de construção. Quando uma construção do Rational Build Forge for concluída, os ativos publicados serão listados na construção e, no Rational Asset Manager, todas as dependências serão incluídas no novo ativo.

Os desenvolvedores podem procurar por recursos, artefatos e links para os artefatos do Rational Asset Manager e inclui-los na área de trabalho. Eles podem usar o utilitário Procura Visual para ver os relacionamentos e as dependências entre os recursos. Esse script de recurso de download ajuda a automatizar a entrega dos arquivos em um processo de construção. No Rational Build Forge, depois de efetuar login e de criar um projeto, um desenvolvedor pode configurar as propriedades do projeto de construção e concluir outras etapas necessárias para entregar os resultados da construção.

Para obter uma demonstração da integração e uma biblioteca e projeto de construção de amostra, consulte http://www.ibm.com/support/docview.wss?uid=swg27016509 ou http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html

Configurando a Integração

Nota: A integração requer o Ant versão 1.7.x e a versão atual das APIs do cliente. O arquivo ramclient.zip está disponível na página Ajuda > Extensões do Web client.
O Rational Asset Manager fornece os seguintes scripts ANT que podem ser usados em seus projetos do Rational Build Forge:
  • ramDownloadAsset.xml - Esse script faz o download dos ativos no Rational Asset Manager para uso em um projeto de construção.
  • ramDownloadArtifactLinks.xml - Esse script faz o download dos artefatos relacionados que são dependências necessárias para os ativos transferidos por download para uso em um projeto de construção.
  • ramPublishAsset.xml - Esse script publica os resultados de construção (como um arquivo .ear) como novos ativos no Rational Asset Manager.
Você deve copiar esses scripts e seus arquivos JAR dependentes da biblioteca ANT a partir do arquivo ramclient.zip para disponibilizar as bibliotecas e os scripts no servidor de construção. Consulte o Configurando os Scripts para a Integração. Se as ferramentas, bibliotecas e componentes dependentes estiverem todos disponíveis nos ativos no Rational Asset Manager, será possível usar os scripts ANT fornecidos para executar uma construção baseada nesses ativos. Também é possível usar esses scripts com outros utilitários de construção e soluções.
Depois de copiar os scripts e configurá-los para seu ambiente, siga essas etapas:
  1. Faça o download das ferramentas necessárias, como o compilador, ferramentas de teste e scripts comuns.

    Consulte os arquivos de código de origem para o servidor de construção usando a biblioteca de comando de extração apropriada para extrair os arquivos de origem do sistema de Gerenciamento de Configuração de Software (SCM) (como o Rational ClearCase ou o Rational Team Concert. Você deve extrair os arquivos de código de origem a partir de um sistema SCM para ser usado pela construção, como as ferramentas de download que incluem a biblioteca de cliente do Rational Asset Manager, para que o DownloadAsset e outros scripts ANT possam ser usados no servidor Rational Build Forge. Você deve fornecer as informações do sistema SCM para o projeto de construção, como a URL do servidor, o ID do usuário e a senha.

  2. Faça o download da biblioteca de cliente do Rational Asset Manager a partir do servidor Rational Asset Manager e extraia-a para que os scripts ANT fornecidos possam ser usados no servidor de construção.
  3. Busque artefatos dependentes, como software livre, modelos, wsdls e xsds marcados como links nos projetos de origem. Se existirem links para os artefatos necessários do Rational Asset Manager, será possível usar o script DownloadArtifactLinks para fazer download dos artefatos necessários do Rational Asset Manager e especificar onde eles serão extraídos.

    É possível usar o AppScan para varrer todas as origens e bibliotecas que são incluídas no projeto.

  4. Compile e teste.
  5. Publique as construções finais no Rational Asset Manager com dependências para todos os componentes dependentes e relacionamentos necessários. Você deve especificar a estrutura de diretório para os ativos que publicará e especificar outros valores de propriedade no script ANT PublishAsset fornecido.

É possível usar os arquivos de amostra para definir um novo projeto com um conjunto de bibliotecas e informações de configuração, importando o conteúdo do arquivo zip por meio da importação do arquivo eligibility.xml. Os arquivos de amostra estão disponíveis em http://www.ibm.com/developerworks/offers/lp/demos/summary/r-assetmanagerrbf.html. O Rational Build Forge recria o projeto de elegibilidade quando você carrega o arquivo eligibility.xml. Selecione Bibliotecas e, em seguida, escolha uma biblioteca, como a GetRamLibraries, para recuperar o arquivo ramclient.zip. Em seguida, modifique esses arquivos para sua configuração. Você deve também modificar os scripts ANT e, em seguida, incluí-los no projeto do Rational Build Forge.

Executando Projetos do Rational Build Forge em Pontos Específicos do Ciclo de Vida de Ativos

O Rational Asset Manager inclui uma política que pode ser usada para executar um projeto do Rational Build Forge em pontos específicos no ciclo de vida de ativos. Por exemplo, se um ativo de software mover-se de um estado de desenvolvimento para um estado em estágio, em preparação para teste, você pode querer executar um projeto do Rational Build Forge que construa o software automaticamente e implementá-lo para que outros vejam.

Essa política não é instalada por padrão, mas está incluída no produto. Para instalar a política:
  1. No Web client, clique no ícone Ajuda e, em seguida, em Extensões.
  2. Na seção Política do Build Forge, faça download do arquivo buildforge.zip. Não extraia o arquivo.
  3. Clique em Administração.
  4. Na barra lateral Administração de Repositório, clique em Extensões Customizadas.
  5. Na seção Extensões da Política, clique em Nova Extensão de Política.
  6. Na janela Nova Extensão, no campo Nome de Classe, digite com.ibm.ram.buildforge.policy.BuildGovernor
  7. No campo .jar or .zip file, clique em Navegar e navegue até o arquivo buildforge.zip que foi transferido por download. Em seguida, clique em OK.

Para obter mais informações sobre políticas e ciclos de vida, consulte Políticas para Ciclos de Vida, Desenvolvimento e Ciclos de Vida do Recurso e Criando Ciclos de Vida Customizados.


Feedback