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:
- Instale um agente Build Forge em um host que pode conectar ao servidor ClearCase.
- Instale o cliente ClearCase completo no host do agente.
- Configure o ambiente para o agente para que seja possível executar comandos por meio do cliente ClearCase.
- 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.

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: permitem ver a versão mais recente de elementos nas VOBs que você especifica sem copiá-los para o sistema local. Elas devem ser iniciadas. Você especifica as VOBs a serem montadas na visualização.
- Visualizações de captura instantânea: são uma cópia do repositório.
É possível especificar a versão dos objetos a serem usados. As visualizações de captura instantânea devem ser manualmente atualizadas para obter os itens mais recentes que foram registrados.
- 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
- Varre um diretório em uma visualização do ClearCase.
- 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
- Cria uma nova linha de base a partir do conteúdo de uma visualização do
ClearCase.
- Compara a nova linha de base e a linha de base da execução do adaptador
anterior para identificar a atividade de alteração.
- 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.
- 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
- Cria uma nova linha de base a partir do conteúdo de uma visualização do
ClearCase.
- Compara a nova linha de base e a linha de base da execução do adaptador
anterior para identificar os arquivos alterados.
- 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.
- 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
- 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.
- 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.
- 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
- Cria e aplica um novo rótulo para o conteúdo de uma visualização do
ClearCase.
- Compara o novo rótulo e o rótulo da execução do adaptador
anterior para identificar os arquivos alterados.
- 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.
- 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.
- CLEARCASE_VIEW
- _CLEARCASE_VIEWS
- _CLEARCASE_VOBS
Consulte o Referência de Variáveis do Ativador.