RES 対応 AMIs を設定する - Research and Engineering Studio

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

RES 対応 AMIs を設定する

RES 対応 Amazon マシンイメージ (AMIs) を使用すると、仮想デスクトップインスタンス (VDIs) の RES 依存関係をカスタム AMIs にプリインストールできます。RES 対応 AMIs を使用すると、事前にベイクされたイメージを使用した VDI インスタンスの起動時間が短縮されます。EC2 Image Builder を使用すると、AMIs を構築して新しいソフトウェアスタックとして登録できます。Image Builder の詳細については、「Image Builder ユーザーガイド」を参照してください。

開始する前に、最新バージョンの RES をデプロイする必要があります。

RES 環境にアクセスするための IAM ロールを準備する

EC2 Image Builder から RES 環境サービスにアクセスするには、RES-EC2InstanceProfileForImageBuilder という IAM ロールを作成または変更する必要があります。Image Builder で使用する IAM ロールの設定については、Image Builder ユーザーガイドAWS Identity and Access Management (IAM) を参照してください。

ロールには以下が必要です。
  • Amazon EC2 サービスを含む信頼関係。

  • AmazonS3ReadOnlyAccess、AmazonSSMManagedInstanceCore、EC2InstanceProfileForImageBuilder ポリシー。

EC2 Image Builder コンポーネントを作成する

「Image Builder ユーザーガイド」の「Image Builder コンソールを使用してコンポーネントを作成する」の指示に従います。

コンポーネントの詳細を入力します。
  1. Type でBuild を選択します。

  2. イメージオペレーティングシステム (OS) の場合は、Linux または Windows を選択します。

  3. コンポーネント名には、 などのわかりやすい名前を入力しますresearch-and-engineering-studio-vdi-<operating-system>

  4. コンポーネントのバージョン番号を入力し、オプションで説明を追加します。

    key : value
  5. 定義ドキュメントには、次の定義ファイルを入力します。エラーが発生した場合、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: 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'
  6. オプションのタグを作成し、コンポーネントの作成を選択します。

EC2 Image Builder レシピを準備する

EC2 Image Builder レシピでは、新しいイメージを作成するための開始点として使用するベースイメージと、イメージをカスタマイズしてすべてが期待どおりに動作することを確認するために追加する一連のコンポーネントを定義します。レシピを作成または変更して、必要な RES ソフトウェアの依存関係を持つターゲット AMI を構築する必要があります。レシピの詳細については、「レシピの管理」を参照してください。

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)

  • Windows Server 2019、2022 (x86)

  • Windows 10、11 (x86)

Create a new recipe
  1. で EC2 Image Builder コンソールを開きますhttps://console.aws.amazon.com/imagebuilder

  2. 保存済みリソースで、イメージレシピを選択します。

  3. [イメージレシピの作成] を選択します。

  4. 一意の名前とバージョン番号を入力します。

  5. RES でサポートされているベースイメージを選択します。

  6. インスタンス設定で、SSM エージェントがプリインストールされていない場合はインストールします。ユーザーデータおよびその他の必要なユーザーデータに情報を入力します。

  7. Linux ベースのレシピの場合は、Amazon が管理するaws-cli-version-2-linuxビルドコンポーネントをレシピに追加します。RES インストールスクリプトは AWS CLI を使用して、DynamoDB クラスター設定の設定値への VDI アクセスを提供します。Windows では、このコンポーネントは必要ありません。

  8. Linux または Windows 環境用に作成された EC2 Image Builder コンポーネントを追加します。

    重要

    Linux 環境では、aws-cli-version-2-linuxビルドコンポーネントを最初に追加した状態で、これらのコンポーネントを追加する必要があります。

    ビルドコンポーネントの追加を示すコンポーネントページ
  9. (推奨) Amazon が管理するsimple-boot-test-<linux-or-windows>テストコンポーネントを追加して、AMI を起動できることを確認します。これは最小限の推奨事項です。要件を満たす他のテストコンポーネントを選択できます。

  10. 必要に応じてオプションのセクションを完了し、他の必要なコンポーネントを追加して、レシピの作成を選択します。

Modify a recipe

既存の EC2 Image Builder レシピがある場合は、次のコンポーネントを追加して使用できます。

  1. Linux ベースのレシピの場合は、Amazon が管理するaws-cli-version-2-linuxビルドコンポーネントをレシピに追加します。RES インストールスクリプトは を使用して AWS CLI 、DynamoDB クラスター設定の設定値への VDI アクセスを提供します。Windows では、このコンポーネントは必要ありません。

  2. Linux または Windows 環境用に作成された EC2 Image Builder コンポーネントを追加します。

    重要

    Linux 環境では、aws-cli-version-2-linuxビルドコンポーネントを最初に追加した状態で、これらのコンポーネントを追加する必要があります。

    ビルドコンポーネントの追加を示すコンポーネントページ
  3. 必要に応じてオプションのセクションを完了し、他の必要なコンポーネントを追加して、レシピの作成を選択します。

EC2 Image Builder インフラストラクチャを設定する

インフラストラクチャ設定を使用して、Image Builder が Image Builder イメージの構築とテストに使用する Amazon EC2 インフラストラクチャを指定できます。RES で使用するには、新しいインフラストラクチャ設定を作成するか、既存の設定を使用するかを選択できます。

Image Builder インフラストラクチャを設定するには:
  1. IAM ロールには、 で以前に設定したロールを入力しますRES 環境にアクセスするための IAM ロールを準備する

  2. インスタンスタイプでは、4 GB 以上のメモリを持つタイプを選択し、選択したベース AMI アーキテクチャをサポートします。Amazon EC2 インスタンスタイプ」を参照してください。

  3. VPC、サブネット、およびセキュリティグループの場合、ソフトウェアパッケージをダウンロードするためにインターネットアクセスを許可する必要があります。RES 環境の cluster-settings DynamoDB テーブルと Amazon S3 クラスターバケットへのアクセスも許可する必要があります。

Image Builder イメージパイプラインを設定する

Image Builder イメージパイプラインは、ベースイメージ、構築とテスト用のコンポーネント、インフラストラクチャ設定、およびディストリビューション設定をアセンブルします。RES 対応 AMIs のイメージパイプラインを設定するには、新しいパイプラインを作成するか、既存のパイプラインを使用するかを選択できます。詳細については、Image Builder ユーザーガイドの「AMI イメージパイプラインの作成と更新」を参照してください。

Create a new Image Builder pipeline
  1. で Image Builder コンソールを開きますhttps://console.aws.amazon.com/imagebuilder

  2. ナビゲーションペインから、イメージパイプラインを選択します。

  3. 「イメージパイプラインの作成」を選択します。

  4. 一意の名前、オプションの説明、スケジュール、頻度を入力して、パイプラインの詳細を指定します。

  5. 「レシピを選択する」で、「既存のレシピを使用する」を選択し、「」で作成したレシピを選択しますEC2 Image Builder レシピを準備する。レシピの詳細が正しいことを確認します。

  6. イメージ作成プロセスを定義する では、ユースケースに応じてデフォルトワークフローまたはカスタムワークフローを選択します。ほとんどの場合、デフォルトのワークフローで十分です。詳細については、EC2 Image Builder パイプラインのイメージワークフローを設定する」を参照してください。

  7. 「インフラストラクチャ設定の定義」で、「既存のインフラストラクチャ設定の選択」を選択し、「」で作成したインフラストラクチャ設定を選択しますEC2 Image Builder インフラストラクチャを設定する。インフラストラクチャの詳細が正しいことを確認します。

  8. ディストリビューション設定を定義する で、サービスのデフォルトを使用してディストリビューション設定を作成する を選択します。出力イメージは、RES 環境 AWS リージョン と同じ に存在する必要があります。サービスのデフォルトを使用すると、Image Builder が使用されているリージョンにイメージが作成されます。

  9. パイプラインの詳細を確認し、パイプラインの作成を選択します。

Modify an existing Image Builder pipeline
  1. 既存のパイプラインを使用するには、 で作成されたレシピを使用するように詳細を変更しますEC2 Image Builder レシピを準備する

  2. [Save changes] (変更の保存) をクリックします。

Image Builder イメージパイプラインを実行する

設定された出力イメージを生成するには、イメージパイプラインを開始する必要があります。イメージレシピのコンポーネント数によっては、構築プロセスに最大 1 時間かかる場合があります。

イメージパイプラインを実行するには:
  1. イメージパイプラインから、 で作成されたパイプラインを選択しますImage Builder イメージパイプラインを設定する

  2. アクションから、パイプラインの実行を選択します。

RES に新しいソフトウェアスタックを登録する

  1. 「」の指示に従ってソフトウェアスタック (AMIs)、ソフトウェアスタックを登録します。

  2. AMI ID には、 に構築された出力イメージの AMI ID を入力しますImage Builder イメージパイプラインを実行する