Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ワークフローの作成
<a name="workflows-create-workflow"></a>

*ワークフロー*は、継続的統合と継続的配信 (CI/CD) システムの一部としてコードを構築、テスト、デプロイする方法を説明する自動手順です。ワークフローは、ワークフローの実行中に実行する一連のステップまたは*アクション*を定義します。ワークフローは、ワークフローを開始するイベント、または*トリガー*も定義します。ワークフローを設定するには、CodeCatalyst コンソールの[ビジュアルエディタまたは YAML エディタ](https://docs.aws.amazon.com//codecatalyst/latest/userguide/flows.html#workflow.editors)を使用して*ワークフロー定義ファイル*を作成します。

**ヒント**  
プロジェクトでワークフローを使用する方法を簡単に確認するには、[ブループリントを使用してプロジェクトを作成](https://docs.aws.amazon.com//codecatalyst/latest/userguide/projects-create.html#projects-create-console-template)します。各ブループリントは、レビュー、実行、実験可能な機能するワークフローをデプロイします。

CodeCatalyst でワークフローを作成するには、次の手順に従います。ワークフローは、選択したソースリポジトリの `~/.codecatalyst/workflows/` フォルダに YAML ファイルとして保存されます。必要に応じて、コミット時にワークフローファイル名の前にフォルダ名を付けることで、ワークフローを `~/.codecatalyst/workflows/` のサブフォルダに保存できます。詳細については、以降の手順を参照してください。

ワークフローの詳細については、「[ワークフローを使用して構築、テスト、デプロイするワークフローを使用して構築、テスト、デプロイする](workflow.md)」を参照してください。

------
#### [ Visual ]<a name="workflows-create"></a>

**ビジュアルエディタを使用してワークフローを作成するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトを選択します。

1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。

1. **[ワークフローを作成]** を選択します。

   **[ワークフローを作成]** ダイアログボックスが表示されます。

1. **[ソースリポジトリ]** フィールドで、ワークフロー定義ファイルを配置するソースリポジトリを選択します。ソースリポジトリが存在しない場合は[作成](source-repositories-create.md)してください。

1. **[ブランチ]** フィールドで、ワークフロー定義ファイルを配置するブランチを選択します。

1. **[作成]** を選択します。

   Amazon CodeCatalyst ではリポジトリとブランチの情報をメモリに保存しますが、ワークフローはまだコミットされていません。

1. **[ビジュアル]** を選択します。

1. ワークフローを構築します。

   1. (省略可) ワークフロー図で、**[ソース]** ボックスと **[トリガー]** ボックスを選択します。**[トリガー]** ペインが表示されます。**[トリガーを追加]** を選択してトリガーを追加します。詳細については、「[ワークフローへのトリガーの追加](workflows-add-trigger-add.md)」を参照してください。

   1. 左上の **[\$1 アクション]** を選択します。**[アクション]** カタログが表示されます。

   1. アクション内のプラス記号 (**\$1**) を選択して、ワークフローに追加します。右側のペインを使用してアクションを構成します。詳細については、「[ワークフローへのアクションの追加](workflows-add-action.md)」を参照してください。

   1. (省略可) **[ワークフローのプロパティ]** (右上) を選択します。**[ワークフローのプロパティ]** ペインが表示されます。ワークフロー名、実行モード、コンピューティングを構成します。詳細については、「[実行のキュー動作の構成](workflows-configure-runs.md)」および「[コンピューティングイメージとランタイムイメージの構成](workflows-working-compute.md)」を参照してください。

1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。

1. **[コミット]** を選択し、**[ワークフローをコミット]** ダイアログボックスで以下を実行します。

   1. **[ワークフローファイル名]** では、デフォルト名のままにするか名前を入力します。選択したソースリポジトリとブランチの `~/.codecatalyst/workflows/` フォルダにファイルが保存されます。ファイル名には、フォルダまたはサブフォルダを先頭に付けることができます。例:
      + `my-workflow` (フォルダなし) を指定するとファイルが `~/.codecatalyst/workflows/my-workflow.yaml` として保存される
      + `folder/subfolder/my-workflow` を指定するとファイルが `~/.codecatalyst/workflows/folder/subfolder/my-workflow.yaml` として保存される

   1. **[メッセージをコミット]** では、デフォルトメッセージのままにするかメッセージを入力します。

   1. **[リポジトリ]** と **[ブランチ]** では、ワークフロー定義ファイルのソースリポジトリとブランチを選択します。これらのフィールドは、**[ワークフローを作成]** ダイアログボックスでさきほど指定したリポジトリとブランチに設定する必要があります。必要に応じて、リポジトリとブランチをこのタイミングで変更できます。
**注記**  
ワークフロー定義ファイルをコミットした後は、別のリポジトリやブランチに関連付けることはできません。必ず慎重に選択してください。

   1. **[コミット]** を選択してワークフロー定義ファイルをコミットします。

------
#### [ YAML ]

**YAML エディタを使用してワークフローを作成するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. プロジェクトを選択します。

1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。

1. **[ワークフローを作成]** を選択します。

   **[ワークフローを作成]** ダイアログボックスが表示されます。

1. **[ソースリポジトリ]** フィールドで、ワークフロー定義ファイルを配置するソースリポジトリを選択します。ソースリポジトリが存在しない場合は[作成](source-repositories-create.md)してください。

1. **[ブランチ]** フィールドで、ワークフロー定義ファイルを配置するブランチを選択します。

1. **[作成]** を選択します。

   Amazon CodeCatalyst ではリポジトリとブランチの情報をメモリに保存しますが、ワークフローはまだコミットされていません。

1. **[YAML]** を選択します。

1. ワークフローを構築します。

   1. (省略可) YAML コードにトリガーを追加します。詳細については、「[ワークフローへのトリガーの追加](workflows-add-trigger-add.md)」を参照してください。

   1. 左上の **[\$1 アクション]** を選択します。**[アクション]** カタログが表示されます。

   1. アクション内のプラス記号 (**\$1**) を選択して、ワークフローに追加します。右側のペインを使用してアクションを構成します。詳細については、「[ワークフローへのアクションの追加](workflows-add-action.md)」を参照してください。

   1. (省略可) **[ワークフローのプロパティ]** (右上) を選択します。**[ワークフローのプロパティ]** ペインが表示されます。ワークフロー名、実行モード、コンピューティングを構成します。詳細については、「[実行のキュー動作の構成](workflows-configure-runs.md)」および「[コンピューティングイメージとランタイムイメージの構成](workflows-working-compute.md)」を参照してください。

1. (省略可) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。

1. **[コミット]** を選択し、**[ワークフローをコミット]** ダイアログボックスで以下を実行します。

   1. **[ワークフローファイル名]** では、デフォルト名のままにするか名前を入力します。選択したソースリポジトリとブランチの `~/.codecatalyst/workflows/` フォルダにファイルが保存されます。ファイル名には、フォルダまたはサブフォルダを先頭に付けることができます。例:
      + `my-workflow` (フォルダなし) を指定するとファイルが `~/.codecatalyst/workflows/my-workflow.yaml` として保存される
      + `folder/subfolder/my-workflow` を指定するとファイルが `~/.codecatalyst/workflows/folder/subfolder/my-workflow.yaml` として保存される

   1. **[メッセージをコミット]** では、デフォルトメッセージのままにするかメッセージを入力します。

   1. **[リポジトリ]** と **[ブランチ]** では、ワークフロー定義ファイルのソースリポジトリとブランチを選択します。これらのフィールドは、**[ワークフローを作成]** ダイアログボックスでさきほど指定したリポジトリとブランチに設定する必要があります。必要に応じて、リポジトリとブランチをこのタイミングで変更できます。
**注記**  
ワークフロー定義ファイルをコミットした後は、別のリポジトリやブランチに関連付けることはできません。必ず慎重に選択してください。

   1. **[コミット]** を選択してワークフロー定義ファイルをコミットします。

------