< Anterior | Próximo >

Lição 2: Criar um processo do componente

Os processos do componente são tarefas definidas pelo usuário que operam em componentes.

Um processo de componente é uma sucessão de comandos que são chamados etapas. As etapas podem manipular arquivos, executar comandos do sistema, configurar propriedades, transmitir informações para outras etapas e executar programas. As etapas são fornecidas por plug-ins de automação. Os processos foram projetados com o editor de processo arrastar e soltar, onde você arrasta as etapas de plug-in para o editor de design e as configura à medida que avança. Vários plug-ins são fornecidos com o produto e outros estão disponíveis, os quais funcionam com vários tipos diferentes de software. Neste tutorial use dois plug-ins, os quais são fornecidos com o produto: FileUtils e IBM UrbanCode Deploy. Um componente pode ter qualquer número de processos definidos para ele, mas um componente deve ter pelo menos um processo.

Nesta lição, você cria um processo de implementação para o componente helloWorld. Posteriormente, você cria um processo de aplicativo que usa o processo do componente para implementar o componente.

Para criar o processo do componente:

  1. Defina o processo do componente :
    1. Na página "Componente: helloWorld", clique na guia Processos e, em seguida, clique em Criar Novo Processo.
    2. Na janela Criar novo processo, digite helloProcess no campo Nome.
    3. Na lista Tipo de processo, selecione Implementação. Essa lista possui outras opções para processos que desinstalam ou configuram componentes.
    4. Aceite os valores padrão para os outros campos e clique em Salvar. O campo Diretório ativo padrão se torna a pasta que o agente usa para executar o seu trabalho, como fazer download de artefatos e criar arquivos temporários. Para o tutorial, o valor torna-se \agent_install\var\work\helloWorld.
    O processo é listado na janela Processos.
  2. Na lista de processos, selecione helloProcess. O processo é aberto no editor de processos. O editor de processo lista os plug-ins e as etapas. As etapas necessárias Iniciar e Concluir representam o início e o fim do processo e são automaticamente colocados na área de design. Inclua etapas no processo, arrastando-as para a área de design e organizando-as entre as etapas Iniciar e Concluir.
    O editor de design de processo
  3. Inclua uma etapa que remove arquivos do diretório ativo. Para assegurar que o agente funcione com os arquivos mais recentes, remova os arquivos restantes do trabalho anterior:
    1. Na lista Etapas de plug-in disponíveis, expanda Utilitários > FileUtils.
    2. Clique e arraste a etapa Excluir arquivos e diretórios para o editor de processos. A janela Editar propriedades é aberta, mostrando as propriedades para a etapa. Algumas dessas propriedades são exclusivas para a etapa e outras são as mesmas para todas as etapas.
    3. No campo Nome, especifique um nome, por exemplo, Limpar espaço de trabalho.
    4. No campo Diretório base, especifique um único ponto (.). Este valor será resolvido para a pasta que você especificou como o diretório ativo do agente.
    5. No campo Incluir, especifique um asterisco (*). Esse parâmetro instrui o agente para remover todos os arquivos existentes no diretório ativo.
    6. Aceite os valores padrão para as outras propriedades e, em seguida, clique em Salvar.
    A nova etapa é exibida na área de design. Cada etapa tem dois ícones no canto superior direito da etapa. Clique no ícone Editar para abrir a janela Editar propriedades na qual é possível modificar as propriedades da etapa. Clique no ícone X para excluir a etapa e as conexões para ela ou dela.
    O novo processo com uma etapa
  4. Conecte a etapa Iniciar à etapa Limpar espaço de trabalho. Começando com a etapa Iniciar, as conexões entre as etapas determinam o fluxo do processo. É possível definir conexões à medida que você coloca etapas, ou posteriormente.
    1. Mova o mouse sobre Iniciar. O ícone de seta é exibido, como mostra a figura a seguir. Use esse ícone para conectar as etapas entre si.
      O ícone de seta
    2. Clique e arraste o ícone de seta na etapa Limpar espaço de trabalho. A seta de conexão liga as duas etapas, como mostra a figura a seguir. A direção da seta define a direção do fluxo do processo.
      A seta conecta as duas primeiras etapas
  5. Inclua uma etapa para fazer download da versão mais recente dos artefatos do componente do repositório CodeStation. A etapa Fazer download de artefatos é usada na maioria dos processo de tipo de implementação. Esta etapa faz download da versão especificada dos artefatos de componente para o diretório ativo do agente limpo recentemente. Quando você executar o processo, especifique qual versão do componente os artefatos usarão.
    1. Em Etapas de plug-in disponíveis, expanda Repositórios > Artefatos > IBM UrbanCode Deploy e arraste a etapa Fazer download de artefatos para o editor de processos.
    2. Na janela Editar propriedades, aceite os valores padrão e, em seguida, clique em Salvar.
    3. Desenhe uma conexão da etapa Limpar espaço de trabalho com a etapa Fazer download de artefatos. Exceto para conexões da etapa Iniciar, cada conexão possui um sinalizador condicional. O sinalizador condicional representa o status do processo que é necessário para que a conexão possa ser seguida. A conexão será seguida somente se a etapa de origem for concluída e a condição especificada for atendida. As condições possíveis são como se segue: êxito, falha, ou ambos. A condição padrão é êxito, que é representada por uma marca de seleção verde, como mostra a figura a seguir. Neste exemplo, a etapa Fazer download de artefatos será iniciado somente se a etapa Limpar espaço de trabalho for concluída com uma condição de êxito. É possível alterar o sinalizador condicional clicando no ícone.
      O sinalizador condicional
  6. Inclua uma etapa para criar um arquivo compactado. Neste exemplo, o arquivo compactado contém os arquivos que foram transferidos por download na etapa anterior.
    1. Expanda Utilitários > FileUtils e arraste a etapa Criar arquivo .zip para o editor de processos.
    2. Na janela Editar propriedades, especifique o nome Compactar artefatos.
    3. No campo Nome do arquivo .zip, digite helloWorld.zip.
    4. No campo Diretório base, digite um único ponto (.). O arquivo compactado é criado no diretório ativo do agente.
      Nota: Se você especificar o diretório de destino final em vez do diretório ativo do agente, a etapa a seguir será desnecessária. Entretanto, além de mover o arquivo, a etapa a seguir demonstra como usar a propriedade que você criou anteriormente.
    5. No campo Incluir, digite um asterisco (*). O arquivo compactado contém todos os arquivos que foram transferidos por download a partir do repositório.
    6. Aceite os valores padrão nos outros campos e clique em Salvar.
    7. Desenhe uma conexão da etapa Fazer download de artefatos para a etapa Compactar artefatos.
  7. Inclua uma etapa para mover os artefatos. Essa etapa move o arquivo compactado para a pasta de destino. Para simplificar, o tutorial move o arquivo para um diretório na pasta \helloWorld.
    1. Expanda Utilitários > FileUtils e arraste a etapa Mover diretório para o editor de processos.
    2. Na janela Editar propriedades, especifique o nome Implementar artefatos.
    3. No campo Diretório de origem, digite um único ponto (.).
    4. No campo Diretório de destino, digite o valor a seguir: ${p:helloHome}/target. O valor ${p:helloHome} refere-se à propriedade que você criou anteriormente. O diretório /target é relativo ao valor da propriedade. Por exemplo, se você definiu o valor da propriedade como /home/user1/artifacts/shared/helloWorld, o arquivo será movido para /home/user1/artifacts/shared/helloWorld/target. Para obter informações sobre como usar propriedades, consulte Properties.
    5. No campo Incluir arquivos, digite: *.zip.
    6. Aceite os valores padrão nos outros campos e clique em Salvar.
  8. Salve o processo clicando no ícone Salvar em Ferramentas.
O processo completo para o componente helloWorld é semelhante à figura a seguir:
O processo completo para o componente helloWorld

Ponto de verificação da lição

Nesta lição, você criou os processos do componente para implementar o componente helloWorld.
É possível usar processos do componente para automatizar muitas tarefas nos componentes. Posteriormente neste tutorial, você criará um processo de aplicativo para implementar o componente.
< Anterior | Próximo >

Feedback