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

# CodeBuild に用意されている Docker イメージ
<a name="build-env-ref-available"></a>

サポートされているイメージは、CodeBuild で利用できるイメージの最新のメジャーバージョンであり、マイナーバージョンとパッチバージョンのアップデートにより更新されます。CodeBuild は、サポートされているイメージをマシンの [Amazon マシンイメージ (AMI)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html#ami-using) にキャッシュすることで、ビルドのプロビジョニング時間を最適化します。キャッシュを有効に活用し、ビルドのプロビジョニング時間を最小限に抑えたい場合は、`aws/codebuild/amazonlinux-x86_64-standard:4.0-1.0.0` のようなより詳細なバージョンではなく、CodeBuild コンソールの **[イメージバージョン]** セクションで、**[常にこのランタイムバージョンの最新イメージを使用する]** を選択します。

**Topics**
+ [現在の Docker イメージのリストを取得](build-env-ref-available-get.md)
+ [EC2 コンピューティングイメージ](ec2-compute-images.md)
+ [Lambda コンピューティングイメージ](lambda-compute-images.md)
+ [非推奨の CodeBuild イメージ](deprecated-images.md)
+ [使用可能なランタイム](available-runtimes.md)
+ [ランタイムバージョン](runtime-versions.md)

# 現在の Docker イメージのリストを取得
<a name="build-env-ref-available-get"></a>

CodeBuild は Docker イメージのリストを頻繁に更新して最新のイメージを追加し、古いイメージを廃止します。最新のリストを取得するには、次のいずれかを実行します。
+ CodeBuild コンソールの **[Create build project]** (ビルドプロジェクトの作成) ウィザードまたは **[Edit Build Project]** (ビルドプロジェクトの編集) ページで、**環境イメージ**として **[Managed image]** (マネージド型イメージ) を選択します。[**オペレーティングシステム**]、[**ランタイム**]、[**ランタイムバージョン**] の各ドロップダウンリストで適切な選択を行います。詳細については、「[ビルドプロジェクトの作成 (コンソール)](create-project.md#create-project-console)」または「[ビルドプロジェクトの設定の変更 (コンソール)](change-project.md#change-project-console)」を参照してください。
+ で AWS CLI、 `list-curated-environment-images` コマンドを実行します。

  ```
  aws codebuild list-curated-environment-images
  ```
+  AWS SDKs、ターゲットプログラミング言語の `ListCuratedEnvironmentImages`オペレーションを呼び出します。詳細については、「[AWS SDKsとツールのリファレンス](sdk-ref.md)」を参照してください。

# EC2 コンピューティングイメージ
<a name="ec2-compute-images"></a>

AWS CodeBuild は、CodeBuild の EC2 コンピューティングで使用できる次の Docker イメージをサポートしています。

**注記**  
Windows Server Core 2019 プラットフォームの基本イメージは、以下のリージョンでのみ利用可能です。  
米国東部（バージニア北部）
米国東部 (オハイオ)
米国西部 (オレゴン)
欧州 (アイルランド)


| プラットフォーム | イメージ識別子 | 定義 | 
| --- | --- | --- | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-standard:4.0 | [al/standard/4.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/4.0) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-standard:5.0 | [al/standard/5.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/5.0) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-standard:6.0 | [al/standard/6.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/6.0) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-standard:corretto8 | [al/standard/corretto8](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/corretto8) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-standard:corretto11 | [al/standard/corretto11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/corretto11) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-standard:2.0 | [al/aarch64/standard/2.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/aarch64/standard/2.0) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-standard:3.0 | [al/aarch64/standard/3.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/aarch64/standard/3.0) | 
| Ubuntu 20.04 | aws/codebuild/standard:5.0 | [ubuntu/standard/5.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/5.0) | 
| Ubuntu 22.04 | aws/codebuild/standard:6.0 | [ubuntu/standard/6.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/6.0) | 
| Ubuntu 22.04 | aws/codebuild/standard:7.0 | [ubuntu/standard/7.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/7.0) | 
| Ubuntu 24.04 | aws/codebuild/standard:8.0 | [ubuntu/standard/8.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/8.0) | 
| Windows Server Core 2019 | aws/codebuild/windows-base:2019-1.0 | 該当なし | 
| Windows Server Core 2019 | aws/codebuild/windows-base:2019-2.0 | 該当なし | 
| Windows Server Core 2019 | aws/codebuild/windows-base:2019-3.0 | 該当なし | 
| Windows Server Core 2022 | aws/codebuild/windows-base:2022-1.0 | 該当なし | 

**注記**  
2024 年 11 月 22 日、Linux ベースの標準ランタイムイメージのエイリアスが `amazonlinux2` から `amazonlinux` に更新されました。以前のエイリアスは引き続き有効であるため、手動更新は必要ありません。

# Lambda コンピューティングイメージ
<a name="lambda-compute-images"></a>

AWS CodeBuild は、CodeBuild で AWS Lambda コンピューティングに使用できる次の Docker イメージをサポートしています。

**重要**  
Lambda コンピューティングまたはリザーブドキャパシティを使用する場合、`on-failure` 属性はサポートされません。この属性は、CodeBuild が提供する EC2 コンピューティングイメージでのみ機能します。


**`aarch64` アーキテクチャ**  

| プラットフォーム | イメージ識別子 | 定義 | 
| --- | --- | --- | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:dotnet6 | [al-lambda/aarch64/dotnet6](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/dotnet6) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:dotnet8 | [al-lambda/aarch64/dotnet8](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/dotnet8) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:go1.21 | [al-lambda/aarch64/go1.21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/go1.21) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:go1.24 | [al-lambda/aarch64/go1.24](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/go1.24) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto11 | [al-lambda/aarch64/corretto11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/corretto11) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto17 | [al-lambda/aarch64/corretto17](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/corretto17) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto21 | [al-lambda/aarch64/corretto21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/corretto21) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs18 | [al-lambda/aarch64/nodejs18](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/nodejs18) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs20 | [al-lambda/aarch64/nodejs20](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/nodejs20) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs22 | [al-lambda/aarch64/nodejs22](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/nodejs22) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.11 | [al-lambda/aarch64/python3.11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/python3.11) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.12 | [al-lambda/aarch64/python3.12](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/python3.12) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.13 | [al-lambda/aarch64/python3.13](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/python3.13) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:ruby3.2 | [al-lambda/aarch64/ruby3.2](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/ruby3.2) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:ruby3.4 | [al-lambda/aarch64/ruby3.4](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/ruby3.4) | 


**`x86_64` アーキテクチャ**  

| プラットフォーム | イメージ識別子 | 定義 | 
| --- | --- | --- | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:dotnet6 | [al-lambda/x86\$164/dotnet6](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/dotnet6) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:dotnet8 | [al-lambda/x86\$164/dotnet8](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/dotnet8) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:go1.21 | [al-lambda/x86\$164/go1.21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/go1.21) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:go1.24 | [al-lambda/x86\$164/go1.24](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/go1.24) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto11 | [al-lambda/x86\$164/corretto11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/corretto11) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto17 | [al-lambda/x86\$164/corretto17](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/corretto17) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto21 | [al-lambda/x86\$164/corretto21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/corretto21) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:nodejs18 | [al-lambda/x86\$164/nodejs18](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/nodejs18) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:nodejs20 | [al-lambda/x86\$164/nodejs20](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/nodejs20) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:nodejs22 | [al-lambda/x86\$164/nodejs22](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/nodejs22) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:python3.11 | [al-lambda/x86\$164/python3.11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/python3.11) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:python3.12 | [al-lambda/x86\$164/python3.12](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/python3.12) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:python3.13 | [al-lambda/x86\$164/python3.13](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/python3.13) | 
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:ruby3.2 | [al-lambda/x86\$164/ruby3.2](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/ruby3.2) | 
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:ruby3.4 | [al-lambda/x86\$164/ruby3.4](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/ruby3.4) | 

# 非推奨の CodeBuild イメージ
<a name="deprecated-images"></a>

*廃止イメージ*とは、CodeBuild によってキャッシュまたは更新されなくなったイメージです。廃止イメージは、マイナーバージョンやパッチバージョンの更新の対象外となって、更新されなくなるため、使用すると安全ではない場合があります。CodeBuild プロジェクトが古いイメージバージョンを使用するように設定されている場合、プロビジョニングプロセスはこの Docker イメージをダウンロードし、それを使用してコンテナ化されたランタイム環境を作成します。これにより、プロビジョニング時間と全体的なビルド時間が長くなる可能性があります。

CodeBuild は、以下の Docker イメージを廃止しました。これらのイメージは引き続き使用できますが、ビルドホストにキャッシュされないため、プロビジョニング時間が長くなります。


| プラットフォーム | イメージ識別子 | 定義 | 廃止日 | 
| --- | --- | --- | --- | 
| Amazon Linux 2 | aws/codebuild/amazonlinux2-x86\$164-standard:3.0 | al2/standard/3.0 | 2023 年 5 月 9 日 | 
| Ubuntu 18.04 | aws/codebuild/standard:4.0 | ubuntu/standard/4.0 | 2023 年 3 月 31 日 | 
| Amazon Linux 2 | aws/codebuild/amazonlinux2-aarch64-standard:1.0 | al2/aarch64/standard/1.0 | 2023 年 3 月 31 日 | 
| Ubuntu 18.04 | aws/codebuild/standard:3.0 | ubuntu/standard/3.0 | 2022 年 6 月 30 日 | 
| Amazon Linux 2 | aws/codebuild/amazonlinux2-x86\$164-standard:2.0 | al2/standard/2.0 | 2022 年 6 月 30 日 | 

**Topics**
+ [現在の Docker イメージのリストを取得](build-env-ref-available-get.md)
+ [EC2 コンピューティングイメージ](ec2-compute-images.md)
+ [Lambda コンピューティングイメージ](lambda-compute-images.md)
+ [非推奨の CodeBuild イメージ](deprecated-images.md)
+ [使用可能なランタイム](available-runtimes.md)
+ [ランタイムバージョン](runtime-versions.md)

# 使用可能なランタイム
<a name="available-runtimes"></a>

buildspec ファイルの `runtime-versions` セクションで 1 つ以上のランタイムを指定できます。ランタイムが別のランタイムに依存している場合は、依存しているランタイムを buildspec ファイルで指定することもできます。buildspec ファイルでランタイムを指定しない場合は、CodeBuild により、使用するイメージのデフォルトのランタイムが選択されます。1 つ以上のランタイムを指定すると、CodeBuild により、それらのランタイムのみが使用されます。依存関係のあるランタイムが指定されていない場合、CodeBuild により、依存関係のあるランタイムの選択が試みられます。

**注記**  
ランタイムバージョンが指定されていない場合、CodeBuild はデフォルトバージョンを使用します。デフォルトバージョンは、以前のデフォルトバージョンがサポート終了 (EOL) に達すると変更される可能性があります。ビルド環境の予期しない変更を回避するには、buildspec ファイルでランタイムバージョンを指定することをお勧めします。

 詳細については、「[Specify runtime versions in the buildspec file](build-spec-ref.md#runtime-versions-buildspec-file)」を参照してください。

[Specify runtime versions in the buildspec file](build-spec-ref.md#runtime-versions-buildspec-file).

.

**Topics**
+ [Linux イメージのランタイム](#linux-runtimes)
+ [macOS イメージランタイム](#macOS-runtimes)
+ [Windows イメージのランタイム](#windows-runtimes)

## Linux イメージのランタイム
<a name="linux-runtimes"></a>

次の表に、使用可能なランタイムと、それらをサポートする標準 Linux イメージを示します。


**Ubuntu および Amazon Linux プラットフォームランタイム**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/available-runtimes.html)

## macOS イメージランタイム
<a name="macOS-runtimes"></a>

**重要**  
Mac ビルド用の CodeBuild キュレーションイメージには、macOS と Xcode がプリインストールされています。Xcode ソフトウェアを使用することにより、「[XcodeとApple SDKの利用規約](https://www.apple.com/legal/sla/docs/xcode.pdf)」を承認、理解し、同意したものとみなされます。契約条件に同意しない場合は、Xcode ソフトウェアを使用しないでください。代わりに、独自の Amazon マシンイメージ (AMI) を指定します。詳細については、[リザーブドキャパシティの macOS フリートを設定するにはどうすればよいですか。](fleets.md#fleets.configure-macos)を参照してください。

次の表は、macOS でサポートされている利用可能なランタイムを示しています。


**macOS プラットフォームランタイム**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/available-runtimes.html)

## Windows イメージのランタイム
<a name="windows-runtimes"></a>

Windows Server Core 2019 のベースイメージには、以下のランタイムが含まれています。


**Windows プラットフォームのランタイム**  

| ランタイム名 | Windows Server Core 2019 standard:1.0 バージョン | Windows Server Core 2019 standard:2.0 バージョン | Windows Server Core 2019 standard:3.0 バージョン | 
| --- | --- | --- | --- | 
| dotnet | 3.15.0 | 3.16.07.0 | 8.0 | 
| dotnet sdk | 3.15.0 | 3.16.07.0 | 8.0 | 
| golang | 1.14 | 1.18 | 1.211.221.23 | 
| gradle | 6.7 | 7.6 | 8.12 | 
| java | Corretto11 | Corretto11Corretto17 | Corretto8Corretto11Corretto17Corretto21 | 
| Maven (メイヴン) | 3.6 | 3.8 | 3.9 | 
| nodejs | 14.15 | 16.19 | 20.1822.13 | 
| php | 7.4 | 8.1 | 8.38.4 | 
| powershell | 7.1 | 7.2 | 7.4 | 
| python | 3.8 | 3.10 | 3.103.113.123.13 | 
| ruby | 2.7 | 3.1 | 3.23.33.4 | 

# ランタイムバージョン
<a name="runtime-versions"></a>

buildspec ファイルの [`runtime-versions`](build-spec-ref.md#build-spec.phases.install.runtime-versions) セクションでランタイムを指定するときは、特定のバージョン、特定のメジャーバージョンと最新のマイナーバージョン、または最新バージョンを指定できます。次の表に、使用可能なランタイムとその指定方法を示します。すべてのランタイムバージョンが、すべてのイメージで使用できるわけではありません。ランタイムバージョンの選択は、カスタムイメージでもサポートされていません。詳細については、「[使用可能なランタイム](available-runtimes.md)」を参照してください。プリインストールされたランタイムバージョンの代わりにカスタムランタイムバージョンをインストールして使用する場合は、「[カスタムランタイムバージョン](#custom-runtime)」を参照してください。


**Ubuntu および Amazon Linux 2 プラットフォームランタイムバージョン**  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/codebuild/latest/userguide/runtime-versions.html)

ビルド仕様を使用して、`install`ビルドフェーズ中に他のコンポーネント (Apache Maven AWS CLI、Apache Ant、Mocha、RSpec など) をインストールできます。詳細については、「[buildspec の例](build-spec-ref.md#build-spec-ref-example)」を参照してください。

## カスタムランタイムバージョン
<a name="custom-runtime"></a>

CodeBuild マネージドイメージにプリインストールされたランタイムバージョンを使用する代わりに、選択したカスタムバージョンをインストールして使用できます。次の表に、利用可能なランタイムとその指定方法を示します。

**注記**  
カスタムランタイムバージョンの選択は、Ubuntu イメージと Amazon Linux イメージでのみサポートされています。


**カスタムランタイムバージョン**  

| ランタイム名  | Syntax | 例 | 
| --- | --- | --- | 
| dotnet |  `<major>.<minor>.<patch>`  |  `5.0.408`  | 
| golang |  `<major>.<minor>` `<major>.<minor>.<patch>`  |  `1.19` `1.19.1`  | 
| java |  `corretto<major>`  |  `corretto15`  | 
| nodejs |  `<major>` `<major>.<minor>` `<major>.<minor>.<patch>`  |  `14` `14.21` `14.21.3`  | 
| php |  `<major>.<minor>.<patch>`  |  `8.0.30`  | 
| python |  `<major>` `<major>.<minor>` `<major>.<minor>.<patch>`  |  `3` `3.7` `3.7.16`  | 
| ruby |  `<major>.<minor>.<patch>`  |  `3.0.6`  | 

### カスタムランタイム buildspec の例
<a name="custom-runtime-buildspec"></a>

以下は、カスタムランタイムバージョンを指定する buildspec の例です。

```
version: 0.2
phases:
  install:
    runtime-versions:
      java: corretto15
      php: 8.0.30
      ruby: 3.0.6
      golang: 1.19
      python: 3.7
      nodejs: 14
      dotnet: 5.0.408
```