Conceitos básicos de fluxos de trabalho
Neste tutorial, você aprenderá a criar e configurar o primeiro fluxo de trabalho.
dica
Prefere começar com um fluxo de trabalho pré-configurado? Consulte Criar um projeto com um esquema, que inclui instruções para configurar um projeto com um fluxo de trabalho funcional, uma aplicação de exemplo e outros recursos.
Tópicos
Pré-requisitos
Antes de começar
-
Você precisa de um espaço do CodeCatalyst. Para ter mais informações, consulte Criar um espaço.
-
No espaço do CodeCatalyst, você precisa de um projeto vazio chamado:
codecatalyst-project
Para ter mais informações, consulte Criação de um projeto vazio no Amazon CodeCatalyst.
-
No projeto, você precisa de um repositório do CodeCatalyst chamado:
codecatalyst-source-repository
Para ter mais informações, consulte Criar um repositório de origem.
nota
Se você tiver um projeto e um repositório de origem, poderá usá-los; no entanto, a criação de outros facilita a limpeza no final deste tutorial.
Etapa 1: criar e configurar o fluxo de trabalho
Nesta etapa, você cria e configura um fluxo de trabalho que compila e testa automaticamente o código-fonte quando as alterações são feitas.
Como criar o fluxo de trabalho
No painel de navegação, escolha CI/CD e Fluxos de trabalho.
-
Selecione Criar fluxo de trabalho.
O arquivo de definição do fluxo de trabalho aparece no editor YAML do console do CodeCatalyst.
Como configurar o fluxo de trabalho
Você pode configurar o fluxo de trabalho no editor Visual ou no editor YAML. Vamos começar com o editor YAML e depois mudar para o editor visual.
-
Escolha + Ações para ver uma lista de ações do fluxo de trabalho que você pode adicionar ao fluxo de trabalho.
-
Na ação Criar, selecione + para adicionar o YAML da ação ao arquivo de definição de fluxo de trabalho. O fluxo de trabalho será semelhante ao mostrado a seguir.
Name: Workflow_fe47 SchemaVersion: "1.0" # Optional - Set automatic triggers. Triggers: - Type: Push Branches: - main # Required - Define action configurations. Actions: Build_f0: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource # This specifies that the action requires this workflow as a source Outputs: AutoDiscoverReports: Enabled: true # Use as prefix for the report files ReportNamePrefix: rpt Configuration: Steps: - Run: echo "Hello, World!" - Run: echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" >> report.xml - Run: echo "<testsuite tests=\"1\" name=\"TestAgentJunit\" >" >> report.xml - Run: echo "<testcase classname=\"TestAgentJunit\" name=\"Dummy Test\"/></testsuite>" >> report.xml
O fluxo de trabalho copia os arquivos no repositório de origem
WorkflowSource
para a máquina de computação que executa a açãoBuild_f0
, imprimeHello, World!
nos logs, descobre relatórios de teste na máquina de computação e os envia para a página Relatórios do console do CodeCatalyst. -
Selecione Visual para visualizar o arquivo de definição do fluxo de trabalho no editor visual. Os campos no editor visual permitem configurar as propriedades YAML mostradas no editor YAML.
Etapa 2: salvar o fluxo de trabalho com uma confirmação
Nesta etapa, você salva as alterações. Como os fluxos de trabalho são armazenados como arquivos .yaml
no repositório, você salva suas alterações com confirmações.
Como confirmar as alterações no fluxo de trabalho
-
(Opcional) Selecione Validar para garantir que o código YAML do fluxo de trabalho seja válido.
-
Selecione Confirmar.
-
Em Nome do arquivo do fluxo de trabalho, insira um nome para o arquivo de configuração do fluxo de trabalho, como
my-first-workflow
. -
Em Mensagem de confirmação, insira uma mensagem para identificar sua confirmação, por exemplo
create my-first-workflow.yaml
. -
Em Repositório, selecione o repositório no qual você deseja salvar o fluxo de trabalho (
codecatalyst-repository
). -
Em Nome da ramificação, selecione a ramificação na qual você deseja salvar o fluxo de trabalho (
main
). -
Selecione Confirmar.
Seu novo fluxo de trabalho aparece na lista de fluxos de trabalho. A exibição pode demorar alguns instantes.
Como os fluxos de trabalho são salvos com confirmações e como o fluxo de trabalho tem um gatilho de envio de código configurado, salvar o fluxo de trabalho inicia a execução do fluxo de trabalho automaticamente.
Etapa 3: visualizar os resultados da execução
Nesta etapa, você navega até a execução que foi iniciada a partir da sua confirmação e visualiza os resultados.
Como visualizar os resultados da execução
-
Selecione o nome do fluxo de trabalho, por exemplo,
Workflow_fe47
.Um diagrama de fluxo de trabalho mostrando o rótulo do repositório de origem (WorkflowSource) e a ação de criação (por exemplo, Build_f0).
-
No diagrama de execução do fluxo de trabalho, selecione a ação de criação (por exemplo, Build_f0).
-
Analise o conteúdo das guias Logs, Relatórios, Configuração e Variáveis. Essas guias mostram os resultados da sua ação de criação.
Para ter mais informações, consulte Visualização dos resultados de uma ação de criação.
(Opcional) Etapa 4: limpar
Nesta etapa, você limpará os recursos que criou neste tutorial.
Como excluir recursos
-
Se você criou um projeto para este tutorial, exclua-o. Para obter instruções, consulte Excluir um projeto. A exclusão do projeto também exclui o repositório de origem e o fluxo de trabalho.