A Amazon não CodeCatalyst está mais aberta a novos clientes. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [Como migrar do CodeCatalyst](migration.md).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conceitos básicos de fluxos de trabalho
<a name="workflows-getting-started"></a>

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](projects-create.md#projects-create-console-template), que inclui instruções para configurar um projeto com um fluxo de trabalho funcional, uma aplicação de exemplo e outros recursos.

**Topics**
+ [Pré-requisitos](#get-started-create-workflow-prerequisites)
+ [Etapa 1: criar e configurar o fluxo de trabalho](#get-started-create-workflow-create)
+ [Etapa 2: salvar o fluxo de trabalho com uma confirmação](#get-started-create-workflow-commit)
+ [Etapa 3: visualizar os resultados da execução](#get-started-create-workflow-results)
+ [(Opcional) Etapa 4: limpar](#get-started-create-workflow-cleanup)

## Pré-requisitos
<a name="get-started-create-workflow-prerequisites"></a>

Antes de começar
+ Você precisa de um CodeCatalyst **espaço**. Para obter mais informações, consulte [Criar um espaço](spaces-create.md).
+ Em seu CodeCatalyst espaço, você precisa de um projeto vazio chamado:

  ```
  codecatalyst-project
  ```

   Para obter mais informações, consulte [Criando um projeto vazio na Amazon CodeCatalyst](projects-create.md#projects-create-empty).
+ No seu projeto, você precisa de um CodeCatalyst **repositório** chamado:

  ```
  codecatalyst-source-repository
  ```

  Para obter mais informações, consulte [Criar um repositório de origem](source-repositories-create.md).

**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
<a name="get-started-create-workflow-create"></a>

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**

1. No painel de navegação, escolha **CI/CD** e **Fluxos de trabalho**.

1. Selecione **Criar fluxo de trabalho**.

   O arquivo de definição do fluxo de trabalho aparece no editor YAML do CodeCatalyst console.

**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.

1. Escolha **\$1 Ações** para ver uma lista de ações do fluxo de trabalho que você pode adicionar ao fluxo de trabalho.

1. Na ação **Criar**, selecione **\$1** 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 `WorkflowSource` origem para a máquina computacional que executa a `Build_f0` ação, imprime `Hello, World!` nos registros, descobre relatórios de teste na máquina computacional e os envia para a página Relatórios do CodeCatalyst console.**

1. 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
<a name="get-started-create-workflow-commit"></a>

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**

1. (Opcional) Selecione **Validar** para garantir que o código YAML do fluxo de trabalho seja válido.

1. Selecione **Confirmar**.

1. 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**.

1. Em **Mensagem de confirmação**, insira uma mensagem para identificar sua confirmação, por exemplo **create my-first-workflow.yaml**.

1. Em **Repositório**, selecione o repositório no qual você deseja salvar o fluxo de trabalho (`codecatalyst-repository`).

1. Em **Nome da ramificação**, selecione a ramificação na qual você deseja salvar o fluxo de trabalho (`main`).

1. 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
<a name="get-started-create-workflow-results"></a>

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**

1. Selecione o nome do fluxo de trabalho, por exemplo, `Workflow_fe47`.

   Um diagrama de fluxo de trabalho mostrando o rótulo do seu repositório de origem (**WorkflowSource**) e a ação de criação (por exemplo, **build\$1F0**).

1. No diagrama de execução do fluxo de trabalho, selecione a ação de criação (por exemplo, **Build\$1f0**).

1. 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 obter mais informações, consulte [Visualização dos resultados de uma ação de criação](build-view-results.md).

## (Opcional) Etapa 4: limpar
<a name="get-started-create-workflow-cleanup"></a>

Nesta etapa, você limpará os recursos que criou neste tutorial.

**Como excluir recursos**
+ Se você criou um projeto para este tutorial, exclua-o. Para instruções, consulte [Excluir um projeto](projects-delete.md). A exclusão do projeto também exclui o repositório de origem e o fluxo de trabalho.