Sobre Projetos

Projetos são conjuntos executáveis de etapas, com sua próprias propriedades do grupo do ambiente e do servidor.

Além de projetos, é possível criar bibliotecas. Ao contrário de um projeto, uma biblioteca não tem um seletor que determina onde etapas são inseridas.

Sobre o Painel Projetos

Use o painel Projetos para criar novos projetos e visualizar ou editar projetos existentes. Para acessar o painel Projetos no menu esquerdo, clique em Projetos.

O painel Projetos fornece as seguintes guias:

Guia Detalhes

É possível especificar várias propriedades do projeto na guia Detalhes.

Controlador de Tarefa
Escolha um controlador de tarefas para o tipo de mecanismo de projeto. As opções são controlador de tarefas principal Java ou Mecanismo Perl. O sistema usa o controlador de tarefas principal Java para executar os projetos de controlador de tarefas principal. O sistema só usa o mecanismo Perl para executar projetos de mecanismo Perl. Para obter mais informações sobre tipos de mecanismo, consulte a configuração Usar Controlador de Tarefa Principal Java como Mecanismo de Execução no tópico Configurações da Configuração do Sistema. Também é possível consultar tópicos na seção Gerenciando o Mecanismo Perl.
Nome
O nome do projeto. O sistema usa esse nome para fazer referência ao projetos em listas e no banco de dados.

Se você executar um projeto, o nome do projeto será usado para construir o diretório do projeto. Devido ao projeto contendo etapas que podem ser executadas em diferentes sistemas operacionais, evite caracteres especiais e símbolos em nomes de projetos. Se o nome de um projeto tiver que usar caracteres que produzam um nome de diretório inválido, inclua os caracteres na definição de configuração do sistema Caracteres de Dir. Relativos Inválidos. Os caracteres listados nessa configuração são convertidos em sublinhados (_) ao criar diretórios de projeto. Quando você usa o símbolo de e comercial (&), é possível produzir sem intenção uma entidade HTML como parte do nome do projeto.

Acesso
O grupo com permissão para visualizar e usar o projeto. É possível usar essa propriedade com permissões para determinar o que você tem permissão para acessar. Por exemplo, se deseja ativar uma tarefa, você deve ser membro do grupo de acesso especificado para o projeto e membro de um grupo com a permissão Executar Tarefas. Para obter mais informações sobre os grupos de acesso, consulte Visão Geral do Acesso.
Desativar
Selecione essa caixa de opção para desativar o projeto. Quando você tenta executar um projeto desativado, o Rational Build Forge exibe uma mensagem indicando que o projeto está inativo e não pode executar o projeto.
Encadeamentos Máximos
O número máximo de processos paralelos que o projeto tem permissão para ativar. Utilize esse campo para evitar que um projeto utilize recursos do sistema em excesso. Cada etapa ativada por encadeamento e quaisquer projetos seqüenciais (que podem ativar etapas ativadas por encadeamento) podem resultar em processos paralelos, mas todos esses processos são calculados em relação ao máximo do projeto pai. O sistema pára de ativar novos processos paralelos quando atinge o valor Máx. de Encadeamentos e aguarda até que o número de processos paralelos do projeto caia abaixo do valor Máx. de Encadeamentos antes de prosseguir. Para obter informações adicionais sobre encadeamento, consulte Encadeamento: Executando Etapas em Paralelo.
Nota: A propriedade de Encadeamentos máximos não é suportada em mecanismos Java.
Executar Limite
A propriedade Limite de Execução configura o número máximo de tarefas do projeto permitidas por vez.
  • Se você ativar um projeto e o número de tarefas ativas for igual ao Limite de Execução, a nova tarefa permanecerá na fila de espera até que pelo menos uma tarefa seja concluída.
  • Se um planejamento tentar ativar um projeto e o número de tarefas ativas for igual ao Limite de Execução e a definição da configuração do sistema de Limite Máximo de Execução tiver um valor de Sim, o sistema não iniciará a nova tarefa. Se o Limite Máximo de Execução estiver definido para Não, o sistema ignora a configuração de Limite de Execução para construções planejadas.
  • Os projetos ativados por uma sequência não são considerados instâncias do projeto original e não contam com relação a seu Limite de Execução.
Classe
Cada projeto deve ser designado a uma classe, que designa propriedades globais a grupos de tarefas. Para obter mais informações, consulte Classes.
Seletor
O nome do seletor quando você escolhe um servidor para o projeto. O sistema utiliza esse seletor como o padrão para quaisquer etapas dentro do projeto, portanto, não especifique seus próprios seletores. Consulte o Seletores. Se um seletor não for especificado, o projeto será incluído no painel Bibliotecas em vez de no painel Projetos. Uma biblioteca usa o seletor da etapa de chamada. Se a etapa não tiver um seletor, a biblioteca usará o seletor do projeto de chamada.
Pass Chain, Fail Chain
Selecione o projeto que será executado quando a construção do projeto for aprovada ou falhar. Uma configuração pass chain / fail chain no nível do projeto permite chamar ações pass / fail separadas com base no status pass ou fail do projeto. Essa capacidade é similar à configuração de ações pass / fail em nível de etapa dentro de um projeto. No nível do projeto, as ações pass / fail são acionadas pelo status da execução do projeto, e não pelo status da etapa.
Ambiente
O ambiente que é aplicado após o ambiente do servidor e antes da etapa ambiente. Para obter mais informações sobre o modo como os ambientes trabalham juntos, consulte Sobre Variáveis.
Afixado
Ative a caixa de opção Afixado para forçar todas as etapas do projeto usando o seletor de projeto padrão a permanecerem no mesmo servidor. Você deve esperar o servidor ficar disponível se ele estiver ocupado. Para obter mais informações sobre essa opção, consulte Tornando as Etapas Fixas em um Servidor.
Provedor de Etapa Padrão
Implementa a execução de um comando de etapa. Ele fornece comportamento legado conforme esperado da execução do texto de comando no servidor de agente do terminal. O único provedor de etapa padrão é o controlador de tarefas principal Java. Nenhum provedor de etapa está disponível para projetos de mecanismo Perl.
Notificação de Início, Notificação de Transmissão, Notificação de Falha
Use estes campos para direcionar o sistema para enviar um email de notificação no início, na aprovação ou na falha de um projeto, selecionando um grupo de acesso em um ou em todos esses campos.

Guia Tags

Use a guia Tags para gerenciar as tags de construção para um projeto.

Formato da Tag
Uma sequência que define as tags para o projeto, que usa texto simples e referências de variável de tag. Para obter mais informações sobre formatos de tag, consulte Alterando a Tag do Build Durante uma Tarefa.
Sincronização da Tag
Sincroniza as variáveis de tag dos dois projetos. Selecione o projeto cuja variável de tag você deseja sincronizar com o projeto atual. Quando dois projetos são sincronizados, as variáveis são selecionadas do mesmo conjunto. Quando dois projetos estão executando em sequência, o projeto inicial tem o valor de 1 e o seguinte tem o valor de 2. Para obter mais informações, consulte Sincronizando Tags.
Nome da Tag
O nome de variável. Ao usar uma variável de tag em um formato de tag, referencie seu nome usando o formato $<Tag Name>. Por exemplo, para criar uma tag que use as variáveis MainVer e B, use o formato de tag Build_$MainVer.$B. As tags de exemplo a seguir Build_005.1 são recuperadas.
Valor Inicial
Defina o valor da variável de tag. Se você não utilizar a opção Incremento Automático, a variável reterá esse valor até que ele seja alterado.
Preenchimento
Se você selecionar um valor de Preenchimento que não seja Nenhum, o sistema incluirá zeros à esquerda no valor da variável quando ele for usado em uma tag. Isso é feito para assegurar que o número de dígitos seja igual ao valor do Preenchimento. Por exemplo, se a variável for atual em 2, e tiver Preenchimento igual a 3, o sistema renderizará o valor como 002. Os intervalos de preenchimento variam de 1 a 8.
Auto-inc
Se for configurado como Sim, o sistema incrementará o valor da variável em 1 para cada tarefa do projeto.

Guia Registros

Use registros do projeto para armazenar informações que persistem nas construções.

Registro
O nome do registro do projeto.
Índice
O valor do registro.

Para obter informações adicionais, consulte Registros de Projeto.

Guia Notas

Use a guia Notas para armazenar itens de seu interesse sobre um projeto.

Para cada nota, a guia exibe o seguinte:

  • A data e a hora em que um usuário criou a nota
  • O usuário que criou a nota
  • A nota

Guia Captura Instantânea

Uma captura instantânea do projeto é uma instância de um projeto. A guia Captura Instantânea fornece o nome da captura instantânea.

Use esta guia para visualizar, alterar e incluir comentários no nome da captura instantânea.


Feedback