< Anterior | Próximo >

Lição 8: Jazz Team Builds

Esta seção examina a interface com o usuário do Jazz Team Build a partir da perspectiva de um desenvolvedor que é um consumidor do que a construção do Rational Team Concert fornece. Entretanto, você precisará realizar alguma configuração que poderia ser realizada normalmente por seu administrador de construções ou engenheiro de release. Para fazer o Jazz Team Build produzir o que seu projeto requer pode envolver um pouco de customização e a adoção de scripts de construção para atender aos requisitos do projeto. Felizmente, o Jazz Team Build facilita a sua execução para que você possa ver como ele opera exatamente como se estivesse trabalhando para sua equipe.
O Jazz Team Build é um componente fundamental do Rational Team Concert. Por si só ele não constrói nada, mas ele fornece a infra-estrutura para recuperar o trabalho da sua equipe do repositório do Rational Team Concert, torna-o disponível para seus scripts de construção e fornece os resultados para o Rational Team Concert. Você, como um usuário do Rational Team Concert e consumidor das construções, pode monitorar as construções em execução e acessar os resultados. Desde o início do Rational Team Concert, o Jazz Team Build tem sido usado para construir o próprio Rational Team Concert.
Como o Jazz Team Build funciona? A seguir está uma visão geral:
  1. Definir um planejamento: Uma construção específica opera de acordo com um planejamento que você define. Volte a chamar a partir da seção no controle de origem doRational Team Concert que uma equipe compartilha seu trabalho de desenvolvimento em um ou mais fluxos de equipe.
  2. Verificar se há alterações: Quando é hora de executar uma construção para uma equipe, o Jazz Team Build verifica se há quaisquer alterações no conteúdo dos fluxos da equipe e aceita as alterações, conhecidas como conjuntos de alterações, em sua própria área de trabalho de construção para que ele tenha uma cópia atual do(s) fluxos(s).
  3. Buscar conteúdo do repositório e executar construção: A construção busca, então, conteúdo da área de trabalho de construção para o sistema de arquivos no qual seus scripts de construção executam a construção.
  4. Publicar artefatos no repositório: Artefatos de construção são publicados no repositório do Rational Team Concert para acessos pelos usuários.
  5. Enviar notificação de que uma construção está concluída: O status de todas as construções é relatado em tempo real e você é automaticamente notificado quando as construções são concluídas.
O Jazz Team Build inclui o Jazz Build Engine e o kit de ferramentas de construção do Jazz. A instalação e operação destes componentes é muito fácil. A partir de seu cliente Jazz Client, as seguintes tarefas devem ser concluídas:
  • Definir um script de construção (deixaremos que seu cliente Eclipse Jazz Client execute a maior parte do trabalho aqui)
  • Definir uma definição da construção que identifique seu script de construção
  • Definir um mecanismo da construção para executar a construção definida
  • Iniciar o mecanismo da construção que responderá aos pedidos de construção, executar construções e publicar resultados
Isto permitirá que você solicite uma construção, examine os resultados e explore a interface com o usuário da construção como se fosse um desenvolvedor e um consumidor do que a construção do Jazz Team Build produz.
Nota: As etapas de configuração são um pouco longas. Se você desejar, pode pausar agora e retornar posteriormente. Se você decidir não seguir a configuração da construção, deverá ler a próxima seção intitulada Fazendo um Tour pela Interface com o Usuário do Jazz Team Build. Aqui você aprenderá como pode solicitar construções e examinar os resultados da construção.

Configurando uma Área de Trabalho do Eclipse para o Membro da Equipe de Construção

Neste tutorial, o membro da equipe de construção criado em uma lição anterior é o usuário de construção dedicado. Defina e configure uma nova área de trabalho do Eclipse para o membro da equipe de construção.
Para definir e configurar uma nova área de trabalho do Eclipse para o membro da equipe de construção:
  1. Alterne para uma nova área de trabalho do Eclipse.
  2. Crie uma conexão do repositório.
  3. Conecte-se à área do projeto Prelúdio.
Para obter informações adicionais, consulte Lição 2: Conectando-se. Após completar a configuração, sua visualização Artefatos da Equipe deve ser exibida da seguinte forma:

Área de trabalho do Eclipse do membro da equipe de construção

Criando um Script de Construção

Para criar um script de construção:
Certifique-se de que tenha uma conexão do repositório definida e que tenha efetuado login.
  1. Na visualização Package Explorer, clique com o botão direito do mouse em um projeto; em seguida, clique em Exportar.
  2. No assistente de Exportação, na página Selecionar, sob Geral, selecione Arquivos de Construção Ant e clique em Avançar.
  3. Na página Exportar, garanta que seu projeto e todas as caixas de opção estejam selecionadas e clique em Concluir.
Um arquivo build.xml é incluído em seu projeto. Esse arquivo usa uma linguagem de script Ant. Este script compilará seu projeto e produzirá arquivos de classe Java™. Observe que ele é identificado como uma alteração de saída.

build.xml incluído na visualização Package Explorer

Atenção: Não entregar o script Ant ainda.

Criando uma Área de Trabalho do Repositório Dedicada

Você pode criar um espaço de trabalho do repositório dedicado para ser utilizado pela definição da construção Jazz para o seu projeto. Durante uma construção, o Jazz Build Engine, que é conectado ao repositório do Jazz usando um identificador de usuários pré-designado, usa esta área de trabalho de construção para identificar o conteúdo a ser construído. Primeiro, ele aceita quaisquer alterações recebidas do fluxo da equipe e, então, carrega o conteúdo da área de trabalho de construção no sistema de arquivos local para processamento.
Para criar uma área de trabalho do repositório de construção dedicada:
  1. Na visualização Artefatos da Equipe, clique com o botão direito do mouse em Minhas Áreas de Trabalho do Repositório; em seguida, clique em Novo > Área de Trabalho do Repositório.
  2. No assistente Nova Área de Trabalho do Repositório, na página Selecionar um Fluxo, clique no botão de opções Fluir com um Fluxo e, na área de janela abaixo, selecione Fluxo da Equipe 1 (Equipe 1).
  3. Clique em Avançar.
  4. Na página Nova Área de Trabalho do Repositório, digite o nome da área de trabalho de construção Área de Trabalho de Construção da Equipe 1 e clique em Avançar.
  5. Na página Ler Permissão de Acesso, certifique-se de que Público esteja selecionado e clique em Avançar.
  6. Na página Componentes para Incluir, confirme que o componente do fluxo está selecionado e desmarque a caixa de opção Carregar Espaço de Trabalho do Repositório após a Criação.
  7. Clique em Concluir. A área de trabalho do repositório de construção é exibida em sua visualização.

    Área de trabalho do repositório de construção incluída na visualização Minhas Áreas de Trabalho do Repositório

Criando uma Definição da Construção e um Mecanismo da Construção

Você pode criar uma definição da construção do Jazz para seu projeto. A definição de construção é configurada para usar a nova área de trabalho de construção, assim, quando a construção é executada, ela pode aceitar quaisquer alterações do fluxo da equipe antes do início da construção.
Para criar uma definição da construção:
  1. Na visualização Artefatos da Equipe, expanda a pasta do projeto.
  2. Clique com o botão direito do mouse em Construções; em seguida, clique em Nova Definição da Construção.
  3. No assistente Nova Definição da Construção, na página Nova Definição da Construção, aceite os padrões e clique em Avançar.
  4. Na página Informações Gerais, na área de janela Modelos de Construção Disponíveis, selecione Ant – Jazz Build Engine e clique em Avançar.
  5. Na página Pré-construção, selecione Controle de Origem Jazz e clique em Avançar.
  6. Na página Pós-construção, aceite os padrões e clique em Avançar.
  7. Na página Configuração Adicional, garanta que todas as opções estejam selecionadas e clique em Concluir. O editor Definição da Construção é aberto.
  8. Crie um mecanismo da construção para a definição da construção:
    1. Na área de janela Mecanismos de Construção de Suporte, clique em Criar Mecanismo.
    2. Na caixa de diálogo Criar Mecanismo de Construção, no campo ID do Mecanismo, digite PreludeBuildEngine.
    3. Clique em OK.
  9. Clique na guia Controle de Origem Jazz do editor Definição da Construção.
  10. Na área de janela Carregar Opções, no campo Carregar Diretório, digite fetched.
  11. Para especificar uma área de trabalho de construção, complete as seguintes etapas:
    1. Na área de janela Área de Trabalho de Construção, clique em Selecionar.
    2. Na caixa de diálogo Selecionar um Fluxo ou Área de Trabalho, na área de janela Itens Correspondentes, selecione Área de Trabalho de Construção da Equipe e clique em OK.
  12. Clique na guia Ant.
  13. No campo Construir Arquivo, digite o seguinte caminho: fetched/projectname/build.xml, em que projectname é o nome do seu projeto Java. Para este tutorial, usaremos o projeto HelloWorld.
  14. No campo Diretório Inicial Java, digite o caminho de arquivo para seu compilador Java. Por exemplo, C:\Program Files\IBM\TeamConcert\jdk.
  15. Clique em Salvar.
A configuração está concluída! Se você examinar a visualização Artefatos da Equipe visualizará a definição da construção e o mecanismo da construção listados.

Definição da construção e mecanismo da construção na visualização Artefatos da Equipe

Fornecendo o Script de Construção

Antes de iniciarmos o mecanismo da construção para executar nossas construções, lembre-se de que o script de construção (build.xml) em seu projeto Hello Prelude não foi fornecido para o fluxo. Sem ele, o Jazz Build Engine não terá as instruções necessárias para executar a construção. Vamos fornecer essa alteração agora.
  1. Na visualização Alterações Pendentes, sob Componente Padrão, clique com o botão direito do mouse em Não-resolvido; em seguida, clique em Registrar Entrada e Entregar.

    Visualização Alterações Pendentes

  2. No Assistente Efetuar o Registro de Entrada e Fornecer, na área de janela Comentário do Conjunto de Alterações, digite um comentário e clique em Avançar.
  3. Na página Associar Item de Trabalho, selecione um item de trabalho existente e clique em Concluir.
O script de construção agora está no fluxo. Quando a construção for executada, o script estará disponível.

Iniciando o Mecanismo da Construção

Inicie o mecanismo de construção para preparar-se para executar uma construção.
Nota: Ao iniciar o mecanismo de construção, para assegurar que o JDK correto seja usado, você pode especificar o JDK incluído no Jazz Client usando o argumento de linha de comandos -vm.

Para iniciar o mecanismo da construção:
  1. A partir de uma linha de comandos, navegue para installdir/buildsystem/buildengine/eclipse, em que installdir é o diretório de instalação do Build System Toolkit
  2. Digite jbe -vm clientinstalldir/jazz/client/eclipse/jdk/bin/java -repository repositoryURL -userId build –pass password -engineId PreludeBuildEngine , em que
    • clientinstalldir é o diretório de instalação do Jazz Client.
    • repositoryURL é a URL do seu repositório. Por exemplo, http://localhost:9080/jazz/.
    • password é a senha do usuário da construção.
    Neste tutorial, o ID do usuário é build e o identificador do mecanismo de construção é PreludeBuildEngine.
O mecanismo inicia e tem uma aparência semelhante a esta no console (você pode visualizar algumas outras mensagens também):
2009-06-11 16:08:47 Executando o loop de construção...
2009-06-11 16:08:47 Aguardando o pedido...

O valor -sleepTime de 1 (segundo) garantirá que os pedidos de construção sejam processados imediatamente.

O mecanismo da construção está aguardando para trabalhar. É o momento de executar uma construção.

Fazendo um Tour pela Interface com o Usuário do Jazz Team Build

Aprenda sobre as tarefas de construção que podem ser executadas com o Jazz Team Build.

O Jazz Client permite executar as seguintes tarefas de construção:

Vamos examinar cada uma destas tarefas.

Solicitando uma Construção

Você pode solicitar uma construção a partir da visualização Artefatos da Equipe. Você também pode alterar propriedades de construção ou solicitar uma construção pessoal que não impacte o status da definição da construção e que execute em um espaço de trabalho que você especifica.
Para solicitar uma construção:
  1. Na visualização Artefatos da Equipe, expanda a pasta do projeto.
  2. Expanda a pasta Construções e localize o nome da construção na lista.
  3. Clique com o botão direito do mouse em Construção da Equipe 1; em seguida, clique em Solicitar Construção.
    1. Opcional: Para solicitar uma construção pessoal que não impacte o status da definição da construção e que execute em um espaço de trabalho do repositório que você especifica, na área de janela Opções de Construção, selecione Construção Pessoal. Se necessário, atualize os campos Espaço de Trabalho do Repositório e Regras de Carregamento de Componentes.
  4. Na caixa de diálogo Solicitar Construção, clique em Enviar.
O mecanismo de construção processa o pedido de construção. É possível observar esse processo na janela de comandos onde você iniciou o mecanismo de construção.

Se a construção não foi executada corretamente, examine o arquivo de log publicado no resultado de construção.

Visualizando Resultados da Construção

Vamos abrir o resultado da construção e ver o que aconteceu.
O editor de resultado de construção possui as guias Visão Geral, Logs e Propriedades. Você poderá visualizar guias adicionais dependendo da contribuição do script de construção para o resultado de construção. Por exemplo, se o script de construção contribuir com resultados de compilação e downloads, o editor de resultado de construção incluirá as guias Compilação e Downloads.

Você concluiu as seguintes tarefas:

  1. Você enviou uma solicitação de construção. Ela pode ter sido iniciada automaticamente em um planejamento predefinido.
  2. O pedido foi recebido pelo Jazz Build Engine juntamente com a definição de construção.
  3. Usando uma área de trabalho de construção configurada na definição de construção (Área de Trabalho de Construção da Equipe 1), o Jazz Build Engine executou uma operação aceitar para atualizar a área de trabalho de construção do fluxo. Na primeira construção, isto trouxe o script de construção recentemente criado (build.xml) para a área de trabalho de construção, que é essencial para executar uma construção.
  4. O conteúdo da atualização da área de trabalho de construção foi carregado no sistema de arquivos, usando o diretório denominado fetched na definição de construção.
  5. O script de construção especificado na definição da construção é chamado. Nosso script compilou o projeto HelloWorld e criou arquivos de classe Java. Um script mais sofisticado pode ter criado um arquivo jar e o publicou no Jazz.
  6. Quando o script é concluído, o log de construção e quaisquer outros resultados publicados são armazenados no Repositório do Jazz.
  7. A equipe é notificada de que a construção foi concluída.

Editor de Resultados da Construção

Há algumas coisas a destacar sobre o que o editor de resultados da construção pode oferecer:

Examinando o Log da Construção

Vamos examinar o log da construção para visualizar se o nosso novo script de construção funcionou.
  1. Acesse a página Logs. Vamos inspecionar o que a construção fez.

    Página Logs

  2. Selecione o arquivo de log e clique em Abrir. Aqui você pode visualizar as atividades mais relevantes que aconteceram.

    Um log de construção de amostra

    Neste meio tempo, você está começando a ver como o Jazz torna as informações de construção bastante visíveis para você e sua equipe.

Monitorando o Status das Construções

O status da construção pode ser obtido passivamente ou ativamente. Informações de construção passivas são fornecidas de duas maneiras: na seção Construção da visualização Central da Equipe e alertas de construção que aparecem brevemente em sua tela.

Conforme as construções são concluídas, na visualização Central da Equipe, a seção Construção é atualizada com o status de construções concluídas para a(s) equipe(s) da(s) qual(is) você participa.

Para uma construção selecionada nesta visualização, você pode visualizar os resultados da construção ou solicitar uma nova construção.

Para customizar com que frequência o status será atualizado:

Localizando Construções Disponíveis

É possível ver quais construções estão disponíveis, o status de execução das construções e as construções enfileiradas para execução na visualização Construções, que é acessível usando o menu de contexto Mostrar Resultados de Construção na pasta Construções na visualização Artefatos da Equipe.

Mostrar item de menu Resultados da Construção

Os conteúdos da visualização podem ser classificados selecionado uma coluna. Existem inúmeras ações de menu de contexto interessantes. Você pode comparar uma construção com o fluxo a partir da qual foi construída ou criar um novo fluxo a partir de uma construção (útil para a criação de um novo código base proveniente de um código base comprovado).

Visualização Resultados da Construção

Também é possível visualizar resultados de construção definindo-se um viewlet de construção em seu painel do Jazz baseado na Web:

Resultados de construção do painel do Jazz baseado na Web

A equipe de desenvolvimento do Jazz vem customizado seu processo de construção por um bom tempo. O editor de resultados de construção do Jazz possui guias adicionais denominadas Compilação, JUnit e Downloads, além de Links Externos. A seguir está uma captura de tela de uma construção do Jazz, para que você possa ver seu potencial.

Resultados de construções customizados de amostra

Ponto de Verificação da Lição

Nesta lição, você aprendeu os conceitos básicos da funcionalidade do Jazz Team Build.
< Anterior | Próximo >

Feedback

Isto foi útil? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro