Amazon WorkSpaces Core マネージドインスタンス用の準備済みイメージを作成する
MCS マシンカタログを作成するには、準備済みイメージを作成します。準備済みイメージは、次の方法で作成できます。
主な手順
- イメージ定義と初期イメージバージョンを作成します。
- 初期イメージバージョンからイメージバージョンを作成します。
ウェブスタジオを使用する
イメージ定義と初期イメージバージョンを作成する
イメージ定義と初期イメージバージョンを作成するには、次の手順を実行します。
- Web Studio から、[イメージ] ノードに移動し、[イメージ定義の作成] をクリックします。[はじめに] ページで [次へ] をクリックします。
- [イメージ定義] ページで、イメージ定義の [OS タイプ] と [セッションタイプ] を指定します。
-
[イメージ] ページで、[リソース] (設定された接続に適用可能なリソースのみが一覧表示されます)、イメージバージョンを作成するためのテンプレートとして使用するマスターイメージ、およびハードウェアプロパティをキャプチャするためのマシンプロファイルを選択します。VM インスタンスまたは起動テンプレートバージョンからハードウェアプロパティをキャプチャするためのマシンプロファイルを選択します。
注：
- イメージを選択する前に、マスターイメージに VDA 2311 以降がインストールされており、MCSIO ドライバーが VDA にインストールされていることを確認してください。
- インスタンスメタデータサービス (IMDS) V2 のみがサポートされており、IMDS V1 はサポートされていません。詳細については、「インスタンスメタデータサービスバージョン2の仕組み」を参照してください。
- マシン仕様ページで、マシンサイズを選択します。マシンプロファイル（イメージページで選択）のマシンサイズがデフォルトで選択されています。
- NICページで、準備イメージのNICを選択または追加します。各NICについて、関連するVPCサブネットを選択します。
- バージョン説明ページで、作成された初期イメージバージョンの説明を入力します。
- 概要ページで、イメージ定義と作成された初期イメージバージョンの詳細を確認します。イメージ定義の名前と説明を入力します。完了をクリックします。
イメージバージョンを作成する
イメージバージョンを使用すると、特定のイメージに対するさまざまなイテレーションや更新を管理できます。この機能により、さまざまな目的のためにイメージの複数のバージョンを維持できます。
初期イメージバージョンからイメージバージョンを作成するには、次の手順を実行します。
注：
すべてのイメージバージョンのホスティングユニットは同じである必要があります。
- イメージノードに移動し、イメージバージョンまたはイメージ定義を選択し、イメージバージョンを作成をクリックします。
- イメージ定義ページで、ホスティングユニットを変更し、そのイメージバージョンのマスターイメージとマシンプロファイルを再選択できます。
- イメージバージョンの構成を、最初に構成されたイメージバージョンと異なるものにしたい場合は、イメージバージョンを作成ダイアログのマシン仕様ページとNICページで設定を構成します。
- イメージバージョンの説明を追加します。完了をクリックします。
注：
イメージバージョンの作成が何らかの理由で失敗した場合、下部にあるトラブルシューティングタブに再試行オプションが表示されます。
パワーシェルを使用する
準備されたイメージバージョン仕様を作成するための詳細なPowerShellコマンドは次のとおりです。
-
Test-ProvImageDefinitionNameAvailable commandを使用して、利用可能なイメージ定義名を確認します。例：Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]> <!--NeedCopy--> -
New-ProvImageDefinitionコマンドを使用してイメージ定義を作成します。例：New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession <!--NeedCopy--> -
Add-ProvImageDefinitionConnectionコマンドを使用して、指定されたホスティング接続でイメージ定義の新しい構成を作成します。Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn <!--NeedCopy--> -
New-ProvImageVersionコマンドを使用してイメージバージョンを作成します。例：New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1" <!--NeedCopy--> -
Add-ProvImageVersionSpecコマンドを使用して、マスターイメージバージョン仕様をイメージバージョンに追加します。例：Add-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”" <!--NeedCopy-->注：
ホスティングユニットの1つのイメージバージョンには、マスターイメージバージョン仕様を1つだけ追加できます。
-
New-ProvImageVersionSpecコマンドを使用して、マスターイメージバージョン仕様から準備されたイメージバージョン仕様を作成します。SourceImageVersionSpecUidパラメーターはAdd-ProvImageVersionSpecコマンドから派生します。例：New-ProvImageVersionSpec -SourceImageVersionSpecUid 00000000-0000-0000-0000-00000000000 -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously <!--NeedCopy-->
イメージ定義、イメージバージョン、および準備されたイメージバージョン仕様を作成するためのPowerShellコマンドの完全なセットの例：
New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc -CustomProperties $CustomProperties
$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
-HostingUnitUid $hostingunit.HostingUnitUid `
-MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”
New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->
注：
- イメージ定義内のすべてのイメージバージョン仕様は、同じホスティングユニットに属している必要があります。
- イメージバージョンには、マスターイメージバージョン仕様を1つと、準備されたイメージバージョン仕様を1つだけ含めることができます。
- すべてのイメージバージョン仕様には、マシンプロファイルが必要です。
準備済みイメージをアベイラビリティゾーンとリージョン間で共有する
Amazon WorkSpaces Core マネージドインスタンスの場合、単一の準備済みイメージを、同じAWSリージョン内または異なるリージョン内の、異なるホスティングユニットに紐付けられた複数のアベイラビリティゾーン間で共有できるようになりました。これにより、1つの準備済みイメージを使用して、さまざまなアベイラビリティゾーンとリージョンでMCSマシンカタログを作成および更新できます。異なるリージョン内の異なるAZ間で共有する場合、準備済みイメージバージョンは元のリージョンから宛先リージョンにコピーされます。
単一の準備済みイメージを維持し、それを使用して、異なるホスティングユニットに紐付けられた複数のアベイラビリティゾーンとリージョン間でマシンカタログを作成および更新できます。これにより、イメージ管理のオーバーヘッドが大幅に削減され、展開全体の一貫性が確保され、プロビジョニングプロセスが合理化されます。また、既存のマシンカタログを、異なるアベイラビリティゾーンまたはリージョンからの準備済みイメージでシームレスに更新することもできます。
ユースケース
-
集中型イメージ管理: 1つのアベイラビリティゾーン（例:
us-east-1a）で準備済みイメージを作成します。その後、このイメージを、同じus-east-1AWSリージョン内のus-east-1bのような他のアベイラビリティゾーン、または異なるus-west-1リージョン内のus-west-1aに共有できます。これにより、単一のイメージで複数のホスティングユニットに対応でき、メンテナンスが簡素化されます。 -
効率的なカタログ作成と更新:
AZ 1で作成された準備済みイメージ（例:us-east-1a）を使用して、AZ 1に新しいカタログを作成できます。このイメージをAZ 2（例:us-east-1b）に共有した後、AZ 2で共有されたイメージを使用して、AZ 2のカタログを作成および更新できます。 - ホスティングユニット間およびホスティング接続の展開: 環境に同じまたは異なるAWSリージョンおよびAWSアカウントの下に複数のホスティングユニットがある場合、これらのホスティングユニット間で準備済みイメージを効率的に共有できます。
制限事項
- 同じAWSアカウント内での共有: 現在の実装では、異なるAWSアカウント間で共有することはできません。
重要な考慮事項
- 削除順序: 元の準備済みイメージバージョン仕様を削除するには、まずその共有イメージバージョン仕様をすべて削除する必要があります。あるいは、元の仕様と共有仕様を同時に削除する必要があります。
- イメージバージョンの依存関係: イメージバージョンを削除する場合、まずその特定のイメージバージョンに依存する共有構成をすべて削除する必要があります。元の（共有されていない）イメージから作成したカタログはそのまま残すことができます。
- カタログのバックポート可能性: この機能が導入される前に展開した既存のマシンカタログを更新できます。カタログを最初に展開した場所とは異なるアベイラビリティゾーンまたはリージョンで作成した準備済みイメージを使用します。
- 完全削除: 準備済みイメージを削除すると、共有または最初に作成したどのアベイラビリティゾーンでも使用できなくなります。さらに、準備済みイメージバージョンに紐付けられたすべてのカタログが最初に削除されるまで、準備済みイメージバージョンを削除することはできません。
前提条件
この機能を構成または使用する前に、次の条件を満たしていることを確認してください。
- お使いの環境は、Amazon WorkSpaces Core マネージドインスタンス環境である必要があります。
- 同じAWSアカウントで、複数のホスティングユニット（それぞれ異なるアベイラビリティゾーンに紐付け可能）とホスト接続（それぞれ異なるリージョンに紐付け可能）を構成する必要があります。
Web Studio UI を使用して構成する
Web Studio UI を使用して、異なるホスティングユニットに紐付けられたアベイラビリティゾーン間で準備済みイメージを共有できます。
準備済みイメージを共有するには
- Web Studio の Images ノードに移動し、他のアベイラビリティゾーンと共有したい準備済みイメージバージョンを選択します。
- 上部のナビゲーションバーで Manage Image Share を選択し、選択したイメージバージョンのイメージ共有を管理します。
- On the Manage Image Share ページで、イメージバージョンを共有したいリソースを1つ以上選択します。リソースは、元のイメージバージョンとは異なるアベイラビリティゾーンに存在できます。
- Save をクリックして、他のアベイラビリティゾーンのリソースでイメージバージョンを共有します。イメージバージョンは、選択した異なるリソース間で共有されるように更新されます。完了したら、イメージバージョンが共有されているアベイラビリティゾーンでカタログを作成するために、そのイメージバージョンを使用します。
準備済みイメージの共有を削除するには
- Web Studio の Images ノードで、共有から削除したい準備済みイメージバージョンを選択します。
- 上部のナビゲーションバーで Manage Image Share を選択し、選択したイメージバージョンのイメージ共有を管理します。
-
イメージバージョンの共有を停止したい1つ以上のリソース（アベイラビリティゾーン）のチェックボックスをオフにします。
注:
リソースには、共有イメージバージョンに関連付けられ、そこから作成されたカタログがこれ以上存在してはなりません。削除される共有イメージバージョンから作成されたカタログは、まず削除する必要があります。
- 保存をクリックして、クリアされたアベイラビリティゾーン間でのリソースの共有を解除します。イメージバージョンが更新され、それらのアベイラビリティゾーンでは共有されなくなります。
PowerShell を使用して構成する
または、PowerShell コマンドを使用して、異なるホスティングユニットに紐付けられたアベイラビリティゾーン間で、準備済みイメージを共有できます。
準備済みイメージを共有するには
- 共有したい準備済みイメージの
ImageVersionSpecUidがあることを確認してください。これは、PowerShellでGet-ProvImageVersionSpecまたは類似のGet-コマンドを使用して取得できます。 - 準備済みイメージを利用可能にしたいアベイラビリティゾーン（同じリージョンでも異なるリージョンでも可）の
HostingUnitNameを特定します。これは、その特定のアベイラビリティゾーン用に構成したホスティングユニットの名前です。 -
Add-ProvImageVersionSpecHostingUnitコマンドを実行します。次のPowerShellコマンドを使用します。<ImageVersionSpecUid>をイメージのUidに、<targetHostingUnitName>をイメージバージョン仕様を共有したいターゲットアベイラビリティゾーンのホスティングユニット名に置き換えます。Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName> <!--NeedCopy--> - 正常に実行された後、Web Studio UIでイメージのステータスを確認でき、指定されたホスティングユニットと共有されたことが示されます。
準備済みイメージの共有を解除するには
- 共有を解除したい準備済みイメージの
ImageVersionSpecUidがあることを確認してください。 - 共有イメージを削除したいアベイラビリティゾーンの
HostingUnitNameを特定します。 -
Remove-ProvImageVersionSpecHostingUnitコマンドを実行します。次のPowerShellコマンドを使用します。<ImageVersionSpecUid>をイメージのUidに、<targetHostingUnitName>をイメージバージョン仕様の共有を解除したいターゲットアベイラビリティゾーンのホスティングユニット名に置き換えます。Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName> <!--NeedCopy-->
次のステップ
- Amazon WorkSpaces Core マネージドインスタンスのカタログを作成する方法については、「Amazon WorkSpaces Core マネージドインスタンスのカタログを作成する」を参照してください。
詳細情報
- イメージ管理
- アマゾン ワークスペース コア の ギットハブ パワーシェル の例については、citrix-mcs-sdk-samples-Amazon WorkSpaces Coreを参照してください。