イメージのインポート

カスタマイズされた EC2 AMIs をインポートすることで、WorkSpaces アプリケーションイメージを作成できます。処理の流れ

1. EC2 Image Builder などの任意の方法を使用して EC2 AMI をカスタマイズします。

2. カスタマイズされた AMI を WorkSpaces アプリケーションにインポートして WorkSpaces アプリケーションイメージを作成する

3. オプションで、Image Builder を使用してイメージをさらにカスタマイズする

AMI のインポートによって作成されたイメージは でtype = "custom"、WorkSpaces アプリケーションが提供するイメージは ですtype = "native"。

でイメージに stream.* インスタンスタイプを使用できますtype = "native"。次のいずれかのインスタンスタイプを使用するには、AMI をインポートし、 でイメージを作成する必要がありますtype = "custom"。

• GeneralPurpose.*

• MemoryOptimized.*

• ComputeOptimized.*

• Accelerated。*

イメージのインポートの前提条件

これらの前提条件はすべて、ワークフローの実行を成功させるために重要です。サポートされている AMI 設定およびその他の必須要件を以下に示します。

必要な AMI プロパティ

EBS

• 500GB 以下のサイズ

  • < 200 GB の AMI をインポートできますが、インポートされたイメージでは最低 200GB が使用されます。

• GP2

  • gp2 または gp3 EBS ボリュームタイプの AMI をインポートできますが、インポートされたイメージは gp2 を使用します。

• イメージあたり 1 ボリューム

• /dev/sda1 ルートデバイス名

• イメージタイプ: マシン

• アーキテクチャ: x86_64

• 仮想化タイプ: HVM

• ブートモード: UEFI

• TPM サポート: v2.0。これは必須です。TPM が有効な AMI を見つけるには、https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find を参照してください。

• ENA サポート: true

• プラットフォーム: Windows

• プラットフォームの詳細: Windows

オペレーティングシステムのプロパティ

Windows Server 2022/2025 フルベース

• Windows Server Core はサポートされていません

• Windows と SQL Server はサポートされていません

[エージェント]  

• EC2 起動 V2 バージョン >= 2.1.1

• SSM エージェントが必要です

ドライバー

• EC2 ENA ドライバーバージョン >= 2.9.0

• EC2 NVMe ドライバーバージョン >= 1.6.0

ライブラリのサポート

• .NET Framework 4.8 以降

  • Windows Server 2022/2025 にデフォルトでインストール

• PowerShell 5.1 以降

  • Windows Server 2022/2025 にデフォルトでインストール

• Windows の機能: リモートデスクトップサービスのライセンスとリモートデスクトップサービスのセッションホストをインストールしないでください

• ポート: ポート 8000、8300、8443 はブロック解除および占有解除する必要があります

• ブートモード: UEFI

Accelerated.g4dn、 Accelerated.g5、 Accelerated.G6、 Accelerated.G6e などのグラフィックスインスタンスでイメージを使用する場合は、AMI に適切な GRID ドライバーをインストールします。詳細については、https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html を参照してください。ただし、ドライバーが正しく設定されていない場合、ストリーミングは機能します。グラフィックカードは使用できない場合があります。

重要

AMI の「所有者アカウント ID」はAWSアカウント ID である必要があります。パブリック EC2 AMI をインポートすることはできません。

イメージをインポートする前に、Windows 更新を実行し、Windows 自動更新を無効にします。

暗号化された EC2 AMIs のインポートは現在サポートされていません

IAM ロールの要件

重要

「イメージのインポートに使用する以下のアクセス許可を持つ IAM ロールを作成します。

{  
    "Version": "2012-10-17",		 	 	   
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}

この IAM ロールに次の信頼関係を追加します。

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

イメージをインポートするには

1. https://console.aws.amazon.com/appstream2 で WorkSpaces アプリケーションコンソールを開きます。

2. 左側のナビゲーションペインで、画像を選択し、画像レジストリを選択します。

3. イメージのインポート を選択します。

4. AMI ID - WorkSpaces アプリケーションにインポートする AMI の AMI ID を入力します。このフィールドを使用して AMI を検索することもできます。

5. イメージ名 - インポートオペレーションのために作成されるイメージの一意の名前を入力します。

6. 表示名 (オプション) - イメージに表示する を入力します。

7. 説明 (オプション) – イメージの説明を入力します。

8. IAM ロール - イメージのインポート用に作成した IAM ロールを選択します。詳細については、「」を参照してくださいIAM ロールの要件。

9. WorkSpaces Applications エージェントの管理 – 常に最新の WorkSpaces Applications エージェントバージョンを使用する場合、ストリーミングインスタンスは、新しいエージェントバージョンがリリースされたAWSときに から利用できる最新の機能、パフォーマンスの向上、およびセキュリティ更新プログラムで自動的に更新されます。

10. ランタイム検証 (オプション): このオプションを選択すると、サービスはインポートされるイメージを使用してインスタンスをプロビジョニングし、ストリーミングテストを実行します。

    • 注記

      これらのストリーミングテストはバックグラウンドで実行されるため、WorkSpaces Applications クライアントを介してこのインスタンスに接続することはできません。

    • イメージが WorkSpaces アプリケーションに適しているという信頼性を高めるには、このオプションを使用することをお勧めします。

    • そのインスタンスの時間料金が請求されます。

    • ストリーミングテストに影響を与えない可能性のある小さな変更を行った後に AMI を再インポートする場合や、ランタイム検証が最後に合格した場合に、この AMI をインポートした場合、ランタイム検証の実行を回避できます。

    • インスタンスタイプを選択 (オプション): ストリーミングテストを実行する適切なインスタンスファミリー、タイプ、サイズを選択します。フリートの作成に使用する予定のインスタンスと同じインスタンスを使用することをお勧めします。

11. アプリケーションカタログと起動パフォーマンスマニフェスト (オプション): エンドユーザー向けのアプリケーションカタログを作成し、アプリケーションの起動パフォーマンスを向上させるための詳細を提供します。

    • アプリケーションカタログ: アプリケーションカタログを作成するには、イメージをインストールしたアプリケーションの詳細を指定します。ストリーミングを計画するアプリケーションごとに、名前、表示名、起動する実行可能ファイルと表示するアイコンを指定できます。

    • 起動パフォーマンス: アプリケーション最適化マニフェストにファイルを追加すると、アプリケーションが新しいフリートインスタンスで初めて起動するまでにかかる時間が短縮されます。最適化マニフェストは、アプリケーションごとの行区切りテキストファイルです。

    詳細については、「」を参照してくださいアプリケーションの詳細。

12. タグ (オプション) - タグの追加を選択し、タグのキーと値を入力します。さらにタグを追加するには、この手順を繰り返します。詳細については、「Amazon WorkSpaces アプリケーションリソースのタグ付け」を参照してください。

13. イメージのインポート – 入力したすべての情報を確認し、イメージのインポートを選択します。サービスは互換性チェックを実行して、AMI が WorkSpaces アプリケーションと互換性があることを確認します。

    • 静的チェックが失敗すると、すぐにエラーが表示されます。

    • 静的チェックに合格すると、インポートリクエストが送信され、選択したオプションによっては、 を使用して新しい WorkSpaces アプリケーションイメージを作成するのに 30～60 分かかる場合があります。 type = "custom"