亚马逊 CodeCatalyst 不再向新买家开放。现有客户可以继续正常使用该服务。有关更多信息，请参阅 [如何从中迁移 CodeCatalyst](migration.md)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 入门工作流
<a name="workflows-getting-started"></a>

在本教程中，您将学习如何创建和配置您的第一个工作流。

**提示**  
喜欢使用预配置的工作流开始？ 请参阅[使用蓝图创建项目](projects-create.md#projects-create-console-template)，其中包含有关使用正常运行的工作流设置项目的说明、示例应用程序和其他资源。

**Topics**
+ [先决条件](#get-started-create-workflow-prerequisites)
+ [步骤 1：创建并配置工作流](#get-started-create-workflow-create)
+ [步骤 2：通过提交来保存工作流](#get-started-create-workflow-commit)
+ [步骤 3：查看运行结果](#get-started-create-workflow-results)
+ [（可选）步骤 4：清理](#get-started-create-workflow-cleanup)

## 先决条件
<a name="get-started-create-workflow-prerequisites"></a>

开始前的准备工作：
+ 你需要一个 CodeCatalyst **空间**。有关更多信息，请参阅 [创建空间](spaces-create.md)。
+ 在你的 CodeCatalyst 空间里，你需要一个名为：

  ```
  codecatalyst-project
  ```

   有关更多信息，请参阅 [在 Amazon 中创建一个空项目 CodeCatalyst](projects-create.md#projects-create-empty)。
+ 在你的项目中，你需要一个 CodeCatalyst **名**为：

  ```
  codecatalyst-source-repository
  ```

  有关更多信息，请参阅 [创建源存储库](source-repositories-create.md)。

**注意**  
如果您有现有的项目和源存储库，则可以使用它们；但是，创建新的项目和源存储库后，在本教程结束时的清理工作会更轻松。

## 步骤 1：创建并配置工作流
<a name="get-started-create-workflow-create"></a>

在此步骤中，您将创建和配置一个工作流，该工作流会在有更改时自动构建和测试源代码。

**创建工作流**

1. 在导航窗格中，选择 **CI/CD**，然后选择**工作流**。

1. 选择**创建工作流**。

   工作流程定义文件显示在 CodeCatalyst 控制台的 YAML 编辑器中。

**配置工作流**

您可以在**可视化**编辑器或 **YAML** 编辑器中配置工作流。让我们从 YAML 编辑器开始，然后再转到可视化编辑器。

1. 选择 **\$1 操作**以查看可添加到工作流中的工作流操作列表。

1. 在**构建**操作中，选择 **\$1** 可将操作的 YAML 添加到您的工作流定义文件中。工作流现在应类似于如下所示。

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

   该工作流程将`WorkflowSource`源存储库中的文件复制到运行`Build_f0`操作的计算机上，打印`Hello, World!`到日志，在计算机上发现测试报告，然后将其输出到 CodeCatalyst 控制台的 “**报告**” 页面。

1. 选择**可视化**以在可视化编辑器中查看工作流定义文件。您可以通过可视化编辑器中的字段来配置 YAML 编辑器中显示的 YAML 属性。

## 步骤 2：通过提交来保存工作流
<a name="get-started-create-workflow-commit"></a>

在此步骤中，您将保存所做更改。由于工作流以 `.yaml` 文件的形式存储在存储库中，因此您可以通过提交来保存更改。

**提交工作流更改**

1. （可选）选择**验证**以确保工作流 YAML 代码有效。

1. 选择**提交**。

1. 在**工作流文件名**中，输入工作流配置文件的名称，例如 **my-first-workflow**。

1. 在**提交消息**中，输入消息来标识您的提交，例如 **create my-first-workflow.yaml**。

1. 在**存储库**中，选择要在其中保存工作流的存储库（`codecatalyst-repository`）。

1. 在**分支名称**中，选择要将工作流保存到的分支（`main`）。

1. 选择**提交**。

您的新工作流将显示在工作流列表中。它可能需要一点时间才能显示。

由于工作流与提交保存在一起，并且工作流配置了代码推送触发器，因此保存工作流会自动启动工作流运行。

## 步骤 3：查看运行结果
<a name="get-started-create-workflow-results"></a>

在此步骤中，您将导航到从您的提交启动的运行，并查看结果。

**查看运行结果**

1. 选择工作流的名称，例如 `Workflow_fe47`。

   显示源存储库标签 (**WorkflowSource**) 和生成操作（例如 **build\$1F** 0）的工作流程图。

1. 在工作流运行图表中，选择构建操作（例如 **Build\$1f0**）。

1. 查看**日志**、**报告**、**配置**和**变量**选项卡的内容。这些选项卡显示构建操作的结果。

   有关更多信息，请参阅[查看构建操作的结果](build-view-results.md)。

## （可选）步骤 4：清理
<a name="get-started-create-workflow-cleanup"></a>

在此步骤中，您将清除在本教程中创建的资源。

**删除资源**
+ 如果您为本教程创建了新项目，请将其删除。有关说明，请参阅[删除项目](projects-delete.md)。删除项目还会删除源存储库和工作流。