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

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

# ワークフローの概念
<a name="workflows-concepts"></a>

CodeCatalyst でワークフローを使用してコードを構築、テスト、またはデプロイするときに知っておくべき概念と用語をいくつか紹介します。

## ワークフロー
<a name="workflows-concepts-workflows"></a>

*ワークフロー*は、CI/CD (Continuous Integration/Continuous Delivery) システムの一部としてコードを構築、テスト、デプロイする方法を説明する自動手順です。ワークフローは、ワークフローの実行中に実行する一連のステップまたは*アクション*を定義します。ワークフローは、ワークフローを開始するイベント、または*トリガー*も定義します。ワークフローを設定するには、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)します。各ブループリントは、レビュー、実行、実験可能な機能するワークフローをデプロイします。

## ワークフロー定義ファイル
<a name="workflows-concepts-workflows-def"></a>

*ワークフロー定義ファイル*は、ワークフローを記述する YAML ファイルです。デフォルトでは、ファイルは[ソースリポジトリ](source-repositories.md)のルートにある `~/.codecatalyst/workflows/` フォルダに保存されます。ファイルには .yml または .yaml 拡張子を使用でき、拡張子は小文字にする必要があります。

ワークフロー定義ファイルの詳細については、「[ワークフロー YAML 定義](workflow-reference.md)」を参照してください。

## アクション
<a name="workflows-concepts-actions"></a>

*アクション*はワークフローの主要な構成要素であり、ワークフローの実行中に実行する作業またはタスクの論理単位を定義します。通常、ワークフローには、設定方法に応じて順次または並列に実行される複数のアクションが含まれます。

アクションの詳細については、「[ワークフローアクションの構成](workflows-actions.md)」を参照してください。

## アクショングループ
<a name="workflows-concepts-action-groups"></a>

*アクショングループ*には 1 つ以上のアクションが含まれています。アクションをアクショングループにグループ化すると、ワークフローを整理するのに役立ち、異なるグループ間の依存関係を構成できるようになります。

アクショングループの詳細については、「[アクショングループへのアクションのグループ化](workflows-group-actions.md)」を参照してください。

## アーティファクト
<a name="workflows-concepts-artifacts"></a>

*アーティファクト*はワークフローアクションの出力であり、通常はフォルダまたはファイルのアーカイブで構成されます。アーティファクトは、アクション間でのファイルや情報の共有を可能にするため重要です。

アーティファクトの詳細については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。

## コンピューティング
<a name="workflows-concepts-compute"></a>

*コンピューティング*とは、CodeCatalyst がワークフローアクションを実行するために管理および保守するコンピューティングエンジン (CPU、メモリ、およびオペレーティングシステム) を指します。

コンピューティングの詳細については、「[コンピューティングイメージとランタイムイメージの構成](workflows-working-compute.md)」を参照してください。

## 環境
<a name="workflows-concepts-environments"></a>

CodeCatalyst *環境*は、[開発環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment.html)と混同されないように、CodeCatalyst [ワークフロー](workflow.md)が接続するターゲット AWS アカウント とオプションの Amazon VPC を定義します。環境は、ターゲットアカウント内の AWS サービスとリソースにアクセスするためにワークフローが必要とする [IAM ロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)も定義します。

複数の環境をセットアップし、開発、テスト、ステージング、本番稼働などの名前を付けることができます。これらの環境にデプロイすると、デプロイに関する情報が環境内で CodeCatalyst の **[デプロイアクティビティ]** タブと **[デプロイターゲット]** タブに表示されます。

環境の詳細については、「[AWS アカウント と VPCs へのデプロイ](deploy-environments.md)」を参照してください。

## ゲート
<a name="workflows-concepts-gates"></a>

*ゲート*は、特定の条件が満たされない限り、ワークフロー実行が続行されないようにするために使用できるワークフローコンポーネントです。ゲートの例として、ワークフロー実行の続行を許可する前に CodeCatalyst コンソールでユーザーが承認を送信する必要がある**承認**ゲートがあります。

ワークフロー内の連続するアクションの間にゲートを追加することも、最初のアクション (**ソース**のダウンロード直後に実行) の前にゲートを追加することもできます。必要に応じて、最後のアクションの後にゲートを追加することもできます。

ゲートの詳細については、「[ゲートを使用したワークフロー実行の続行防止](workflows-gates.md)」を参照してください。

## レポート
<a name="workflows-concepts-test-reports"></a>

*レポート*には、ワークフロー実行中に発生するテストの詳細が含まれています。テストレポート、コードカバレッジレポート、ソフトウェア構成分析レポート、静的分析レポートなどのレポートを作成できます。レポートを使用することで、ワークフロー中に問題をトラブルシューティングできます。複数のワークフローからのレポートが多数ある場合は、レポートを使用して傾向と失敗率を表示し、アプリケーションとデプロイの構成を最適化できます。

レポートの詳細については、「[品質レポートのタイプ](test-workflow-actions.md#test-reporting)」を参照してください。

## 実行
<a name="workflows-concepts-runs"></a>

*実行*はワークフローの 1 回の反復です。実行中、CodeCatalyst ではワークフロー構成ファイルで定義されているアクションを実行し、関連するログ、アーティファクト、変数を出力します。

実行の詳細については、「[ワークフローの実行](workflows-working-runs.md)」を参照してください。

## [Sources] (出典)
<a name="workflows-concepts-sources"></a>

*ソース*は*入力ソース*とも呼ばれ、[ワークフローアクション](workflows-actions.md)がオペレーションの実行に必要なファイルを取得するために接続するソースリポジトリです。例えば、ワークフローアクションがソースリポジトリに接続して、アプリケーションを構築するためにアプリケーションソースファイルを取得する場合があります。

sources の詳細については、「[ワークフローへのソースリポジトリの接続](workflows-sources.md)」を参照してください。

## [変数]
<a name="workflows-concepts-variables"></a>

 *変数*は、Amazon CodeCatalyst ワークフローで参照できる情報を含むキーと値のペアです。変数の値部分は、ワークフロー実行時に実際の値に置き換えられます。

変数の詳細については、「[ワークフローでの変数の使用](workflows-working-with-variables.md)」を参照してください。

## ワークフロートリガー
<a name="workflows-concepts-triggers"></a>

*ワークフロートリガー* (または単に*トリガー*) を使用すると、コードプッシュなどの特定のイベントが発生したときにワークフロー実行を自動的に開始できます。ソフトウェアデベロッパーが CodeCatalyst コンソールを使用してワークフロー実行を手動で開始する必要がないようにトリガーを構成することもできます。

次の 3 種類のトリガーを使用できます。
+ **プッシュ** – コードプッシュトリガーにより、コミットがプッシュされるたびにワークフロー実行が開始されます。
+ **プルリクエスト** – プルリクエストトリガーにより、プルリクエストが作成、改訂、またはクローズされるたびにワークフロー実行が開始されます。
+ **スケジュール** – スケジュールトリガーにより、定義したスケジュールに沿ってワークフロー実行が開始されます。スケジュールトリガーを使用してソフトウェアのビルドを毎晩実行し、ソフトウェアデベロッパーが翌日の朝に最新ビルドで作業できるようにすることを検討してください。

プッシュ、プルリクエスト、スケジュールの各トリガーは単独で使用することも、同じワークフロー内で組み合わせて使用することもできます。

トリガーは必須ではありません。トリガーを構成しない場合はワークフローを手動で開始する必要があります。

トリガーについての詳細は、「[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)」を参照してください。