翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# RES 対応 AMIs を設定する
RES 対応 Amazon マシンイメージ (AMIs) を使用すると、仮想デスクトップインスタンス (VDIs) の RES 依存関係をカスタム AMIs にプリインストールできます。RES 対応 AMIs を使用すると、事前にベイクされたイメージを使用する VDI インスタンスの起動時間が短縮されます。EC2 Image Builder を使用すると、AMIs を構築して新しいソフトウェアスタックとして登録できます。Image Builder の詳細については、[「Image Builder ユーザーガイド](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html)」を参照してください。
開始する前に、[最新バージョンの RES をデプロイ](update-the-product.md)する必要があります。
**重要**
RES 2025.06.01 より前に作成された RES 対応 AMIs は、RES 2025.06.01 以降のすべてのバージョンと互換性がありません。RES 環境を 2025.06.01 より前のバージョンから最新のバージョンにアップグレードする場合は、すべての RES 対応 AMIs再構築する必要があります。
**Topics**
+ [RES 環境にアクセスするための IAM ロールを準備する](#prepare-role)
+ [EC2 Image Builder コンポーネントを作成する](#image-builder-component)
+ [EC2 Image Builder レシピを準備する](#prepare-recipe)
+ [EC2 Image Builder インフラストラクチャを設定する](#configure-ib-infrastructure)
+ [Image Builder イメージパイプラインを設定する](#image-builder-pipeline)
+ [Image Builder イメージパイプラインを実行する](#run-image-pipeline)
+ [RES に新しいソフトウェアスタックを登録する](#register-res-ready-stack)
## RES 環境にアクセスするための IAM ロールを準備する
EC2 Image Builder から RES 環境サービスにアクセスするには、RES-EC2InstanceProfileForImageBuilder という IAM ロールを作成または変更する必要があります。Image Builder で使用する IAM ロールの設定については、Image *Builder ユーザーガイド*の [AWS Identity and Access Management (IAM) ](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-setting-up.html#image-builder-IAM-prereq) を参照してください。
**ロールには以下が必要です。**
+ Amazon EC2 サービスを含む信頼関係。
+ AmazonS3ReadOnlyAccess、AmazonSSMManagedInstanceCore、EC2InstanceProfileForImageBuilder ポリシー。
## EC2 Image Builder コンポーネントを作成する
[「Image Builder ユーザーガイド」の「Image Builder コンソールを使用してコンポーネントを作成する](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component-console.html)**」の指示に従ってください。
**コンポーネントの詳細を入力します。**
1. Type で****、**Build** を選択します。
1. **イメージオペレーティングシステム (OS)** の場合は、Linux または Windows を選択します。
1. **コンポーネント名**には、 などのわかりやすい名前を入力します**research-and-engineering-studio-vdi-**。
1. コンポーネントのバージョン番号を入力し、オプションで説明を追加します。
```
key : value
```
1. **定義ドキュメント**には、次の定義ファイルを入力します。エラーが発生した場合、YAML ファイルはスペースに敏感であり、最も可能性の高い原因です。
**重要**
定義ファイル**latest**で、RES 環境のバージョンが最新でない場合は、ダウンロード URI (`- source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz'`) の を正確なバージョン番号 (例: **2025.06**) に置き換えます。
------
#### [ Linux ]
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
# with the License. A copy of the License is located at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
# and limitations under the License.
name: research-and-engineering-studio-vdi-linux
description: An RES EC2 Image Builder component to install required RES software dependencies for Linux VDI.
schemaVersion: 1.0
parameters:
- GPUFamily:
type: string
description: GPU family (NONE, NVIDIA, or AMD)
default: NONE
phases:
- name: build
steps:
- name: PrepareRESBootstrap
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- "mkdir -p /root/bootstrap/logs"
- "mkdir -p /root/bootstrap/latest"
- name: DownloadRESLinuxInstallPackage
action: S3Download
onFailure: Abort
maxAttempts: 3
inputs:
- source: "s3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz"
destination: "/root/bootstrap/res-installation-scripts/res-installation-scripts.tar.gz"
- name: RunInstallScript
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- "cd /root/bootstrap/res-installation-scripts"
- "tar -xf res-installation-scripts.tar.gz"
- "cd scripts/virtual-desktop-host/linux"
- "/bin/bash install.sh -g {{ GPUFamily }}"
- name: RebootAfterInstall
action: Reboot
onFailure: Abort
maxAttempts: 3
inputs:
delaySeconds: 0
- name: RunInstallPostRebootScript
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- "cd /root/bootstrap/res-installation-scripts/scripts/virtual-desktop-host/linux"
- 'sed -i ''/^export AWS_DEFAULT_PROFILE="bootstrap_profile"$/d'' install_post_reboot.sh'
- "/bin/bash install_post_reboot.sh -g {{ GPUFamily }}"
- name: PreventAL2023FromUninstallingCronie
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- "rm -f /tmp/imagebuilder_service/crontab_installed"
```
------
#### [ Windows ]
```
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
# with the License. A copy of the License is located at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
# and limitations under the License.
name: research-and-engineering-studio-vdi-windows
description: An RES EC2 Image Builder component to install required RES software dependencies for Windows VDI.
schemaVersion: 1.0
phases:
- name: build
steps:
- name: CreateRESBootstrapFolder
action: CreateFolder
onFailure: Abort
maxAttempts: 3
inputs:
- path: 'C:\Users\Administrator\RES\Bootstrap'
overwrite: true
- name: DownloadRESWindowsInstallPackage
action: S3Download
onFailure: Abort
maxAttempts: 3
inputs:
- source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz'
destination: '{{ build.CreateRESBootstrapFolder.inputs[0].path }}\res-installation-scripts.tar.gz'
- name: RunInstallScript
action: ExecutePowerShell
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- 'cd {{ build.CreateRESBootstrapFolder.inputs[0].path }}'
- 'tar -xf res-installation-scripts.tar.gz'
- 'Import-Module .\scripts\virtual-desktop-host\windows\Install.ps1'
- 'Install-WindowsEC2Instance -PrebakeAMI'
```
------
1. オプションのタグを作成し、**コンポーネントの作成**を選択します。
## EC2 Image Builder レシピを準備する
EC2 Image Builder レシピでは、新しいイメージを作成するための開始点として使用するベースイメージと、イメージをカスタマイズしてすべてが期待どおりに動作することを確認するために追加する一連のコンポーネントを定義します。レシピを作成または変更して、必要な RES ソフトウェアの依存関係を持つターゲット AMI を構築する必要があります。レシピの詳細については、[「レシピの管理](https://docs.aws.amazon.com/imagebuilder/latest/userguide/manage-recipes.html)」を参照してください。
RES は、次のイメージオペレーティングシステムをサポートしています。
+ Amazon Linux 2 (x86 および ARM64)
+ Amazon Linux 2023 (x86 および ARM64)
+ RHEL 8 (x86)、および 9 (x86)
+ Rocky Linux 9 (x86)
+ Ubuntu 22.04.3 (x86)
+ Ubuntu 24.04.3 (x86)
+ Windows Server 2019、2022 (x86)
+ Windows 10、11 (x86)
**注記**
リリース 2026.03 以降、Amazon Linux 2 および RHEL 8 はデフォルトのソフトウェアスタックとして含まれなくなりました。これらのオペレーティングシステムを持つカスタムソフトウェアスタックは、必要に応じて登録できます。
------
#### [ Create a new recipe ]
1. で EC2 Image Builder コンソールを開きます[https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder)。
1. **保存済みリソース**で、**イメージレシピ**を選択します。
1. **[イメージレシピの作成]** を選択します。
1. 一意の名前とバージョン番号を入力します。
1. RES でサポートされているベースイメージを選択します。
1. **インスタンス設定**で、SSM エージェントがプリインストールされていない場合はインストールします。**ユーザーデータ**およびその他の必要なユーザーデータに情報を入力します。
**注記**
SSM エージェントをインストールする方法については、以下を参照してください。
[ Linux 用 EC2 インスタンスに SSM エージェントを手動でインストールします](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html)。
[ Windows Server の EC2 インスタンスに SSM エージェントを手動でインストールおよびアンインストールします](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html)。
1. Linux ベースのレシピの場合は、Amazon が管理する`aws-cli-version-2-linux`ビルドコンポーネントをレシピに追加します。Windows ベースのレシピの場合は、Amazon が管理する`aws-cli-version-2-windows`ビルドコンポーネントをレシピに追加します。RES インストールスクリプトは を使用して AWS CLI 、DynamoDB クラスター設定の設定値への VDI アクセスを提供します。
1. Linux または Windows 環境用に作成された EC2 Image Builder コンポーネントを追加します。
**重要**
(Linux の場合) または `aws-cli-version-2-linux` (Windows の場合) ビルドコンポーネントを最初に追加した状態で` aws-cli-version-2-windows`、これらのコンポーネントを追加する必要があります。
![\[ビルドコンポーネントの追加を示すコンポーネントページ\]](http://docs.aws.amazon.com/ja_jp/res/latest/ug/images/res-ami-build-components.png)
1. (推奨) Amazon が管理する`simple-boot-test-`テストコンポーネントを追加して、AMI を起動できることを確認します。これは最小限の推奨事項です。要件を満たす他のテストコンポーネントを選択できます。
1. 必要に応じてオプションのセクションを完了し、他の必要なコンポーネントを追加して、**レシピの作成**を選択します。
------
#### [ Modify a recipe ]
既存の EC2 Image Builder レシピがある場合は、次のコンポーネントを追加して使用できます。
1. Linux ベースのレシピの場合は、Amazon が管理する`aws-cli-version-2-linux`ビルドコンポーネントをレシピに追加します。Windows ベースのレシピの場合は、Amazon が管理する`aws-cli-version-2-windows`ビルドコンポーネントをレシピに追加します。RES インストールスクリプトは を使用して AWS CLI 、DynamoDB クラスター設定の設定値への VDI アクセスを提供します。
1. Linux または Windows 環境用に作成された EC2 Image Builder コンポーネントを追加します。
**重要**
(Linux の場合) または `aws-cli-version-2-linux` (Windows の場合) ビルドコンポーネントを最初に追加した状態で` aws-cli-version-2-windows`、これらのコンポーネントを追加する必要があります。
![\[ビルドコンポーネントの追加を示すコンポーネントページ\]](http://docs.aws.amazon.com/ja_jp/res/latest/ug/images/res-ami-build-components.png)
1. 必要に応じてオプションのセクションを完了し、他の必要なコンポーネントを追加して、**レシピの作成**を選択します。
------
## EC2 Image Builder インフラストラクチャを設定する
インフラストラクチャ設定を使用して、Image Builder が Image Builder イメージの構築とテストに使用する Amazon EC2 インフラストラクチャを指定できます。RES で使用するには、新しいインフラストラクチャ設定を作成するか、既存の設定を使用するかを選択できます。
+ 新しいインフラストラクチャ設定を作成するには、[「インフラストラクチャ設定の作成](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-infra-config.html)」を参照してください。
+ 既存のインフラストラクチャ設定を使用するには、[インフラストラクチャ設定を更新します](https://docs.aws.amazon.com/imagebuilder/latest/userguide/update-infra-config.html)。
**Image Builder インフラストラクチャを設定するには:**
1. **IAM ロール**には、 で以前に設定したロールを入力します[RES 環境にアクセスするための IAM ロールを準備する](#prepare-role)。
1. **インスタンスタイプ**では、4 GB 以上のメモリを持つタイプを選択し、選択したベース AMI アーキテクチャをサポートします。[Amazon EC2 インスタンスタイプ](https://aws.amazon.com/ec2/instance-types/)」を参照してください。
1. **VPC、サブネット、およびセキュリティグループ**の場合、ソフトウェアパッケージをダウンロードするためにインターネットアクセスを許可する必要があります。RES 環境の `cluster-settings` DynamoDB テーブルと Amazon S3 クラスターバケットへのアクセスも許可する必要があります。
## Image Builder イメージパイプラインを設定する
Image Builder イメージパイプラインは、ベースイメージ、構築とテスト用のコンポーネント、インフラストラクチャ設定、およびディストリビューション設定をアセンブルします。RES 対応 AMIs のイメージパイプラインを設定するには、新しいパイプラインを作成するか、既存のパイプラインを使用するかを選択できます。詳細については、Image *Builder ユーザーガイド*[の「AMI イメージパイプラインの作成と更新](https://docs.aws.amazon.com/imagebuilder/latest/userguide/ami-image-pipelines.html)」を参照してください。
------
#### [ Create a new Image Builder pipeline ]
1. で Image Builder コンソールを開きます[https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder)。
1. ナビゲーションペインから、**イメージパイプライン**を選択します。
1. **「イメージパイプラインの作成**」を選択します。
1. 一意の名前、オプションの説明、スケジュール、頻度を入力して、パイプラインの詳細を指定します。
1. **「レシピを選択する**」で、**「既存のレシピを使用する**」を選択し、「」で作成したレシピを選択します[EC2 Image Builder レシピを準備する](#prepare-recipe)。レシピの詳細が正しいことを確認します。
1. **イメージ作成プロセスを定義する** では、ユースケースに応じてデフォルトワークフローまたはカスタムワークフローを選択します。ほとんどの場合、デフォルトのワークフローで十分です。詳細については、[EC2 Image Builder パイプラインのイメージワークフローを設定する](https://docs.aws.amazon.com/imagebuilder/latest/userguide/pipeline-workflows.html)」を参照してください。
1. **「インフラストラクチャ設定の定義**」で、**「既存のインフラストラクチャ設定の選択**」を選択し、「」で作成したインフラストラクチャ設定を選択します[EC2 Image Builder インフラストラクチャを設定する](#configure-ib-infrastructure)。インフラストラクチャの詳細が正しいことを確認します。
1. **ディストリビューション設定を定義する** で、**サービスのデフォルトを使用してディストリビューション設定を作成する **を選択します。出力イメージは、RES 環境 AWS リージョン と同じ に存在する必要があります。サービスのデフォルトを使用すると、Image Builder が使用されているリージョンにイメージが作成されます。
1. パイプラインの詳細を確認し、**パイプラインの作成**を選択します。
------
#### [ Modify an existing Image Builder pipeline ]
1. 既存のパイプラインを使用するには、 で作成されたレシピを使用するように詳細を変更します[EC2 Image Builder レシピを準備する](#prepare-recipe)。
1. **[Save changes]** (変更の保存) をクリックします。
------
## Image Builder イメージパイプラインを実行する
設定された出力イメージを生成するには、イメージパイプラインを開始する必要があります。イメージレシピのコンポーネント数によっては、構築プロセスに最大 1 時間かかる場合があります。
**イメージパイプラインを実行するには:**
1. **イメージパイプライン**から、 で作成されたパイプラインを選択します[Image Builder イメージパイプラインを設定する](#image-builder-pipeline)。
1. **アクション**から、**パイプラインの実行**を選択します。
## RES に新しいソフトウェアスタックを登録する
1. 「」の指示に従って[ソフトウェアスタック (AMIs)](software-stacks.md)、ソフトウェアスタックを登録します。
1. **AMI ID** には、 に構築された出力イメージの AMI ID を入力します[Image Builder イメージパイプラインを実行する](#run-image-pipeline)。