Rational Build Forge e Rational ClearCase

O BuildForge pode trabalhar com o Rational ClearCase para o gerenciamento do código de origem.

Este tópico descreve requisitos adicionais de configuração para a integração com o Rational ClearCase e resume as características dos modelos de adaptadores de amostra fornecidos.

As amostras de modelo do adaptador ClearCase fornecem métodos para analisar mudanças feitas em uma linha de base. Geralmente, a análise de mudanças é usada para evitar a construção: se um componente de linha de base não tiver sido alterado, ele não será reconstruído.

Requisitos Adicionais de Configuração para Adaptadores ClearCase

Consulte Requisitos do Adaptador para obter os requisitos gerais. Além de preencher os requisitos gerais, faça o seguinte:

  1. Instale um agente Build Forge em um host que pode conectar ao servidor ClearCase.
  2. Instale o cliente ClearCase completo no host do agente.
  3. Configure o ambiente para o agente para que seja possível executar comandos por meio do cliente ClearCase.
  4. Determine como implementar e como e quando iniciar as visualizações do ClearCase que são necessárias. Os modelos fornecidos supõem o uso de visualizações dinâmicas e incluem o início dessa visualização quando executam um comando cleartool. Instale o cliente ClearCase completo no host do agente.
Ilustração que mostra o relacionamento das instalações do Build Forge e ClearCase.

Visualizações do ClearCase

O ClearCase usa as visualizações como o meio para você acessar dados. Dois tipos de visualização podem ser usados:
Visualizações Dinâmicas
As visualizações dinâmicas mostram uma área de trabalho que é constantemente atualizada sempre que algo é alterado no contexto da visualização que você escolhe para ver. Somente os elementos que você efetua o registro de saída são copiados para a área de trabalho e você deve efetuar o registro de entrada deles para que sejam disponibilizados a outros usuários. Ao usar visualizações dinâmicas, você usa três especificações para acessar os dados desejados:
  • Visualização: define a lista de versões a serem apresentadas (por meio de uma especificação de configuração). A visualização deve ser iniciada usando um comando. Ela é representada no disco local como um diretório-raiz para o conteúdo. Ela também é chamada de raiz da visualização. Os diretórios comumente usados são:
    • Windows: unidade M:, uma unidade compartilhada
    • UNIX ou Linux: /view, um sistema de arquivos montado
  • Contexto da visualização: define um diretório de conteúdo a ser usado por meio de uma tag de visualização. A tag de visualização é definida no ClearCase. O diretório torna-se disponível quando a visualização é iniciada.
  • VOB (versioned object base): define um subdiretório do contexto da visualização. As VOBs são definidas no ClearCase. Você monta uma VOB no contexto da visualização explicitamente. Esse subdiretório contém os artefatos com versão (arquivos de origem e outros artefatos).

Os caminhos para uma VOB na máquina local são criados fora destes três itens:

  • Caminho de exemplo para sistemas Windows, usando o padrão: M:\view_tag\vob_name
  • Caminho de exemplo para sistemas UNIX e Linux, usando o padrão: /view/view_tag/vob_name
Visualizações de Captura Instantânea
Ao usar visualizações de captura instantânea, você especifica o contexto da visualização e também deve carregar os dados. Em seguida, você tem uma cópia local de todos os dados especificados. As visualizações de captura instantânea devem ser recarregadas para obter as mudanças registradas desde a última vez que você carregou dados.

Recursos do Rational Build Forge que suportam visualizações dinâmicas

É possível usar variáveis de ambiente para definir e iniciar visualizações dinâmicas de uma tarefa do Build Forge.
CLEARCASE_VIEW
Inicia a visualização do ClearCase. A visualização especificada nesta variável deve existir e a etapa que usa essa variável deve ser configurada para "absoluta". Em sistemas que executam o Microsoft Windows, essa variável deve ser usada com o parâmetro cc_suppress_server_root para o agente em bfagent.conf.
_CLEARCASE_VIEWS
Especifica uma lista de visualizações ClearCase, para iniciar antes da execução do comando. Configure o valor para uma lista de visualizações separadas por vírgula; por exemplo, "Visualização1,Visualização2,Visualização3".
_CLEARCASE_VOBS
Especifica uma lista de VOBs ClearCase, para montagem antes da execução do comando. Configure o valor para uma lista de VOBs separadas por vírgula; por exemplo, "\Vob1,\Vob2,\Vob3".

Talvez você também precise usar os parâmetros do agente para gerenciar visualizações no host do agente. Os parâmetros do agente deverão ser configurados se o agente que você está usando com o ClearCase estiver sendo executado em um sistema Windows. Eles também serão úteis se a raiz da visualização que você deseja usar por meio desse agente for diferente daquela configurada pela tarefa. Isso ocorrerá se você tiver usado a tarefa para mais de um agente e as especificações precisarem ser diferentes em cada sistema do host do agente.

ccviewroot root-path
Especifica a raiz da visualização padrão para esse host. Consulte a documentação do ClearCase em init para obter mais informações. Os padrões internos são os seguintes:
  • Sistemas Windows: ccviewroot M:
  • Sistemas UNIX ou Linux: ccviewroot /view
cc_suppress_server_root
Se definido, então o caminho da visualização é o caminho definido por ccviewroot. Se não definido, o caminho definido na definição do servidor é anexado ao caminho definido por ccviewroot. Essa configuração não precisa de um valor. Se ela estiver presente em bfagent.conf, então ela é definida.

Amostras de Modelo do Adaptador ClearCase

São fornecidas as seguintes amostras de modelo do adaptador.

ClearCaseBaseline
  1. Varre um diretório em uma visualização do ClearCase.
  2. Grava informações da ramificação e versão relatadas pelo ClearCase para o relatório BOM.

Variáveis usadas:

  • INT_STREAM
  • VIEW
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
ClearCaseByBaselineActivities
  1. Cria uma nova linha de base a partir do conteúdo de uma visualização do ClearCase.
  2. Compara a nova linha de base e a linha de base da execução do adaptador anterior para identificar a atividade de alteração.
  3. Para cada atividade de alteração, grava as seguintes informações no relatório BOM: atividade, arquivos alterados, usuário, data, comentários e a versão.
  4. Para cada arquivo alterado, grava detalhes da alteração (da saída de comando diff) para o relatório BOM.

Variáveis usadas:

  • CurDate
  • LAST_RUN
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
ClearCaseByBaselineVersions
  1. Cria uma nova linha de base a partir do conteúdo de uma visualização do ClearCase.
  2. Compara a nova linha de base e a linha de base da execução do adaptador anterior para identificar os arquivos alterados.
  3. Para cada arquivo alterado, grava as seguintes informações no relatório BOM: atividade, arquivos alterados, usuário, data, comentários e a versão.
  4. Para cada arquivo alterado, grava detalhes da alteração (da saída de comando diff) para o relatório BOM.

Variáveis usadas:

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearCaseByDate
  1. Consulta uma visualização do ClearCase para obter as alterações entre as duas datas. As datas padrão são o registro de data e hora atuais e o registro de data e hora da execução do adaptador anterior.
  2. Para cada arquivo alterado, grava as seguintes informações no relatório BOM: atividade, arquivos alterados, usuário, data, comentários e a versão.
  3. Para cada arquivo alterado, grava detalhes da alteração (da saída de comando diff) para o relatório BOM.

Variáveis usadas:

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE
ClearCaseByLabel
  1. Cria e aplica um novo rótulo para o conteúdo de uma visualização do ClearCase.
  2. Compara o novo rótulo e o rótulo da execução do adaptador anterior para identificar os arquivos alterados.
  3. Para cada arquivo alterado, grava as seguintes informações no relatório BOM: atividade, arquivos alterados, usuário, data, comentários e a versão.
  4. Para cada arquivo alterado, grava detalhes da alteração (da saída de comando diff) para o relatório BOM.

Variáveis usadas:

  • CurDate
  • LAST_RUN
  • LABEL
  • BASELINE
  • VIEW
  • VOB_PATH
  • PROJECT_VOB
  • CCSERVER
  • UNIXCLIENT
  • _CHAR_NATIVE

Variáveis do Adaptador ClearCase

Esta tabela é uma referência para as listas de variáveis dos modelos do adaptador.

Nome da variável de ambiente Descrição
BASELINE Para adaptadores ByBaseline, quando você utiliza o adaptador para gerar diferenças por linha de base, o sistema atualiza esse valor como a linha de base.
CCSERVER Configure essa variável com o nome do host no qual o cliente ClearCase e o agente Build Forge estão instalados.
CurDate Forneça a data atual para o adaptador, utilizando um comando .date para gerar a data no formato esperado pelo ClearCase. Não altere esse valor.
LABEL Para adaptadores ByLabel, quando você utiliza o adaptador para gerar diferenças por rótulo (com o adaptador ByLabel), o sistema atualiza esse valor como o rótulo.
LAST_RUN Para adaptadores ByDate, o sistema usa esse valor para determinar se ocorreram mudanças; o valor é a data da última execução com êxito. É possível manipular esse valor ao testar o adaptador, para impor a execução do adaptador, selecionando uma data que você sabe que precede algumas alterações. Se o adaptador permitir que a execução continue, ele atualizará automaticamente esse valor para a data atual. O valor padrão é 1-Jan-05.00:00:00.
PROJECT_VOB Quando você utilizar o adaptador ByBaseline, defina essa variável como o nome do VOB do Projeto (utilizado apenas com o UCM ClearCase). Exemplo: \ProjectVob
UNIXCLIENT Usada para configurar informações específicas da plataforma. Configure como 0 se o cliente estiver sendo executado no Windows. Configure como 1 se o cliente estiver sendo executado no UNIX ou Linux.
VIEW Defina essa variável como o nome da visualização do ClearCase que você deseja utilizar com o adaptador.
VOB_PATH Defina esse valor como o nome do VOB de componente e, opcionalmente, dos subdiretórios. Para diversos nomes, use uma lista separada por vírgulas.
_CHAR_NATIVE Usada internamente e sempre configurada como 1.

As variáveis de acionador listadas a seguir também podem ser usadas para iniciar visualizações e montar vobs. Entretanto, elas são independentes das visualizações e dos vobs configurados nas variáveis do adaptador.

Consulte o Referência de Variáveis do Ativador.


Feedback