Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ワークフローを使用したビルド
[[CodeCatalyst ワークフロー]](workflow.md) を使用すると、アプリケーションやその他のリソースをビルドできます。
**Topics**
+ [アプリケーションをビルドする方法](#build-how-to)
+ [ビルドアクションの利点](#build-benefits)
+ [ビルドアクションの代替方法](#build-alternatives)
+ [ビルドアクションの追加](build-add-action.md)
+ [ビルドアクションの結果の表示](build-view-results.md)
+ [チュートリアル: Amazon S3 にアーティファクトをアップロードする](build-deploy.md)
+ [ビルドおよびテストアクション YAML](build-action-ref.md)
## アプリケーションをビルドする方法
CodeCatalyst でアプリケーションまたはリソースをビルドするには、まずワークフローを作成し、その中にビルドアクションを指定します。
*ビルドアクション*は、ソースコードのコンパイル、ユニットテストの実行、すぐにデプロイできるアーティファクトの生成を行うビルディングブロックです。
CodeCatalyst コンソールのビジュアルエディタまたは YAML エディタを使用して、ワークフローにビルドアクションを追加します。
アプリケーションまたはリソースをビルドするための大まかなステップは次のとおりです。
**アプリケーションをビルドするには (概要レベルのタスク)**
1. CodeCatalyst では、ビルドするアプリケーションの**ソースコードを追加します**。詳細については、「[CodeCatalyst のプロジェクト用リポジトリにソースコードを保存する](source-repositories.md)」を参照してください。
1. CodeCatalyst では、**ワークフローを作成します**。ワークフローでは、アプリケーションをビルド、テスト、デプロイする方法を定義します。詳細については、「[初めてのワークフロー](workflows-getting-started.md)」を参照してください。
1. (オプション) ワークフローで、ワークフローを自動的に開始するイベントを示す**リガーを追加します**。詳細については、[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)を参照してください。
1. ワークフローでは、アプリケーションまたはリソースソースコードをコンパイルしてパッケージ化する**ビルドアクション**を追加します。これらの目的でテストまたはデプロイアクションを使用しない場合は、ビルドアクションの実行ユニットテスト、レポートの生成、アプリケーションのデプロイを任意で行うこともできます。テストとデプロイアクションの詳細については、「[ビルドアクションの追加](build-add-action.md)」を参照してください。
1. (オプション) ワークフローで、**テストアクション**と**デプロイアクション**を追加し、アプリケーションまたはリソースをテストおよびデプロイします。Amazon ECS など、さまざまなターゲットにアプリケーションをデプロイするための事前設定されたアクションを複数選択できます。詳細については「[ワークフローを使用したテストワークフローを使用したテスト](test-workflow-actions.md)」および「[ワークフローを使用したデプロイワークフローを使用したデプロイ](deploy.md)」を参照してください。
1. **ワークフローの開始**は、手動で行うか、トリガーを介して自動で行います。ワークフローは、ビルド、テスト、デプロイアクションを順番に実行して、アプリケーションとリソースをターゲットにビルド、テスト、デプロイします。詳細については、「[手動でのワークフロー実行の開始](workflows-manually-start.md)」を参照してください。
## ビルドアクションの利点
ワークフロー内でビルドアクションを使用すると、次の利点があります。
+ **完全マネージド型** – ビルドアクションにより、独自のビルドサーバーをセットアップ、パッチ適用、更新、管理する必要がなくなります。
+ **オンデマンド** – ビルドアクション が、ビルドのニーズに合わせてオンデマンドでスケーリングします。料金は、使用したビルド分数に対してのみ発生します。詳細については、「[コンピューティングイメージとランタイムイメージの構成](workflows-working-compute.md)」を参照してください。
+ **設定不要** – CodeCatalyst には、ビルドアクションを含むすべてのワークフローアクションを実行するために使用される、事前にパッケージ化されたランタイム環境の Docker イメージが含まれています。これらのイメージには、 AWS CLI や Node.js などのアプリケーションを構築するための便利なツールが事前設定されています。CodeCatalyst は、パブリックまたはプライベートレジストリから指定したビルドイメージを使用するように設定できます。詳細については、「[ランタイム環境イメージの指定](build-images.md)」を参照してください。
## ビルドアクションの代替方法
ビルドアクションを使用してアプリケーションをデプロイする場合は、代わりに CodeCatalyst *デプロイアクション*の使用を検討してください。デプロイアクションは、ビルドアクションを使用している場合に手動で書き込む必要があるバックグラウンド設定を実行します。使用可能なデプロイアクションの詳細については、「[デプロイアクションの一覧](deploy.md#deploy-concepts-action-supported)」を参照してください。
AWS CodeBuild を使用してアプリケーションを構築することもできます。詳細については、「[What is CodeBuild?](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html)」を参照してください。
# ビルドアクションの追加
CodeCatalyst ワークフローにビルドアクションを追加するには、次の手順に従います。
------
#### [ Visual ]
**ビジュアルエディタを使用してビルドアクションを追加するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。
1. **[編集]** を選択します。
1. **[ビジュアル]** を選択します。
1. **[アクション]** を選択します。
1. **[アクション]** で **[ビルド]** を選択します。
1. **[入力]** タブと **[設定]** タブで、必要に応じてフィールドに入力します。各フィールドの説明については、「[ビルドおよびテストアクション YAML](build-action-ref.md)」を参照してください。このリファレンスでは、YAML エディタとビジュアルエディタの両方に表示される各フィールド (および対応する YAML プロパティ値) に関する詳細情報を提供しています。
1. (オプション) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。
1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。
------
#### [ YAML ]
**YAML エディタを使用してビルドアクションを追加するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。
1. **[編集]** を選択します。
1. **[YAML]** を選択します。
1. **[アクション]** を選択します。
1. **[アクション]** で **[ビルド]** を選択します。
1. 必要に応じて、YAML コードのプロパティを変更します。使用可能な各プロパティの説明は、「[ビルドおよびテストアクション YAML](build-action-ref.md)」に記載されています。
1. (オプション) **[検証]** を選択して、コミットする前にワークフローの YAML コードを検証します。
1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。
------
## ビルドアクションの定義
ビルドアクションは、ワークフロー定義ファイル内の一連の YAML プロパティとして定義されます。これらのプロパティの詳細については、「[ワークフロー YAML 定義](workflow-reference.md)」の「[ビルドおよびテストアクション YAML](build-action-ref.md)」を参照してください。
# ビルドアクションの結果の表示
生成されたログ、レポート、変数など、ビルドアクションの結果を表示するには、以下の手順に従います。
**ビルドアクションの結果を表示する方法**
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。
1. ワークフロー図で、ビルドアクションの名前を選択します。例えば、**[ビルド] ** です。
1. ビルド実行のログを表示するには、**[ログ]** を選択します。さまざまなビルドフェーズのログが表示されます。必要に応じてログを展開または折りたたむことができます。
1. ビルドアクションによって生成されたテストレポートを表示するには、**[レポート]** を選択するか、ナビゲーションペインで **[レポート]** を選択します。詳細については、「[品質レポートのタイプ](test-workflow-actions.md#test-reporting)」を参照してください。
1. ビルドアクションに使用する設定の詳細を表示するには、**[設定]** タブを選択します。詳細については、「[ビルドアクションの追加](build-add-action.md)」を参照してください。
1. ビルドアクションで使用される変数を表示するには、**[変数]** を選択します。詳細については、「[ワークフローでの変数の使用](workflows-working-with-variables.md)」を参照してください。
# チュートリアル: Amazon S3 にアーティファクトをアップロードする
このチュートリアルでは、いくつかの [[ビルドアクション]](workflows-concepts.md#workflows-concepts-actions) を含む Amazon CodeCatalyst [ワークフロー](workflows-concepts.md#workflows-concepts-workflows)を使用して、Amazon S3 バケットにアーティファクトをアップロードする方法について説明します。これらのアクションは、ワークフローの開始時に連続して実行されます。最初のビルドアクションは、`Hello.txt` と `Goodbye.txt` の 2 つのファイルを生成し、それらをビルドアーティファクトにバンドルします。2 番目のビルドアクションは、アーティファクトを Amazon S3 にアップロードします。コミットをソースリポジトリにプッシュするたびに実行されるようにワークフローを設定します。
**Topics**
+ [前提条件](#build-deploy-tut-prereqs)
+ [ステップ 1: AWS ロールを作成する](#build-deploy-tut-role)
+ [ステップ 1: Amazon S3 バケットを作成する](#build-deploy-tut-artifact)
+ [ステップ 3: ソースレポジトリを作成する](#deploy-tut-lambda-cfn-source)
+ [ステップ 4: ワークフローを作成する](#build-deploy-tut-workflow.title)
+ [ステップ 5: 結果の検証](#build-deploy.s3.verify)
+ [クリーンアップ](#deploy-tut-lambda-cfn-clean-up)
## 前提条件
開始するには、以下が必要です。
+ 接続された AWS アカウントを持つ CodeCatalyst **スペース** が必要です。詳細については、「[スペースを作成する](spaces-create.md)」を参照してください。
+ スペースには、次の名前の空のプロジェクトが必要です。
```
codecatalyst-artifact-project
```
このプロジェクトを作成するには、**[ゼロから開始]** オプションを使用します。
詳細については、「[Amazon CodeCatalyst での空のプロジェクトの作成](projects-create.md#projects-create-empty)」を参照してください。
+ プロジェクトには、以下と呼ばれる CodeCatalyst **[環境]** が必要です。
```
codecatalyst-artifact-environment
```
この環境を次のように設定します。
+ **[開発]** などの任意のタイプを選択します。
+ AWS アカウントに を接続します。
+ **[デフォルトの IAM ロール]** で、任意のロールを選択します。後で別のロールを指定します。
詳細については、「[AWS アカウント と VPCs へのデプロイ](deploy-environments.md)」を参照してください。
## ステップ 1: AWS ロールを作成する
このステップでは、後でワークフローのビルドアクションに割り当てる IAM AWS ロールを作成します。このロールは、CodeCatalyst ビルドアクションに、 AWS アカウントにアクセスしてアーティファクトが保存される Amazon S3 に書き込むアクセス許可を付与します。ロールは、**[ビルドロール]** と呼ばれます。
**注記**
別のチュートリアル用に作成したビルドロールが既にある場合は、このチュートリアルでも使用できます。以下の手順で示されているアクセス許可と信頼ポリシーがあることを確認してください。
IAM ロールの詳細については、「 *AWS AWS Identity and Access Management ユーザーガイド*」の[「IAM ロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)」を参照してください。
**ビルドロールを作成するには**
1. ロールのポリシーを以下の手順で作成します。
1. にサインインします AWS。
1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。
1. ナビゲーションペインで、**ポリシー** を選択してください。
1. **[Create policy]** (ポリシーを作成) を選択します。
1. **JSON** タブを選択します。
1. 既存のコードを削除します。
1. 次のコードを貼り付けます。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:ListBucket"
],
"Resource": "*"
}
]
}
```
------
**注記**
ロールがワークフローアクションの実行に初めて使用されるときは、リソースポリシーステートメントでワイルドカードを使用し、利用可能になった後にリソース名でポリシーの範囲を絞り込みます。
```
"Resource": "*"
```
1. [**Next: Tags (次へ: タグ)**] を選択します。
1. **[次へ: レビュー]** を選択します。
1. **[名前]** に次のように入力します。
```
codecatalyst-s3-build-policy
```
1. [**Create policy**] (ポリシーの作成) を選択します。
これで、アクセス許可ポリシーが作成されました。
1. 次のようにビルドロールを作成します。
1. ナビゲーションペインで **ロール** を選択してから、**ロールを作成する** を選択します。
1. **[カスタム信頼ポリシー]** を選択します。
1. 既存のカスタム信頼ポリシーを削除します。
1. 次の信頼ポリシーを追加します。
1. [**次へ**] を選択します。
1. **[アクセス許可ポリシー]** で `codecatalyst-s3-build-policy` を検索し、チェックボックスをオンにします。
1. [**次へ**] を選択します。
1. **[ロール名]** には、次のように入力します。
```
codecatalyst-s3-build-role
```
1. **[ロールの説明]** には、次のように入力します。
```
CodeCatalyst build role
```
1. [**ロールの作成**] を選択してください。
これで、信頼ポリシーとアクセス許可ポリシーを使用してビルドロールが作成されました。
## ステップ 1: Amazon S3 バケットを作成する
このステップでは、`Hello.txt` および `Goodbye.txt` アーティファクトをアップロードする Amazon S3 バケットを作成します。
**Amazon S3 バケットを作成するには**
1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。
1. メインペインで、**[バケットを作成]** を選択します。
1. **[バケット名]** に、次のように入力します。
```
codecatalyst-artifact-bucket
```
1. **[AWS リージョン]** で、リージョンを選択します。このチュートリアルは、**[米国西部 (オレゴン) us-west-2]** を選択していることを前提としています。Amazon S3 がサポートしているリージョンについては、「*AWS 全般のリファレンス*」の「[Amazon Simple Storage Service エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/s3.html)」を参照してください。
1. ページ下部にある **[バケットを作成]** ボタンを選択します。
1. 作成したバケットの名前をコピーします。例:
```
codecatalyst-artifact-bucket
```
これで、米国西部 (オレゴン) us-west-2 リージョンで **codecatalyst-artifact-bucket** という名前のバケットが作成されました。
## ステップ 3: ソースレポジトリを作成する
このステップでは、CodeCatalyst に空のソースリポジトリを作成します。このリポジトリは、チュートリアルのワークフロー定義ファイルを保存するために使用されます。
ソースリポジトリの詳細については、「[ソースリポジトリを作成する](source-repositories-create.md)」を参照してください。
**ソースリポジトリを作成するには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. プロジェクト「`codecatalyst-artifact-project`」に移動します。
1. ナビゲーションペインで **[コード]** を選択してから、**[ソースリポジトリ]** を選択します。
1. **[リポジトリの追加]** を選択し、**[リポジトリの作成]** を選択します。
1. **[リポジトリ名]** に次のように入力します。
```
codecatalyst-artifact-source-repository
```
1. **[作成]** を選択します。
これで、`codecatalyst-artifact-source-repository` というリポジトリが作成されました。
## ステップ 4: ワークフローを作成する
このステップでは、連続して実行される次の構成要素で構成されるワークフローを作成します。
+ トリガー – このトリガーは、ソースリポジトリに変更をプッシュすると、ワークフローを自動的に開始します。詳細については、「[トリガーを使用したワークフロー実行の自動的な開始](workflows-add-trigger.md)」を参照してください。
+ ビルドアクション「`GenerateFiles`」 - トリガー時に、`GenerateFiles` アクションは 2 つのファイル「`Hello.txt`」と「`Goodbye.txt`」を作成し、出力アーティファクト「`codecatalystArtifact`」にパッケージ化します。
+ 別のビルドアクション「`Upload`」- `GenerateFiles` アクションが完了すると、`Upload` アクションは AWS CLI コマンド `aws s3 sync` を実行して、`codecatalystArtifact` とソースリポジトリ内のファイルを Amazon S3 バケットにアップロードします。 AWS CLI は CodeCatalyst コンピューティングプラットフォームにプリインストールおよび事前設定されているため、インストールまたは設定する必要はありません。
CodeCatalyst コンピューティングプラットフォームでパッケージ化されたソフトウェアの詳細については、「[ランタイム環境イメージの指定](build-images.md)」を参照してください。コマンドの詳細については、`aws s3 sync`「 コマンド*AWS CLI リファレンス*」の AWS CLI[「同期](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html)」を参照してください。
ビルドアクションの詳細については、「[ワークフローを使用したビルド](build-workflow-actions.md)」を参照してください。
**ワークフローを作成するには**
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. **[ワークフローを作成]** を選択します。
1. YAML サンプルコードを削除します。
1. 次の YAML コードを追加します。
**注記**
次の YAML コードでは、必要に応じて `Connections:` セクションを省略できます。このセクションを省略する場合は、環境の **[デフォルト IAM ロール]** フィールドで指定されたロールに、[ステップ 1: AWS ロールを作成する](#build-deploy-tut-role) で記述されているアクセス許可と信頼ポリシーが含まれていることを確認する必要があります。デフォルトの IAM ロールを使用して環境を設定する方法の詳細については、「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。
```
Name: codecatalyst-artifact-workflow
SchemaVersion: 1.0
Triggers:
- Type: Push
Branches:
- main
Actions:
GenerateFiles:
Identifier: aws/build@v1
Configuration:
Steps:
# Create the output files.
- Run: echo "Hello, World!" > "Hello.txt"
- Run: echo "Goodbye!" > "Goodbye.txt"
Outputs:
Artifacts:
- Name: codecatalystArtifact
Files:
- "**/*"
Upload:
Identifier: aws/build@v1
DependsOn:
- GenerateFiles
Environment:
Name: codecatalyst-artifact-environment
Connections:
- Name: codecatalyst-account-connection
Role: codecatalyst-s3-build-role
Inputs:
Artifacts:
- codecatalystArtifact
Configuration:
Steps:
# Upload the output artifact to the S3 bucket.
- Run: aws s3 sync . s3://codecatalyst-artifact-bucket
```
上記のコードで、以下を置き換えます。
+ [[前提条件](#build-deploy-tut-prereqs)] で作成した環境の名前を持つ *[codecatalyst-artifact-environment]*。
+ [前提条件](#build-deploy-tut-prereqs) で作成したアカウント接続の名前を持つ *[codecatalyst-account-connection]*。
+ [ステップ 1: AWS ロールを作成する](#build-deploy-tut-role) で作成したビルドロールの名前を持つ、*[codecatalyst-s3-build-role]*。
+ [ステップ 1: Amazon S3 バケットを作成する](#build-deploy-tut-artifact) で作成した Amazon S3 の名前を持つ *[codecatalyst-artifact-bucket]*。
このファイルのプロパティの詳細については、「[ビルドおよびテストアクション YAML](build-action-ref.md)」を参照してください。
1. (任意) **[検証]** を選択して、コミットする前に YAML コードが有効であることを確認します。
1. **[コミット]** を選択します。
1. **[ワークフローをコミット]** ダイアログボックスで、次のように入力します。
1. **[ワークフローファイル名]** の場合、デフォルトの「`codecatalyst-artifact-workflow`」のままにします。
1. **[コミットメッセージ]** には、次のように入力します。
```
add initial workflow file
```
1. **[リポジトリ]** で、**[codecatalyst-artifact-source-repository]** を選択します。
1. **[ブランチ名]** で、**[main]** を選択します。
1. **[コミット]** を選択します。
これでワークフローが作成されました。ワークフローの先頭で定義されているトリガーにより、ワークフローの実行が自動的に開始されます。具体的には、`codecatalyst-artifact-workflow.yaml` ファイルをソースリポジトリにコミット (およびプッシュ) すると、トリガーによってワークフローの実行が開始します。
**ワークフロー実行の進行状況を確認するには**
1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。
1. 先ほど作成したワークフロー「`codecatalyst-artifact-workflow`」を選択します。
1. **[GenerateFiles]** を選択すると、最初のビルドアクションの進行状況が表示されます。
1. **[アップロード]** を選択して、2 番目のビルドアクションの進行状況を確認します。
1. **[アップロード]** アクションが完了したら、以下を実行します。
+ ワークフローの実行が成功したら、次の手順に進みます。
+ ワークフローの実行が失敗した場合は、**[ログ]** を選択して問題をトラブルシューティングします。
## ステップ 5: 結果の検証
ワークフローを実行したら、Amazon S3 サービスに移動し、*[codecatalyst-artifact-bucket]* バケットを確認します。これで、次のファイルとフォルダが含まれるようになりました。
```
.
|— .aws/
|— .git/
|Goodbye.txt
|Hello.txt
|REAME.md
```
`Goodbye.txt` および `Hello.txt` ファイルは、`codecatalystArtifact` アーティファクトの一部であったため、アップロードされました。`.aws/`、`.git/`、`README.md` ファイルはソースリポジトリにあったため、アップロードされました。
## クリーンアップ
CodeCatalyst および でクリーンアップ AWS して、これらのサービスに対して課金されないようにします。
**CodeCatalyst でクリーンアップするには**
1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。
1. `codecatalyst-artifact-source-repository` ソースリポジトリを削除します。
1. `codecatalyst-artifact-workflow` ワークフローを選択します。
**でクリーンアップするには AWS**
1. Amazon S3 で次のようにクリーンアップします。
1. Amazon S3 コンソール ([https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)) を開きます。
1. `codecatalyst-artifact-bucket` バケットのファイルを削除します。
1. `codecatalyst-artifact-bucket` バケットを削除します。
1. IAM で次のようにクリーンアップします。
1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。
1. `codecatalyst-s3-build-policy` を削除します。
1. `codecatalyst-s3-build-role` を削除します。
# ビルドおよびテストアクション YAML
以下は、ビルドアクションとテストアクションの YAML 定義です。YAML プロパティはとても似通っているため、2 つのアクションには 1 つのリファレンスがあります。
このアクション定義は、より広範なワークフロー定義ファイル内のセクションとして存在します。ファイルの詳細については、「[ワークフロー YAML 定義](workflow-reference.md)」を参照してください。
次のコード内で YAML プロパティを選択すると、説明が表示されます。
**注記**
後続の YAML プロパティのほとんどには、対応する UI 要素がビジュアルエディタにあります。UI 要素を検索するには、**[Ctrl\$1F]** を使用します。要素は、関連付けられた YAML プロパティと共に一覧表示されます。
```
# The workflow definition starts here.
# See 最上位プロパティ for details.
Name: MyWorkflow
SchemaVersion: 1.0
Actions:
# The action definition starts here.
action-name:
Identifier: aws/build@v1 | aws/managed-test@v1
DependsOn:
- dependent-action-name-1
Compute:
Type: EC2 | Lambda
Fleet: fleet-name
Timeout: timeout-minutes
Environment:
Name: environment-name
Connections:
- Name: account-connection-name
Role: iam-role-name
Caching:
FileCaching:
key-name-1:
Path: file1.txt
RestoreKeys:
- restore-key-1
Inputs:
Sources:
- source-name-1
- source-name-2
Artifacts:
- artifact-name
Variables:
- Name: variable-name-1
Value: variable-value-1
- Name: variable-name-2
Value: variable-value-2
Outputs:
Artifacts:
- Name: output-artifact-1
Files:
- build-output/artifact-1.jar
- "build-output/build*"
- Name: output-artifact-2
Files:
- build-output/artifact-2.1.jar
- build-output/artifact-2.2.jar
Variables:
- variable-name-1
- variable-name-2
AutoDiscoverReports:
Enabled: true | false
ReportNamePrefix: AutoDiscovered
IncludePaths:
- "**/*"
ExcludePaths:
- node_modules/cdk/junit.xml
SuccessCriteria:
PassRate: percent
LineCoverage: percent
BranchCoverage: percent
Vulnerabilities:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisBug:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisSecurity:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisQuality:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisFinding:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
Reports:
report-name-1:
Format: format
IncludePaths:
- "*.xml"
ExcludePaths:
- report2.xml
- report3.xml
SuccessCriteria:
PassRate: percent
LineCoverage: percent
BranchCoverage: percent
Vulnerabilities:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisBug:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisSecurity:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisQuality:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
StaticAnalysisFinding:
Severity: CRITICAL | HIGH | MEDIUM | LOW | INFORMATIONAL
Number: whole-number
Configuration:
Container:
Registry: registry
Image: image
Steps:
- Run: "step 1"
- Run: "step 2"
Packages:
NpmConfiguration:
PackageRegistries:
- PackagesRepository: package-repository
Scopes:
- "@scope"
ExportAuthorizationToken: true | false
```
## action-name
(必須)
アクションの名前を指定します。すべてのアクション名は、ワークフロー内で一意である必要があります。アクション名で使用できるのは、英数字 (a～z、A～Z、0～9)、ハイフン (-)、アンダースコア (\$1) のみです。スペースは使用できません。引用符を使用して、アクション名の特殊文字とスペースを有効にすることはできません。
対応する UI: [設定] タブ/**[アクション名]**
## Identifier
(*action-name*/**Identifier**)
アクションを識別します。バージョンを変更したい場合でない限り、このプロパティを変更しないでください。詳細については、「[使用するアクションバージョンの指定](workflows-action-versions.md)」を参照してください。
ビルドアクションに `aws/build@v1` を使用します。
テストアクションに `aws/managed-test@v1` を使用します。
対応する UI: ワークフロー図/Action-name/*aws/build@v1\$1aws/managed-test@v1* ラベル
## DependsOn
(*action-name*/**DependsOn**)
(オプション)
このアクションを実行するために正常に実行する必要があるアクション、アクショングループ、またはゲートを指定します。
「DependsOn」機能の詳細については、「[アクションの順序付け](workflows-depends-on.md)」を参照してください。
対応する UI: [入力] タブ/**[依存 - オプション]**
## Compute
(*action-name*/**Compute**)
(オプション)
ワークフローアクションの実行に使用されるコンピューティングエンジンです。コンピューティングはワークフローレベルまたはアクションレベルで指定できますが、両方を指定することはできません。ワークフローレベルで指定すると、コンピューティング設定はワークフローで定義されたすべてのアクションに適用されます。ワークフローレベルでは、同じインスタンスで複数のアクションを実行することもできます。詳細については、「[アクション間でのコンピューティングの共有する](compute-sharing.md)」を参照してください。
対応する UI: *なし*
## Type
(*action-name*/Compute/**Type**)
([Compute](#build.computename) が含まれている場合は必須)
コンピューティングエンジンのタイプです。次のいずれかの値を使用できます。
+ **EC2** (ビジュアルエディタ) または `EC2` (YAML エディタ)
アクション実行時の柔軟性を目的として最適化されています。
+ **Lambda** (ビジュアルエディタ) または `Lambda` (YAML エディタ)
アクションの起動速度を最適化しました。
コンピューティングタイプの詳細については、「[コンピューティングタイプ](workflows-working-compute.md#compute.types)」を参照してください。
対応する UI: [設定] タブ/**[コンピューティングタイプ]**
## Fleet
(*action-name*/Compute/**Fleet**)
(オプション)
ワークフローまたはワークフローアクションを実行するマシンまたはフリートを指定します。オンデマンドフリートでは、アクションが開始すると、ワークフローは必要なリソースをプロビジョニングし、アクションが完了するとマシンは破棄されます。オンデマンドフリートの例: `Linux.x86-64.Large`、`Linux.x86-64.XLarge`。オンデマンドフリートの詳細については、「[オンデマンドフリートのプロパティ](workflows-working-compute.md#compute.on-demand)」を参照してください。
プロビジョニングされたフリートでは、ワークフローアクションを実行するように専用マシンのセットを設定します。これらのマシンはアイドル状態のままで、アクションをすぐに処理できます。プロビジョニングされたフリートの詳細については、「[プロビジョニングされたフリートのプロパティ](workflows-working-compute.md#compute.provisioned-fleets)」を参照してください。
`Fleet` を省略した場合、デフォルトは `Linux.x86-64.Large` です。
対応する UI: [設定] タブ/**[コンピューティングフリート]**
## Timeout
(*action-name*/**Timeout**)
(オプション)
CodeCatalyst がアクションを終了するまでにアクションを実行できる時間を分単位 (YAML エディタ) または時間分単位 (ビジュアルエディタ) で指定します。最小値は 5 分で、最大値は [CodeCatalyst のワークフローのクォータ](workflows-quotas.md) で記述されています。デフォルトのタイムアウトは、最大タイムアウトと同じです。
対応する UI: [設定] タブ/**[タイムアウト - オプション]**
## Environment
(*action-name*/**Environment**)
(オプション)
アクションで使用する CodeCatalyst 環境を指定します。アクションは、選択した環境で指定された AWS アカウント およびオプションの Amazon VPC に接続します。アクションは、環境で指定されたデフォルトの IAM ロールを使用して に接続し AWS アカウント、[Amazon VPC 接続](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html)で指定された IAM ロールを使用して Amazon VPC に接続します。
**注記**
デフォルトの IAM ロールにアクションに必要なアクセス許可がない場合は、別のロールを使用するようにアクションを設定できます。詳細については、「[アクションの IAM ロールの変更](deploy-environments-switch-role.md)」を参照してください。
環境タグ付けの詳細については、「[AWS アカウント と VPCs へのデプロイ](deploy-environments.md)」と「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。
対応する UI: [設定] タブ/**[環境]**
## Name
(*action-name*/Environment/**Name**)
(オプション)
アクションに関連付ける既存の環境の名前を指定します。
対応する UI: [設定] タブ/**[環境]**
## Connections
(*action-name*/Environment/**Connections**)
(オプション)
アクションに関連付けるアカウント接続を指定します。`Environment` で最大 1 つのアカウント接続を指定できます。
アカウント接続を指定しない場合:
+ アクションは、CodeCatalyst コンソールの環境で指定された AWS アカウント 接続とデフォルトの IAM ロールを使用します。アカウント接続とデフォルトの IAM ロールを環境に追加する方法については、「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。
+ デフォルトの IAM ロールには、アクションに必要なポリシーとアクセス許可が含まれている必要があります。これらのポリシーとアクセス許可を確認するには、アクションの YAML 定義ドキュメントの **[ロール]** プロパティの説明を参照してください。
アカウント接続の詳細については、「[接続された AWS リソースへのアクセスを許可する AWS アカウント](ipa-connect-account.md)」を参照してください。アカウント接続を環境に追加する方法については、「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。
対応する UI: [設定] タブ/[環境]/[*my-environment* の内容]/3 つのドットメニュー/**[ロールを切り替える]**
## Name
(*action-name*/Environment/Connections/**Name**)
([Connections](#build.environment.connections) が含まれている場合は必須)
アカウント接続の名前を指定します。
対応する UI: [設定] タブ/[環境]/[*my-environment* の内容]/3 つのドットメニュー/**[ロールを切り替える]**
## Role
(*action-name*/Environment/Connections/**Role**)
([Connections](#build.environment.connections) が含まれている場合は必須)
Amazon S3 や Amazon ECR などの AWS のサービスにアクセスして操作するために、このアクションが使用する IAM ロールの名前を指定します。このロールがスペースの AWS アカウント 接続に追加されていることを確認します。アカウント接続に IAM ロールを追加するには、「[IAM ロールをアカウント接続に追加する](ipa-connect-account-addroles.md)」を参照してください。
IAM ロールを指定しない場合、アクションは CodeCatalyst コンソールの [[環境]](deploy-environments.md) に記載されているデフォルトの IAM ロールを使用します。環境でデフォルトのロールを使用する場合は、次のポリシーが設定されていることを確認してください。
**注記**
このアクションでは、`CodeCatalystWorkflowDevelopmentRole-spaceName` ロールを使用できます。このロールの詳細については、「[アカウントとスペース用の **CodeCatalystWorkflowDevelopmentRole-*spaceName*** ロールを作成する](ipa-iam-roles.md#ipa-iam-roles-service-create)」を参照してください。`CodeCatalystWorkflowDevelopmentRole-spaceName` ロールにはフルアクセス許可があり、セキュリティ上のリスクをもたらす可能性があることを理解してください。このロールは、セキュリティが懸念されないチュートリアルやシナリオでのみ使用することをお勧めします。
**警告**
アクセス許可は、ビルドアクションとテストアクションに必要なアクセス許可に制限します。より広範なアクセス許可を持つロールを使用すると、セキュリティリスクが発生する可能性があります。
対応する UI: [設定] タブ/[環境]/[*my-environment* の内容]/3 つのドットメニュー/**[ロールを切り替える]**
## Caching
(*action-name*/**Caching**)
(オプション)
キャッシュを指定してディスク上のファイルを保存し、後続のワークフロー実行でそのキャッシュから復元できるセクションです。
ファイルキャッシングの詳細については、「[ワークフロー実行間のファイルのキャッシュ](workflows-caching.md)」を参照してください。
対応する UI: [設定] タブ/**[ファイルキャッシュ - オプション]**
## FileCaching
(*action-name*/Caching/**FileCaching**)
(オプション)
一連のキャッシュの設定を指定するセクションです。
対応する UI: [設定] タブ/[ファイルキャッシュ - オプション]/**[キャッシュを追加]**
## key-name-1
(*action-name*/Caching/FileCaching/***key-name-1***)
(オプション)
プライマリキャッシュプロパティ名の名前を指定します。キャッシュプロパティ名は、ワークフロー内で一意である必要があります。各アクションには、`FileCaching` に最大 5 つのエントリを含めることができます。
対応する UI: [設定] タブ/[ファイルキャッシュ - オプション]/[キャッシュを追加]/**[キー]**
## Path
(*action-name*/Caching/FileCaching/*key-name-1*/**Path**)
(オプション)
キャッシュの関連するパスを指定します。
対応する UI: [設定] タブ/[ファイルキャッシュ - オプション]/[キャッシュを追加]/**[パス]**
## RestoreKeys
(*action-name*/Caching/FileCaching/*key-name-1*/**RestoreKeys**)
(オプション)
プライマリキャッシュプロパティが見つからない場合にフォールバックとして使用する復元キーを指定します。復元キー名は、ワークフロー内で一意である必要があります。各キャッシュには、`RestoreKeys` に最大 5 つのエントリを含めることができます。
対応する UI: [設定] タブ/[ファイルキャッシュ - オプション]/[キャッシュを追加]/**[キーの復元 - オプション]**
## Inputs
(*action-name*/**Inputs**)
(オプション)
`Inputs` セクションでは、ワークフローの実行中にアクションに必要なデータ定義します。
**注記**
ビルドアクションまたはテストアクションごとに最大 4 つの入力 (1 つのソースと 3 つのアーティファクト) が許可されます。変数はこの合計にはカウントされません。
異なる入力 (ソースとアーティファクトなど) にあるファイルを参照する必要がある場合、ソース入力はプライマリ入力で、アーティファクトはセカンダリ入力になります。セカンダリ入力内のファイルへの参照には、プライマリからファイルを区別するための特別なプレフィックスが付きます。詳細については、「[例: 複数のアーティファクトでのファイルの参照](workflows-working-artifacts-ex.md#workflows-working-artifacts-ex-ref-file)」を参照してください。
対応する UI: **[入力] タブ**
## Sources
(*action-name*/Inputs/**Sources**)
(オプション)
アクションに必要なソースリポジトリを表すラベルを指定します。現在、サポートされているラベルは `WorkflowSource` のみです。これは、ワークフロー定義ファイルが保存されているソースリポジトリを表します。
ソースを省略する場合は、`action-name/Inputs/Artifacts` で少なくとも 1 つの入力アーティファクトを指定する必要があります。
sources の詳細については、「[ワークフローへのソースリポジトリの接続](workflows-sources.md)」を参照してください。
対応する UI: *なし*
## Artifacts - input
(*action-name*/Inputs/**Artifacts**)
(オプション)
このアクションへの入力として提供する以前のアクションのアーティファクトを指定します。これらのアーティファクトは、前のアクションで出力アーティファクトとして既に定義されている必要があります。
入力アーティファクトを指定しない場合は、`action-name/Inputs/Sources` で少なくとも 1 つのソースリポジトリを指定する必要があります。
アーティファクトの詳細 (例を含む) については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。
**注記**
**[アーティファクト - オプション]** のドロップダウンリストが使用できない場合 (ビジュアルエディタ)、または YAML の検証時にエラーが発生する場合 (YAML エディタ)、アクションが 1 つの入力のみをサポートしていることが原因である可能性があります。この場合はソース入力を削除してみてください。
対応する UI: [入力] タブ/**[アーティファクト - オプション]**
## Variables - input
(*action-name*/Inputs/**Variables**)
(オプション)
アクションで使用できるようにしたい入力変数を定義する名前と値のペアのシーケンスを指定します。変数名に使用できるのは、英数字 (a～z、A～Z、0～9)、ハイフン (-)、アンダースコア (\$1) のみです。スペースは使用できません。引用符を使用して、変数名で特殊文字とスペースを有効にすることはできません。
変数の詳細 (例を含む) については、「[ワークフローでの変数の使用](workflows-working-with-variables.md)」を参照してください。
対応する UI: [入力] タブ/**[変数 - オプション]**
## Outputs
(*action-name*/**Outputs**)
(オプション)
ワークフローの実行中にアクションによって出力されるデータを定義します。
対応する UI: **[出力]** タブ
## Artifacts - output
(*action-name*/Outputs/**Artifacts**)
(オプション)
アクションによって生成されるアーティファクトの名前を指定します。アーティファクト名はワークフロー内で一意でなければならず、英数字 (a～z、A～Z、0～9) とアンダースコア (\$1) しか使用できません。スペース、ハイフン (-)、その他の特殊文字は使用できません。引用符を使用して、出力アーティファクト名でスペース、ハイフン、その他の特殊文字を有効にすることはできません。
アーティファクトの詳細 (例を含む) については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。
対応する UI: [出力] タブ/**[アーティファクト]**
## Name
(*action-name*/Outputs/Artifacts/**Name**)
([Artifacts - output](#build.outputs.artifacts) が含まれている場合は必須)
アクションによって生成されるアーティファクトの名前を指定します。アーティファクト名はワークフロー内で一意でなければならず、英数字 (a～z、A～Z、0～9) とアンダースコア (\$1) しか使用できません。スペース、ハイフン (-)、その他の特殊文字は使用できません。引用符を使用して、出力アーティファクト名でスペース、ハイフン、その他の特殊文字を有効にすることはできません。
アーティファクトの詳細 (例を含む) については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。
対応する UI: [出力] タブ/[アーティファクト]/[新しい出力]/**[ビルドアーティファクト名]**
## Files
(*action-name*/Outputs/Artifacts/**Files**)
([Artifacts - output](#build.outputs.artifacts) が含まれている場合は必須)
CodeCatalyst がアクションによって出力されるアーティファクトに含めるファイルを指定します。これらのファイルは、実行時にワークフローアクションによって生成され、ソースリポジトリでも使用できます。ファイルパスは、ソースリポジトリまたは前のアクションからのアーティファクトに設定でき、ソースリポジトリまたはアーティファクトルートを基準とすることができます。glob パターンを使用してパスを指定できます。例:
+ ビルドまたはソースリポジトリの場所のルートにある 1 つのファイルを指定するには、`my-file.jar` を使用します。
+ サブディレクトリ内の 1 つのファイルを指定するには、`directory/my-file.jar` または `directory/subdirectory/my-file.jar` を使用します。
+ すべてのファイルを指定するには、`"**/*"` を使用します。glob パターン `**` は、任意の数のサブディレクトリにマッチすることを示します。
+ `directory` という名前のディレクトリ内のすべてのファイルとディレクトリを指定するには、`"directory/**/*"` を使用します。glob パターン `**` は、任意の数のサブディレクトリにマッチすることを示します。
+ `directory` という名前のディレクトリ内のすべてのファイルを指定するが、そのサブディレクトリを含めないようにするには、`"directory/*"` を使用します。
**注記**
ファイルパスに 1 つ以上のアスタリスク (`*`) またはその他の特殊文字が含まれている場合は、パスを二重引用符 (`""`) で囲みます。特殊文字の詳細については、「[構文ガイドラインと規則](workflow-reference.md#workflow.terms.syntax.conv)」を参照してください。
アーティファクトの詳細 (例を含む) については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。
**注記**
場合によっては、ファイルパスにプレフィックスを追加して、どのアーティファクトまたはソースにあるのかを示す必要があります。詳細については、「[ソースリポジトリファイルの参照](workflows-sources-reference-files.md)」および「[アーティファクト内のファイルの参照](workflows-working-artifacts-refer-files.md)」を参照してください。
対応する UI: [出力] タブ/[アーティファクト]/**[新しい出力]/[ビルドで生成されるファイル]**
## Variables - output
(*action-name*/Outputs/**Variables**)
(オプション)
後続のアクションで使用できるように、アクションがエクスポートする変数を指定します。
変数の詳細 (例を含む) については、「[ワークフローでの変数の使用](workflows-working-with-variables.md)」を参照してください。
対応する UI: [出力] タブ/[変数]/**[変数を追加]**
## variable-name-1
(*action-name*/Outputs/Variables/*variable-name-1*)
(オプション)
アクションでエクスポートする変数の名前を指定します。この変数は、同じアクションの `Inputs` セクションか `Steps` セクションであらかじめ定義されている必要があります。
変数の詳細 (例を含む) については、「[ワークフローでの変数の使用](workflows-working-with-variables.md)」を参照してください。
対応する UI: [出力] タブ/[変数]/[変数を追加]/**[名前]**
## AutoDiscoverReports
(*action-name*/Outputs/**AutoDiscoverReports**)
(オプション)
自動検出機能の設定を定義します。
自動検出を有効にすると、CodeCatalyst はアクションに渡されたすべての `Inputs` と、アクション自体によって生成されたすべてのファイルを検索し、テストレポート、コードカバレッジレポート、ソフトウェアコンポジション分析 (SCA) レポートを探します。検出された各レポートは、CodeCatalyst レポートに変換されます。*CodeCatalyst レポート*は、CodeCatalyst サービスに完全に統合されており、CodeCatalyst コンソールを介して表示および操作できます。
**注記**
デフォルトでは、自動検出機能はすべてのファイルを検査します。[IncludePaths](#build.reports.includepaths) または [ExcludePaths](#build.reports.excludepaths) プロパティを使用して、検査するファイルを制限できます。
対応する UI: [出力] タブ/[レポート]/**[自動検出レポート]**
## Enabled
(*action-name*/Outputs/AutoDiscoverReports/**Enabled**)
(オプション)
自動検出機能を有効または無効にします。
有効な値は `true` または `false` です。
`Enabled` を省略した場合、デフォルトは `true` です。
対応する UI: [出力] タブ/[レポート]/**[自動検出レポート]**
## ReportNamePrefix
(*action-name*/Outputs/AutoDiscoverReports/**ReportNamePrefix**)
([AutoDiscoverReports](#build.outputs.autodiscover) が含まれ、有効になっている場合は必須)
関連する CodeCatalyst レポートに名前を付けるために、CodeCatalyst が検出したすべてのレポートに付加するプレフィックスを指定します。例えば、プレフィックスを `AutoDiscovered` に指定し、CodeCatalyst が 2 つのテストレポート、`TestSuiteOne.xml`、`TestSuiteTwo.xml` を自動的に検出する場合、関連する CodeCatalyst レポートには `AutoDiscoveredTestSuiteOne` と `AutoDiscoveredTestSuiteTwo` という名前が付けられます。
対応する UI: [出力] タブ/[レポート]/**[プレフィックス名]**
## IncludePaths
(*action-name*/Outputs/AutoDiscoverReports/**IncludePaths**)
または
(*action-name*/Outputs/Reports/*report-name-1*/**IncludePaths**)
([AutoDiscoverReports](#build.outputs.autodiscover) が含まれ、有効になっている場合、または [Reports](#test.configuration.reports) が含まれている場合は必須)
CodeCatalyst が未加工レポートを検索するときに含めるファイルとファイルパスを指定します。例えば、`"/test/report/*"` を指定すると、CodeCatalyst は `/test/report/*` ディレクトリを検索するアクションで使用される[ビルドイメージ](build-images.md)全体を検索します。そのディレクトリが見つかると、CodeCatalyst はそのディレクトリ内のレポートを検索します。
**注記**
ファイルパスに 1 つ以上のアスタリスク (`*`) またはその他の特殊文字が含まれている場合は、パスを二重引用符 (`""`) で囲みます。特殊文字の詳細については、「[構文ガイドラインと規則](workflow-reference.md#workflow.terms.syntax.conv)」を参照してください。
このプロパティを省略した場合、デフォルトは `"**/*"` です。つまり、検索にはすべてのパスのすべてのファイルが含まれます。
**注記**
手動で設定するレポートの場合、`IncludePaths` は単一のファイルに一致する glob パターンである必要があります。
対応する UI:
+ [出力] タブ/[レポート]/[レポートを自動的に検出]/[パスを含める/除外する]/**[パスを含める]**
+ [出力] タブ/[レポート]/[レポートを手動で設定]/*report-name-1*/[パスを含める/除外する]/**[パスを含める]**
## ExcludePaths
(*action-name*/Outputs/AutoDiscoverReports/**ExcludePaths**)
または
(*action-name*/Outputs/Reports/*report-name-1*/**ExcludePaths**)
(オプション)
未加工レポートを検索するときに CodeCatalyst が除外するファイルとファイルパスを指定します。例えば、`"/test/my-reports/**/*"` を指定した場合、CodeCatalyst は `/test/my-reports/` ディレクトリ内のファイルを検索しません。ディレクトリ内のすべてのファイルを無視するには、`**/*` glob パターンを使用します。
**注記**
ファイルパスに 1 つ以上のアスタリスク (`*`) またはその他の特殊文字が含まれている場合は、パスを二重引用符 (`""`) で囲みます。特殊文字の詳細については、「[構文ガイドラインと規則](workflow-reference.md#workflow.terms.syntax.conv)」を参照してください。
対応する UI:
+ [出力] タブ/[レポート]/[レポートを自動的に検出]/[パスを含める/除外する]/**[パスを除外する]**
+ [出力] タブ/[レポート]/[レポートを手動で設定]/*report-name-1*/[パスを含める/除外する]/**[パスを除外する]**
## SuccessCriteria
(*action-name*/Outputs/AutoDiscoverReports/**SuccessCriteria**)
または
(*action-name*/Outputs/Reports/*report-name-1*/**SuccessCriteria**)
(オプション)
テストレポート、コードカバレッジレポート、ソフトウェアコンポジション分析 (SCA) レポート、静的分析 (SA) レポートの成功基準を指定します。
詳細については、「[レポートの成功基準の設定](test-config-action.md#test.success-criteria)」を参照してください。
対応する UI: 出力タブ/レポート/**[成功基準]**
## PassRate
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**PassRate**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**PassRate**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるために、テストレポート内のテストに求められる合格の割合を指定します。有効な値には 10 進数が含まれます。例: `50`、`60.5`。パスレートの基準は、テストレポートにのみ適用されます。テストレポートの詳細については、「[テストレポート](test-workflow-actions.md#test-reports)」を参照してください。
対応する UI: 出力タブ/レポート/成功基準/**[合格率]**
## LineCoverage
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**LineCoverage**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**LineCoverage**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるために、コードカバレッジレポート内でカバーする必要がある行の割合を指定します。有効な値には 10 進数が含まれます。例: `50`、`60.5`。ラインカバレッジ基準は、コードカバレッジレポートにのみ適用されます。コードカバレッジレポートの詳細については、「[コードカバレッジレポート](test-workflow-actions.md#test-code-coverage-reports)」を参照してください。
対応する UI: 出力タブ/レポート/成功基準/**[ラインカバレッジ]**
## BranchCoverage
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**BranchCoverage**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**BranchCoverage**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるために、コードカバレッジレポート内でカバーする必要があるブランチの割合を指定します。有効な値には 10 進数が含まれます。例: `50`、`60.5`。ブランチカバレッジ基準は、コードカバレッジレポートにのみ適用されます。コードカバレッジレポートの詳細については、「[コードカバレッジレポート](test-workflow-actions.md#test-code-coverage-reports)」を参照してください。
対応する UI: 出力タブ/レポート/成功基準/**[ブランチカバレッジ]**
## Vulnerabilities
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**Vulnerabilities**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**Vulnerabilities**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるために、SCA レポートで許容される脆弱性の数と重要度の上限を指定します。脆弱性を指定するには、以下を指定する必要があります。
+ カウントに含める脆弱性の最小重要度。有効な値は、重要度が高い順に `CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`INFORMATIONAL` です。
例えば、`HIGH` を選択すると、`HIGH` と `CRITICAL` の脆弱性が集計されます。
+ 指定された重要度の脆弱性の最大許容数。この数を超えると、CodeCatalyst レポートは不合格としてマークされます。有効な値は整数です。
脆弱性の基準は SCA レポートにのみ適用されます。SCA レポートの詳細については、「[ソフトウェア構成分析レポート](test-workflow-actions.md#test-sca-reports)」を参照してください。
最小重要度を指定するには、`Severity` プロパティを使用します。脆弱性の最大数を指定するには、`Number` プロパティを使用します。
対応する UI: 出力タブ/レポート/成功基準/**[脆弱性]**
## StaticAnalysisBug
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisBug**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisBug**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるように、SA レポート内で許容されるバグの最大数と重要度を指定します。バグを指定するには、以下を指定する必要があります。
+ カウントするバグの最小重要度。有効な値は、重要度が高い順に、`CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`INFORMATIONAL` です。
例えば、`HIGH` を選択すると、`HIGH` と `CRITICAL` のバグが集計されます。
+ 指定された重要度のバグの最大許容数。この数を超えると、CodeCatalyst レポートは失敗としてマークされます。有効な値は整数です。
バグ基準は、PyLint SA レポートおよび ESLint SA レポートにのみ適用されます。SA レポートの詳細については、「[静的分析レポート](test-workflow-actions.md#test-static-analysis-reports)」を参照してください。
最小重要度を指定するには、`Severity` プロパティを使用します。脆弱性の最大数を指定するには、`Number` プロパティを使用します。
対応する UI: [出力] タブ/[レポート]/[成功基準]/**[バグ]**
## StaticAnalysisSecurity
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisSecurity**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisSecurity**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるように、SA レポート内で許容されるセキュリティ脆弱性の最大数と重要度を指定します。セキュリティの脆弱性を指定するには、以下を指定する必要があります。
+ カウントするセキュリティ脆弱性の最小重要度。有効な値は、重要度が高い順に、`CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`INFORMATIONAL` です。
例えば、`HIGH` を選択すると、`HIGH` と `CRITICAL` のセキュリティ脆弱性が集計されます。
+ 指定された重要度のセキュリティ脆弱性の最大許容数。この数を超えると、CodeCatalyst レポートは失敗としてマークされます。有効な値は整数です。
セキュリティ脆弱性の基準は、PyLint SA レポートおよび ESLint SA レポートにのみ適用されます。SA レポートの詳細については、「[静的分析レポート](test-workflow-actions.md#test-static-analysis-reports)」を参照してください。
最小重要度を指定するには、`Severity` プロパティを使用します。脆弱性の最大数を指定するには、`Number` プロパティを使用します。
対応する UI: 出力タブ/レポート/成功基準/**[セキュリティの脆弱性]**
## StaticAnalysisQuality
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisQuality**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisQuality**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるように、SA レポート内で許容される品質問題の最大数と重要度を指定します。品質問題を指定するには、以下を指定する必要があります。
+ カウントに含める品質問題の最小重要度。有効な値は、重要度が高い順に、`CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`INFORMATIONAL` です。
例えば、`HIGH` を選択すると、`HIGH` と `CRITICAL` の品質問題が集計されます。
+ 指定された重要度の品質問題の最大許容数。この数を超えると、CodeCatalyst レポートは失敗としてマークされます。有効な値は整数です。
品質問題の基準は、PyLint SA レポートおよび ESLint SA レポートにのみ適用されます。SA レポートの詳細については、「[静的分析レポート](test-workflow-actions.md#test-static-analysis-reports)」を参照してください。
最小重要度を指定するには、`Severity` プロパティを使用します。脆弱性の最大数を指定するには、`Number` プロパティを使用します。
対応する UI: 出力タブ/レポート/成功基準/**[品質問題]**
## StaticAnalysisFinding
(*action-name*/Outputs/AutoDiscoverReports/SuccessCriteria/**StaticAnalysisFinding**)
または
(*action-name*/Outputs/Reports/*report-name-1*/SuccessCriteria/**StaticAnalysisFinding**)
(オプション)
関連する CodeCatalyst レポートが合格としてマークされるように、SA レポートで許可される検出結果の最大数と重要度を指定します。検出結果を指定するには、以下を指定する必要があります。
+ カウントに含める検出結果の最小重要度。有効な値は、重要度が高い順に、`CRITICAL`、`HIGH`、`MEDIUM`、`LOW`、`INFORMATIONAL` です。
例えば、`HIGH` を選択すると、`HIGH` と `CRITICAL` の結果が集計されます。
+ 許可する指定された重要度の検出結果の最大数。この数を超えると、CodeCatalyst レポートは失敗としてマークされます。有効な値は整数です。
検出結果は SARIF SA レポートにのみ適用されます。SA レポートの詳細については、「[静的分析レポート](test-workflow-actions.md#test-static-analysis-reports)」を参照してください。
最小重要度を指定するには、`Severity` プロパティを使用します。脆弱性の最大数を指定するには、`Number` プロパティを使用します。
対応する UI: 出力タブ/レポート/成功基準/**[検出結果]**
## Reports
(*action-name*/Outputs/**Reports** )
(オプション)
テストレポートの設定を指定するセクション。
対応する UI: [出力] タブ/**[レポート]**
## report-name-1
(*action-name*/Outputs/Reports/**report-name-1**)
([Reports](#test.configuration.reports) が含まれている場合は必須)
未加工レポートから生成される CodeCatalyst レポートに付ける名前。
対応する UI: [出力] タブ/[レポート]/[レポートを手動で設定]/**[レポート名]**
## Format
(*action-name*/Outputs/Reports/*report-name-1*/**Format**)
([Reports](#test.configuration.reports) が含まれている場合は必須)
レポートに使用するファイル形式を指定します。指定できる値は以下のとおりです。
+ テストレポートの場合:
+ Cucumber JSON には、**[Cucumber ]** (ビジュアルエディタ) または [`CUCUMBERJSON`] (YAML エディタ) を指定します。
+ JUnit XML の場合は、**[JUnit]** (ビジュアルエディタ) または [`JUNITXML`] (YAML エディタ) を指定します。
+ NUnit XML の場合は、**[NUnit]** (ビジュアルエディタ) または [`NUNITXML`] (YAML エディタ) を指定します。
+ NUnit 3 XML の場合は、**[NUnit3]** (ビジュアルエディタ) または [`NUNIT3XML`] (YAML エディタ) を指定します。
+ Visual Studio TRX の場合は、**[Visual Studio TRX]** (ビジュアルエディタ) または [`VISUALSTUDIOTRX`] (YAML エディタ) を指定します。
+ TestNG XML の場合は、**[TestNG]** (ビジュアルエディタ) または [`TESTNGXML`] (YAML エディタ) を指定します。
+ コードカバレッジレポートの場合:
+ Clover XML の場合は、**[Clover]** (ビジュアルエディタ) または [`CLOVERXML`] (YAML エディタ) を指定します。
+ Cobertura XML の場合は、**[Cobertura]** (ビジュアルエディタ) または [`COBERTURAXML`] (YAML エディタ) を指定します。
+ JaCoCo XML の場合は、**[JaCoCo]** (ビジュアルエディタ) または [`JACOCOXML`] (YAML エディタ) を指定します。
+ [[simplecov-json]](https://github.com/simplecov-ruby/simplecov) ではなく [[simplecov]](https://github.com/vicentllongo/simplecov-json) によって生成された SimpleCov JSON の場合は、**[Simplecov]** (ビジュアルエディタ) または [`SIMPLECOV`] (YAML エディタ) を指定します。
+ ソフトウェアコンポジション分析 (SCA) レポートの場合:
+ SARIF には、**[SARIF]** (ビジュアルエディタ) または [`SARIFSCA`] (YAML エディタ) を指定します。
対応する UI: [出力] タブ/[レポート]/[レポートを手動で設定]/[レポートを追加]/[設定]/*report-name-1*/**[レポートタイプ]** と **[レポート形式]**
## Configuration
(*action-name*/**Configuration**)
(必須) アクションの設定プロパティを定義できるセクション。
対応する UI: **[設定]** タブ
## Container
(*action-name*/Configuration/**Container**)
(オプション)
アクションが処理を完了するために使用する Docker イメージまたは *[コンテナ]* を指定します。CodeCatalyst に付属する [[アクティブなイメージ]](build-images.md#build-curated-images) のいずれかを指定するか、独自のイメージを使用できます。独自のイメージを使用する場合は、Amazon ECR、Docker Hub、または別のレジストリに存在できます。Docker イメージを指定しない場合、アクションはその処理にアクティブなイメージの 1 つを使用します。デフォルトではどのアクティブなイメージが使用されているかについては、「[アクティブなイメージ](build-images.md#build-curated-images)」を参照してください。
独自の Docker イメージの指定の詳細については、「[カスタムランタイム環境の Docker イメージをアクションに割り当てる](build-images.md#build-images-specify)」を参照してください。
対応する UI: **ランタイム環境 Docker イメージ - オプション**
## Registry
(*action-name*/Configuration/Container/**Registry**)
(`Container` が含まれている場合は必須)
イメージが保存されているレジストリを指定します。有効な値を次に示します。
+ `CODECATALYST` (YAML エディタ)
イメージは CodeCatalyst レジストリに保存されます。
+ **[Docker Hub]** (ビジュアルエディタ) または [`DockerHub`] (YAML エディタ)
イメージは Docker Hub イメージレジストリに保存されます。
+ **[その他のレジストリ]** (ビジュアルエディタ) または [`Other`] (YAML エディタ)
イメージはカスタムイメージレジストリに保存されます。公開されているレジストリを使用できます。
+ **[Amazon Elastic Container Registry]** (ビジュアルエディタ) または [`ECR`] (YAML エディタ)
イメージは Amazon Elastic Container Registry イメージリポジトリに保存されます。Amazon ECR リポジトリでイメージを使用するには、このアクションで Amazon ECR にアクセスする必要があります。このアクセスを有効にするには、次のアクセス許可とカスタム信頼ポリシーを含む [[IAM ロール]](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) を作成する必要があります。(既存のロールを変更して、必要に応じてアクセス許可とポリシーを含めることができます。)
IAM ロールのロールポリシーには、次のアクセス許可を含める必要があります。
+ `ecr:BatchCheckLayerAvailability`
+ `ecr:BatchGetImage`
+ `ecr:GetAuthorizationToken`
+ `ecr:GetDownloadUrlForLayer`
IAM ロールには、次のカスタム信頼ポリシーを含める必要があります。
IAM ロールの作成に関する詳細については、「*IAM ユーザーガイド*」の「[ロールの作成とポリシーのアタッチ (コンソール)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html)」を参照してください。
ロールを作成したら、環境を介してアクションに割り当てる必要があります。詳細については、「[環境とアクションの関連付け](deploy-environments-add-app-to-environment.md)」を参照してください。
対応する UI: **[Amazon Elastic Container Registry]**、**[Docker Hub]**、**[その他のレジストリ]** オプション
## Image
(*action-name*/Configuration/Container/**Image**)
(`Container` が含まれている場合は必須)
次のいずれかを指定します。
+ `CODECATALYST` レジストリを使用している場合は、イメージを次のいずれかの [[アクティブなイメージ]](build-images.md#build-curated-images) に設定します。
+ `CodeCatalystLinux_x86_64:2024_03`
+ `CodeCatalystLinux_x86_64:2022_11`
+ `CodeCatalystLinux_Arm64:2024_03`
+ `CodeCatalystLinux_Arm64:2022_11`
+ `CodeCatalystLinuxLambda_x86_64:2024_03`
+ `CodeCatalystLinuxLambda_x86_64:2022_11`
+ `CodeCatalystLinuxLambda_Arm64:2024_03`
+ `CodeCatalystLinuxLambda_Arm64:2022_11`
+ `CodeCatalystWindows_x86_64:2022_11`
+ Docker Hub レジストリを使用している場合は、イメージを Docker Hub イメージ名とオプションのタグに設定します。
例: `postgres:latest`
+ Amazon ECR レジストリを使用している場合は、イメージを Amazon ECR レジストリ URI に設定します。
例: `111122223333.dkr.ecr.us-west-2.amazonaws.com/codecatalyst-ecs-image-repo`
+ カスタムレジストリを使用している場合は、イメージをカスタムレジストリで期待される値に設定します。
対応する UI: **[ランタイム環境の Docker イメージ]** (レジストリが `CODECATALYST` の場合)、**[Docker Hub イメージ]** (レジストリが **[Docker Hub]** の場合)、**[ECR イメージ URL]** (レジストリが **[Amazon Elastic Container Registry]** の場合)、および **[イメージ URL]** (レジストリが**[その他のレジストリ]** の場合)。
## Steps
(*action-name*/Configuration/**Steps**)
(必須)
ビルドツールをインストール、設定、実行するアクション中に実行するシェルコマンドを指定します。
npm プロジェクトをビルドする方法の例を次に示します。
```
Steps:
- Run: npm install
- Run: npm run build
```
ファイルパスを指定する方法の例を次に示します。
```
Steps:
- Run: cd $ACTION_BUILD_SOURCE_PATH_WorkflowSource/app && cat file2.txt
- Run: cd $ACTION_BUILD_SOURCE_PATH_MyBuildArtifact/build-output/ && cat file.txt
```
出力ファイル名とパスの詳細については、「[ソースリポジトリファイルの参照](workflows-sources-reference-files.md)」と「[アーティファクト内のファイルの参照](workflows-working-artifacts-refer-files.md)」を参照してください。
対応する UI: [設定] タブ/**[シェルコマンド]**
## Packages
(*action-name*/Configuration/**Packages**)
(オプション)
アクションが依存関係を解決するために使用するパッケージリポジトリを指定できるセクション。パッケージを使用すると、アプリケーション開発に使用されるソフトウェアパッケージを安全に保存および共有できます。
パッケージの詳細については、「[CodeCatalyst でソフトウェアパッケージを公開および共有する](packages.md)」を参照してください。
対応する UI: [設定] タブ/**[パッケージ]**
## NpmConfiguration
(*action-name*/Configuration/Packages/**NpmConfiguration**)
([Packages](#build.configuration.packages) が含まれている場合は必須)
npm パッケージ形式の設定を定義するセクション。この設定は、ワークフローの実行中にアクションによって使用されます。
npm パッケージ設定の詳細については、「[npmを使う](packages-npm.md)」を参照してください。
対応する UI: [設定] タブ/[パッケージ]/[設定の追加]/**[npm]**
## PackageRegistries
(*action-name*/Configuration/Packages/NpmConfiguration/**PackageRegistries**)
([Packages](#build.configuration.packages) が含まれている場合は必須)
一連のパッケージリポジトリの設定プロパティを定義できるセクション。
対応する UI: [設定] タブ/[パッケージ]/[設定の追加]/[npm]/**[パッケージリポジトリの追加]**
## PackagesRepository
(*action-name*/Configuration/Packages/NpmConfiguration/PackageRegistries/**PackagesRepository**)
([Packages](#build.configuration.packages) が含まれている場合は必須)
アクションで使用する CodeCatalyst *[パッケージリポジトリ]* の名前を指定します。
複数のデフォルトリポジトリを指定すると、最後のリポジトリが優先されます。
パッケージリポジトリの作成方法については、「[パッケージリポジトリ](packages-concepts.md#packages-concepts-repository)」を参照してください。
対応する UI: [設定] タブ/[パッケージ]/[設定の追加]/[npm]/[パッケージリポジトリの追加]/**[パッケージリポジトリ]**
## Scopes
(*action-name*/Configuration/Packages/NpmConfiguration/PackageRegistries/**Scopes**)
(オプション)
パッケージレジストリで定義する *[スコープ]* のシーケンスを指定します。スコープを定義する場合、指定されたパッケージリポジトリは、一覧表示されているすべてのスコープのレジストリとして設定されます。スコープを持つパッケージが npm クライアントを介してリクエストされた場合、デフォルトの代わりにそのリポジトリが使用されます。各スコープ名には、「@」というプレフィックスを付ける必要があります。
上書きスコープを含めると、最後のリポジトリが優先されます。
`Scopes` を省略すると、指定されたパッケージリポジトリは、アクションで使用されるすべてのパッケージのデフォルトレジストリとして構成されます。
スコープの詳細については、「[パッケージの名前空間](packages-concepts.md#packages-concepts-package-namespaces)」および「[スコープパッケージ](https://docs.npmjs.com/cli/v10/using-npm/scope)」を参照してください。
対応する UI: [設定] タブ/[パッケージ]/[設定の追加]/[npm]/[パッケージリポジトリを追加]/**[スコープ - オプション]**
## ExportAuthorizationToken
(*action-name*/Configuration/Packages/**ExportAuthorizationToken**)
(オプション)
エクスポート認証トークン機能を有効または無効にします。有効にすると、エクスポートされた認証トークンを使用して、CodeCatalyst パッケージリポジトリで認証するようにパッケージマネージャーを手動で設定できます。トークンは、アクションで参照できる環境変数として使用できます。
有効な値は `true` または `false` です。
`ExportAuthorizationToken` を省略した場合、デフォルトは `false` です。
エクスポート認証トークンの詳細については、「[ワークフローアクションでの認証トークンの使用](workflows-package-export-token.md)」を参照してください。
対応する UI: [設定] タブ/[パッケージ]/**[エクスポート認証トークン]**