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

ランタイム環境イメージの指定

ランタイム環境イメージは、 がワークフローアクションを実行する CodeCatalyst Docker コンテナです。Docker コンテナは、選択したコンピューティングプラットフォーム上で実行され、オペレーティングシステムと、、Node.js AWS CLI、.tar などのワークフローアクションに必要な追加ツールが含まれています。

デフォルトでは、ワークフローアクションは、 によって提供および保守されているアクティブなイメージの 1 つで実行されます CodeCatalyst。ビルドアクションとテストアクションのみがカスタムイメージをサポートします。詳細については、「カスタムランタイム環境の Docker イメージを アクションに割り当てる」を参照してください。

アクティブなイメージ

アクティブイメージは、 によって完全にサポートされ CodeCatalyst 、プリインストールされたツールを含むランタイム環境イメージです。現在、アクティブなイメージには 2 つのセットがあります。1 つは 2024 年 3 月にリリースされ、もう 1 つは 2022 年 11 月にリリースされています。

アクションが 2024 年 3 月と 2022 年 11 月のどちらのイメージを使用するかは、アクションによって異なります。

2024 年 3 月の画像

2024 年 3 月のイメージは、 が提供する最新のイメージです CodeCatalyst。2024 年 3 月のイメージは、コンピューティングタイプとフリートの組み合わせごとに 1 つあります。

次の表は、2024 年 3 月の各イメージにインストールされたツールを示しています。

2022 年 11 月の画像

2022 年 11 月のイメージは、コンピューティングタイプとフリートの組み合わせごとに 1 つあります。プロビジョニングされたフリート を設定している場合、ビルドアクションで 2022 年 11 月の Windows イメージも使用できます。

次の表は、2022 年 11 月の各イメージにインストールされているツールを示しています。

アクティブなイメージに必要なツールが含まれていない場合はどうなりますか？

が提供するアクティブなイメージに、必要なツール CodeCatalyst が含まれていない場合は、いくつかのオプションがあります。

カスタムランタイム環境の Docker イメージを アクションに割り当てる

が提供するアクティブイメージを使用しない場合は CodeCatalyst、カスタムランタイム環境の Docker イメージを指定できます。カスタムイメージを提供する場合は、そのイメージに Git がインストールされていることを確認します。イメージは、Docker Hub、Amazon Elastic Container Registry、または任意のパブリックリポジトリに格納できます。

カスタム Docker イメージを作成する方法については、Docker ドキュメントの「アプリケーションをコンテナ化する」を参照してください。

カスタムランタイム環境の Docker イメージを アクションに割り当てるには、以下の手順に従います。イメージを指定すると、 はアクションの開始時にそのイメージをコンピューティングプラットフォームに CodeCatalyst デプロイします。

Visual

ビジュアルエディタを使用してカスタムランタイム環境の Docker イメージを割り当てるには

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

2. ナビゲーションペインで CI/CD を選択し、ワークフロー を選択します。

3. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。

4. [編集] を選択します。

5. ビジュアル を選択します。

6. ワークフロー図で、カスタムランタイム環境の Docker イメージを使用するアクションを選択します。

7. [設定] タブを選択します。

8. 下部の次のフィールドに入力します。

   ランタイム環境の Docker イメージ - オプション

   イメージが保存されているレジストリを指定します。有効な値を次に示します。

   • 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ロールを作成する必要があります。（必要に応じて、既存のロールを変更して、アクセス許可とポリシーを含めることができます。）

     IAM ロールには、ロールポリシーに次のアクセス許可を含める必要があります。

     • ecr:BatchCheckLayerAvailability

     • ecr:BatchGetImage

     • ecr:GetAuthorizationToken

     • ecr:GetDownloadUrlForLayer

     IAM ロールには、次のカスタム信頼ポリシーを含める必要があります。

     {
         "Version": "2012-10-17",
         "Statement": [
             {
                 "Sid": "",
                 "Effect": "Allow",
                 "Principal": {
                     "Service":  [
                        "codecatalyst-runner.amazonaws.com",
                        "codecatalyst.amazonaws.com"
                      ]
                 },
                 "Action": "sts:AssumeRole"
             }
         ]
     }

     IAM ロールの作成の詳細については、「 IAMユーザーガイド」の「カスタム信頼ポリシーを使用したロールの作成 (コンソール）」を参照してください。

     ロールを作成したら、 環境を介して アクションに割り当てる必要があります。詳細については、「環境と アクションの関連付け」を参照してください。

   ECR イメージ URL、Docker Hub イメージまたはイメージ URL

   次のいずれかを指定します。

   • CODECATALYST レジストリを使用している場合は、イメージ を次のアクティブなイメージ のいずれかに設定します。

     • 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

   • カスタムレジストリを使用している場合は、イメージをカスタムレジストリで期待される値に設定します。

9. （オプション) 検証 を選択して、コミットする前にワークフローのYAMLコードを検証します。

10. コミット を選択し、コミットメッセージを入力し、もう一度コミット を選択します。

YAML

YAML エディタを使用してカスタムランタイム環境の Docker イメージを割り当てるには

1. ナビゲーションペインで CI/CD を選択し、ワークフロー を選択します。

2. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。

3. [編集] を選択します。

4. を選択しますYAML。

5. ランタイム環境 Docker イメージを割り当てるアクションを見つけます。

6. アクションで、 Containerセクションと基盤となる プロパティRegistryと Imageプロパティを追加します。詳細については、「」のContainerアクション「」、RegistryおよびアクションのImageプロパティの説明を参照してください。

7. （オプション) 検証 を選択して、コミットする前にワークフローのYAMLコードを検証します。

8. コミット を選択し、コミットメッセージを入力し、もう一度コミット を選択します。

例

次の例は、カスタムランタイム環境の Docker イメージをワークフロー定義ファイルの アクションに割り当てる方法を示しています。

例: カスタムランタイム環境の Docker イメージを使用して Amazon で Node.js 18 のサポートを追加する ECR

次の例は、カスタムランタイム環境の Docker イメージを使用して、Amazon ECRで Node.js 18 のサポートを追加する方法を示しています。

Configuration:
  Container:
    Registry: ECR
    Image: public.ecr.aws/amazonlinux/amazonlinux:2023

例: カスタムランタイム環境の Docker イメージを使用して、Docker Hub で Node.js 18 のサポートを追加する

次の例は、カスタムランタイム環境の Docker イメージを使用して、Docker Hub で Node.js 18 のサポートを追加する方法を示しています。

Configuration:
  Container:
    Registry: DockerHub
    Image: node:18.18.2