Amazon AppStream 2.0 で VHD のセットアップスクリプトを作成する

AppStream 2.0 は、ユーザー提供のセットアップスクリプトを使用して、アプリケーションを起動する前に VHD をマウントします。セットアップスクリプトは、アプリケーションを動作させるために必要なその他のタスクを完了するために使用することもできます。例えば、レジストリキーの設定、DLL の登録、前提条件の管理、またはセットアップスクリプトからのユーザープロファイルの変更を行うことができます。AppStream 2.0 は、VHD のマウントに使用できるスクリプトサンプルを提供します。これらのスクリプトは、お使いの VHD とアプリケーションのニーズに合わせて変更する必要があります。

注記

AppStream 2.0 パッケージの App Block には、セットアップスクリプトは必要ありません。ただし、オプションでセットアップ後のスクリプトを使用することで、アプリケーションのインストールをカスタマイズできます。

サンプルスクリプトをダウンロードするには、次のリンクを使用します。

• Amazon Linux 2 bash スクリプト

• Microsoft Windows PowerShell スクリプト

  注記

  AppStream 2.0 および Microsoft Windows オペレーティングシステムは、ドライブ文字 A～E を予約します。これらのドライブ文字に VHD またはネットワーク共有をマウントしないでください。

AppStream 2.0 は、セットアップスクリプトと VHD をフリートストリーミングインスタンス上のディレクトリにダウンロードしてから、セットアップスクリプトを実行します。セットアップスクリプトは、完全な管理者権限を用いてオペレーティングシステム上で実行されます。セットアップスクリプトは、Microsoft Windows の SYSTEM コンテキスト内で実行、および Amazon Linux 2 の root ユーザーとして実行されます。

VHD とセットアップスクリプトのファイルシステムの場所は以下のとおりです。

• Amazon Linux 2:

  /opt/appstream/AppBlocks/appblock-name/

  appblock-name

  VHD とセットアップスクリプトに対応する App Block の名前です。

• Microsoft Windows:

  C:\AppStream\AppBlocks\appblock-name\

  appblock-name

  VHD とセットアップスクリプトに対応する App Block の名前です。

AppStream 2.0 は、ファイル名をオブジェクト上にあるものとして維持します。例えば、App Block の名前が MyApps で、apps.vhd という名前の VHD と mount-apps.ps1 という名前のセットアップスクリプトがある場合、Windows ストリーミングインスタンス上のフルパスは以下のようになります。

• VHD

  C:\AppStream\AppBlocks\MyApps\apps.vhd

• セットアップスクリプト

  C:\AppStream\AppBlocks\MyApps\mount-apps.ps1

AppStream 2.0 は、セットアップスクリプトがフリートストリーミングインスタンスで実行されるときにセットアップスクリプトからの標準エラーと標準出力をキャプチャして、出力をアカウント内の Amazon S3 バケットにアップロードします。これらのログを使用して、セットアップスクリプトで発生する可能性のある問題を特定し、解決することができます。バケットは、以下にあるような特定の形式で命名されます。

appstream-logs-region-code-account-id-without-hyphens-random-identifier

region-code

これは、Elastic フリートが作成される AWS リージョンコードです。

account-id-without-hyphens

AWS アカウント識別子。ランダムな ID は、そのリージョン内のその他バケットとの競合が発生しないことを確実にします。バケット名の最初の部分である appstream-logs は、アカウントおよびリージョンに応じて変化するものではありません。

例えば、アカウント番号 123456789012 で米国西部 (オレゴン) リージョン (us-west-2) に Elastic フリートを作成する場合、AppStream 2.0 は、このリージョン内のアカウントに、以下に記載されている名前の Amazon S3 バケットを作成します。適切なアクセス許可を持つ管理者のみが、このバケットを削除できます。

appstream-logs-us-west-2-1234567890123-abcdefg

アカウントの S3 バケットでログファイルが保存されているフォルダへのパスは、以下の構造になります。

bucket-name/fleet-name/instance-id/appblock-name/

bucket-name

セッションスクリプトログが保存されている Amazon S3 バケットの名前です。名前の形式については、このセクションで先ほど説明しました。

Instance-id

セットアップスクリプトが実行されたストリーミングインスタンスの一意の識別子です。

appblock-name

セットアップスクリプトに対応する App Block の名前です。

以下のフォルダ構造の例は、test-fleet で始まるストリーミングセッションに該当します。セッションは 123456789012 の AWS アカウント ID からのもので、appblock 名は米国西部 (オレゴン) リージョン (us-west-2) の testappblock です。

appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/

このフォルダ構造の例には、標準出力用のログファイルが 1 つ、および標準エラー用のログファイルが 1 つ含まれています。

トピック

• Amazon AppStream 2.0 での App Block 設定スクリプトの実行