# EC2Launch v2 の最新バージョンのインストール EC2Launch v2 エージェントを EC2 インスタンスにインストールするには次のいずれかの方法を使用できます。 + Amazon S3 からエージェントをダウンロードし、Windows PowerShell を使用してインストールします。ダウンロード URL については「[EC2Launch v2 を Amazon S3 でダウンロード](#lv2-download-s3)」を参照してください。 + SSM ディストリビューターでインストールする + カスタムイメージの作成時に EC2 Image Builder コンポーネントからインストールします。 + EC2Launch v2 がプリインストールされている AMI からインスタンスを起動する **警告** AmazonEC2Launch.msi はEC2Launch (v1) や EC2Config などの以前のバージョンの EC2 起動サービスをアンインストールします。 インストール手順についてはお好みの方法に合ったタブを選択してください。 ------ #### [ PowerShell ] Windows PowerShell で EC2Launch v2 エージェントの最新バージョンをインストールするには以下の手順に従ってください。 1. ローカルディレクトリを作成する ``` New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory ``` 1. ダウンロード場所の URL を設定します。使用する Amazon S3 URL を使用して次のコマンドを実行します。ダウンロード URL については「[EC2Launch v2 を Amazon S3 でダウンロード](#lv2-download-s3)」を参照してください。 ``` $Url = "Amazon S3 URL/AmazonEC2Launch.msi" ``` 1. 次の複合コマンドを使用して、エージェントをダウンロードしてインストールします。 ``` $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf) Invoke-WebRequest -Uri $Url -OutFile $DownloadFile msiexec /i "$DownloadFile" ``` **注記** ファイルのダウンロード時にエラーが表示され、Windows Server 2016 以前のバージョンを使用している場合は、PowerShell ターミナルで TLS 1.2 を有効にする必要がある場合があります。次のコマンドで現在の PowerShell セッションの TLS 1.2 を有効にしてから、もう一度試してください。 ``` [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 ``` 1. **msiexec** コマンドはWindows Server インスタンスの `%ProgramFiles%\Amazon\EC2Launch` に EC2Launch v2 をインストールします。インストールが実行されたことを検証するにはインスタンスのローカルファイルシステムを確認できます。 ------ #### [ AWS Systems Manager Distributor ] AWS Systems Manager Quick Setup で EC2Launch v2 の自動更新を設定する方法については「[ディストリビューター Quick Setup で自動的にインストールおよび更新する](#lv2-distributor-quick-setup)」を参照してください。 AWS Systems Manager ディストリビューターから `AWSEC2Launch-Agent` パッケージを 1 回だけインストールすることもできます。Systems Manager Distributor からパッケージをインストールする方法については「AWS Systems Manager ユーザーガイド」の「[パッケージをインストールまたは更新する](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html)」をご参照ください。 ------ #### [ EC2 Image Builder component ] EC2 Image Builder でカスタムイメージをビルドするときに、`ec2launch-v2-windows` コンポーネントをインストールできます。EC2 Image Builder でカスタムイメージをビルドする方法については*EC2 Image Builder ユーザーガイド*の[Create an image pipeline using the EC2 Image Builder console wizard](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html)を参照してください。 ------ #### [ AMI ] EC2Launch v2 は次の Windows Server 2022 以降の OS の AMI にデフォルトでプリインストールされています。 + Windows\$1Server-*バージョン*-English-Full-Base + Windows\$1Server-*バージョン*-English-Core-Base + Windows\$1Server-*バージョン*-English-Core-EKS\$1Optimized + 他のすべての言語による Windows Server *バージョン* AMI + SQL がインストールされた Windows Server *バージョン* AMI EC2Launch v2 は次の Windows Server AMI にもプリインストールされています。これらの AMI は Amazon EC2 コンソールから、または AWS CLI の `EC2LaunchV2-` の検索プレフィックスを使用して検索できます。 + EC2LaunchV2-Windows\$1Server-2019-English-Core-Base + EC2LaunchV2-Windows\$1Server-2019-English-Full-Base + EC2LaunchV2-Windows\$1Server-2016-English-Core-Base + EC2LaunchV2-Windows\$1Server-2016-English-Full-Base ------ ## AWS Systems Manager ディストリビューター Quick Setup で EC2Launch v2 を自動的にインストールおよび更新する AWS Systems Manager ディストリビューター Quick Setup で、EC2Launch v2 の自動アップデートを設定できます。以下のプロセスではSystems Manager 関連付けをインスタンスに設定して、指定した頻度で EC2Launch v2 エージェントを自動的に更新します。ディストリビューター Quick Setup が作成する関連付けにはAWS アカウント 内かつリージョン内のインスタンス、または AWS 組織内のインスタンスが含まれる場合があります。組織の設定の詳細については「AWS Organizations ユーザーガイド」の「[チュートリアル: 組織の作成と設定](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_tutorials_basic.html)」を参照してください。 開始する前に、インスタンスがすべての前提条件を満たしていることを確認してください。 ### 前提条件 ディストリビューター Quick Setup で自動更新を設定するにはインスタンスが次の前提条件を満たす必要があります。 + EC2Launch v2 をサポートするインスタンスを 1 つ以上実行している。[EC2Launch v2](ec2launch-v2.md) がサポートされているオペレーティングシステムを参照してください。 + インスタンスで Systems Manager の設定タスクを実行した。詳細については「AWS Systems Manager ユーザーガイド」の「[Systems Manager のセットアップ](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html)」を参照してください。 + インスタンスにインストールされている起動エージェントは EC2Launch v2 のみである必要があります。複数の起動エージェントがインストールされている場合、ディストリビューター Quick Setup 設定は失敗します。ディストリビューター Quick Setup で EC2Launch v2 を設定する前に、EC2Config または EC2Launch v1 起動エージェントが存在する場合はアンインストールします。 ### EC2Launch v2 のディストリビューター Quick Setup の設定 ディストリビューター Quick Setup で EC2Launch v2 の設定を作成するには[ディストリビューターパッケージのデプロイ](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-distributor.html)の手順を完了するときに以下の設定を使用してください。 + **ソフトウェアパッケージ:**Amazon EC2Launch v2 エージェント。 + **更新頻度:**リストから頻度を選択してください。 + **ターゲット:**利用可能なデプロイオプションから選択してください。 設定のステータスを確認するにはAWS マネジメントコンソール で、Systems Manager Quick Setup の **[設定]** タブに移動します。 1. AWS Systems Manager コンソールの [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) を開いてください。 1. ナビゲーションペインで、[**Quick Setup**] を選択してください。 1. **[設定]** タブで、作成した設定に関連付けられている行を選択してください。**[設定]** タブには設定が一覧表示され、**リージョン**、**デプロイステータス**、**関連付けステータス**などの重要な詳細情報の概要が表示されます。 **注記** すべての EC2Launch v2 ディストリビューター設定の関連付け名は`AWS-QuickSetup-Distributor-EC2Launch-Agent-` のプレフィックスで始まります。 1. **詳細を表示するには設定を選択して [詳細を表示] を選択してください。** 詳細とトラブルシューティング手順については「AWS Systems Managerユーザーガイド」の「[Quick Setup の結果のトラブルシューティング](https://docs.aws.amazon.com/systems-manager/latest/userguide/quick-setup-results-troubleshooting.html)」を参照してください。 ## EC2Launch v2 を Amazon S3 でダウンロード 最新バージョンの EC2Launch v2 をインストールするには以下の場所からインストーラーをダウンロードします。 + [https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi](https://s3.amazonaws.com/amazon-ec2launch-v2/windows/amd64/latest/AmazonEC2Launch.msi) ## インストールオプションを設定する EC2Launch v2 をインストールまたはアップグレードする場合、EC2Launch v2 インストールダイアログまたはコマンドラインシェルのコマンド **msiexec**  を使用してインストールオプションを設定できます。 EC2Launch v2 インストーラーをインスタンスで初めて実行すると、インスタンスの起動エージェント設定が次のように初期化されます。 + ローカルパスを作成し、そこに起動エージェントファイルを書き込みます。これはクリーンインストールと呼ばれることもあります。 + `EC2LAUNCH_TELEMETRY` 環境変数が存在しない場合は作成され、設定に基づいて設定されます。 設定の詳細については使用する設定方法に合ったタブを選択してください。 ------ #### [ Amazon EC2Launch Setup dialog ] EC2Launch v2 をインストールまたはアップグレードする場合、EC2Launch v2 インストールダイアログから次のインストールオプションを設定できます。**ベーシックインストール**オプション **テレメトリを送信する** この機能をセットアップダイアログに含めると、インストーラーは`EC2LAUNCH_TELEMETRY`環境変数を次の値に`1`。**[テレメトリを送信]** を無効にした場合、インストーラーは環境変数を `0` の値に設定します。 EC2Launch v2 エージェントが実行されると、`EC2LAUNCH_TELEMETRY` 環境変数を読み取り、テレメトリデータをアップロードするかどうかを決定します。値が `1` の場合、データをアップロードします。そうしないと、アップロードされません。 **デフォルト設定** EC2Launch v2 のデフォルト設定ではローカル起動エージェントがすでに存在する場合はそれを上書きします。インスタンスで初めてインストールを実行すると、デフォルト設定でクリーンインストールが実行されます。初回インストール時にデフォルト設定を無効にすると、インストールは失敗します。 インスタンスでインストールを再度実行する場合はデフォルト設定を無効にして、`%ProgramData%/Amazon/EC2Launch/config/agent-config.yml` ファイルを置き換えないアップグレードを実行できます。 **例: テレメトリによる EC2Launch v2 のアップグレード** 次の例は現在のインストールをアップグレードしてテレメトリを有効にするように設定された EC2Launch v2 セットアップダイアログを示しています。この設定ではエージェント設定ファイルを置き換えずにインストールを実行し、`EC2LAUNCH_TELEMETRY` 環境変数を `1` の値に設定します。 ![\[EC2Launch v2 のアップグレード設定。\]](http://docs.aws.amazon.com/ja_jp/AWSEC2/latest/UserGuide/images/ec2launchv2-clean-default-config.png) ------ #### [ Command line ] EC2Launch v2 をインストールまたはアップグレードする場合、コマンドラインシェルの **msiexec** コマンドを使用して次のインストールオプションを設定できます。`ADDLOCAL` パラメータ値 **Basic**(必須) 起動エージェントをインストールします。この値が `ADDLOCAL` パラメータに存在しない場合、インストールは終了します。 **Clean** `ADDLOCAL` パラメータに `Clean` の値を含めると、インストーラはエージェント設定ファイルを `%ProgramData%/Amazon/EC2Launch/config/agent-config.yml` の場所に書き込みます。エージェント設定ファイルがすでに存在する場合、ファイルは上書きされます。 `ADDLOCAL` パラメータの `Clean` 値を省略した場合、インストーラはエージェント設定ファイルを置き換えないアップグレードを実行します。 **Telemetry** `ADDLOCAL` パラメータに `Telemetry` の値を含めると、インストーラは `EC2LAUNCH_TELEMETRY` 環境変数を `1` の値に設定します。 `ADDLOCAL` パラメータから `Telemetry` の値を省略した場合、インストーラは環境変数を `0` の値に設定します。 EC2Launch v2 エージェントが実行されると、`EC2LAUNCH_TELEMETRY` 環境変数を読み取り、テレメトリデータをアップロードするかどうかを決定します。値が `1` の場合、データをアップロードします。そうしないと、アップロードされません。 **例: テレメトリを使用した EC2Launch v2 のインストール** ``` & msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q ``` ------ ## EC2Launch v2 のバージョンを検証する インスタンスにインストールされている EC2Launch v2 のバージョンを検証するには次のいずれかの手順を使用します。 ------ #### [ PowerShell ] 次のように、Windows PowerShell を使用して、インストールされている EC2Launch v2 のバージョンを確認します。 1. AMI からインスタンスを起動して接続します。 1. PowerShell で以下のコマンドを実行して、インストールされている EC2Launch v2 のバージョンを検証します。 ``` & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version ``` ------ #### [ Windows Control Panel ] Windows のコントロール パネルで、インストールされている EC2Launch v2 のバージョンを検証するには以下に従います。 1. AMI からインスタンスを起動して接続します。 1. Windows の [コントロールパネル] を開き、**[プログラムと機能]** を選択してください。 1. インストールされたプログラムのリストで `Amazon EC2Launch` を探します。バージョン番号は [**Version**] 列に表示されています。 ------ AWS Windows AMI の最新のアップデートを確認するにはAWS Windows AMI リファレンスの「[Windows AMI のバージョン履歴](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html)」を参照してください。 EC2Launch v2 の最新バージョンは[EC2Launch v2 のバージョン履歴](ec2launchv2-versions.md#ec2launchv2-version-history)でご確認ください。 EC2Launch v2 サービスの新しいバージョンがリリースされた際には通知を受け取ることができます。詳細については「[EC2 Windows 起動エージェント通知をサブスクライブする](launch-agents-subscribe-notifications.md)」を参照してください。