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

   ワークフローでは、`Build_f0` アクションを実行しているコンピューティングマシンに `WorkflowSource` ソースリポジトリ内のファイルをコピーし、`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\$1f0** など) が表示されているワークフロー図。

1. ワークフロー実行図で、ビルドアクション (**Build\$1f0** など) を選択します。

1. **[ログ]**、**[レポート]**、**[構成]**、**[変数]** の各タブの内容を確認します。これらのタブにはビルドアクションの結果が表示されます。

   詳細については、「[ビルドアクションの結果の表示](build-view-results.md)」を参照してください。

## （オプション）ステップ 4: クリーンアップする
<a name="get-started-create-workflow-cleanup"></a>

このステップでは、このチュートリアルで作成したリソースをクリーンアップします。

**リソースを削除するには**
+ このチュートリアル用に新しいプロジェクトを作成した場合は、削除します。手順については、「[プロジェクトの削除](projects-delete.md)」を参照してください。プロジェクトを削除すると、ソースリポジトリとワークフローも削除されます。