EC2Launch v2 の最新バージョンのインストール - Amazon Elastic Compute Cloud

EC2Launch v2 の最新バージョンのインストール

EC2Launch v2 エージェントを EC2 インスタンスにインストールするには、次のいずれかの方法を使用できます。

  • Amazon S3 からエージェントをダウンロードし、Windows PowerShell を使用してインストールします。ダウンロード URL については、「EC2Launch v2 を Amazon S3 でダウンロード」を参照してください。

  • SSM ディストリビューターでインストールする

  • EC2 Image Builder コンポーネントからインストールする

  • EC2Launch v2 がプリインストールされている AMI からインスタンスを起動する

警告

AmazonEC2Launch.msi は、EC2Launch (v1) や EC2Config などの以前のバージョンの EC2 起動サービスをアンインストールします。

インストール手順については、お好みの方法に合ったタブを選択してください。

Windows PowerShell

Windows PowerShell で EC2Launch v2 エージェントの最新バージョンをインストールするには、以下の手順に従ってください。

  1. ローカルディレクトリを作成する

    New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory
  2. ダウンロード場所の URL を設定します。使用する Amazon S3 URL を使用して次のコマンドを実行します。ダウンロード URL については、「EC2Launch v2 を Amazon S3 でダウンロード」を参照してください。

    $Url = "Amazon S3 URL/AmazonEC2Launch.msi"
  3. 次の複合コマンドを使用して、エージェントをダウンロードしてインストールします。

    $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf) Invoke-WebRequest -Uri $Url -OutFile $DownloadFile msiexec /i "$DownloadFile"
  4. インストールを確認するには、msi ファイルがインスタンス の EC2Launch v2 ディレクトリに存在することを確認します(C:\ProgramData\Amazon\EC2Launch)。

AWS Systems Manager Distributor

AWSEC2Launch-Agent パッケージは、AWS Systems Manager  ディストリビューターからインストールできます。Systems Manager Distributor からパッケージをインストールする方法については、「AWS Systems Manager ユーザーガイド」の「パッケージをインストールまたは更新する」をご参照ください。

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」を参照してください。

AMI

EC2Launch v2 は、以下の Windows Server 2022 に加えて UEFI AMI にもデフォルトでプリインストールされています。

  • Windows_Server-2022-English-Full-Base

  • Windows_Server-2022-English-Core-Base

  • その他すべての言語の Windows Server 2022 AMI

  • SQL がインストールされた Windows Server 2022 AMI

  • Windows_Server-2022-English-Core-EKS_Optimized

EC2Launch v2 は次の Windows Server AMI にもプリインストールされています。これらの AMI は Amazon EC2 コンソールから、または AWS CLI の EC2LaunchV2- の検索プレフィックスを使用して検索できます。

  • EC2LaunchV2-Windows_Server-2019-English-Core-Base

  • EC2LaunchV2-Windows_Server-2019-English-Full-Base

  • EC2LaunchV2-Windows_Server-2016-English-Core-Base

  • EC2LaunchV2-Windows_Server-2016-English-Full-Base

  • EC2LaunchV2-Windows_Server-2012_R2_RTM-English-Full-Base

  • EC2LaunchV2-Windows_Server-2012_RTM-English-Full-Base

EC2Launch v2 を Amazon S3 でダウンロード

最新バージョンの EC2Launch v2 をインストールするには、以下のいずれかの場所からインストーラーをダウンロードします。

注記

32 ビットのインストールリンクは廃止の予定です。EC2Launch v2 をインストールするときは、64 ビットのインストールリンクを使用することが推奨されます。32 ビットの起動エージェントが必要な場合は、EC2Config をご使用ください。

インストールオプションを設定する

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 のアップグレード設定。
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 のバージョンを検証するには、次のいずれかの手順を使用します。

Windows PowerShell

次のように、Windows PowerShell を使用して、インストールされている EC2Launch v2 のバージョンを確認します。

  1. AMI からインスタンスを起動して接続します。

  2. PowerShell で以下のコマンドを実行して、インストールされている EC2Launch v2 のバージョンを検証します。

    & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version
Windows Control Panel

Windows のコントロール パネルで、インストールされている EC2Launch v2 のバージョンを検証するには、以下に従います。

  1. AMI からインスタンスを起動して接続します。

  2. Windows の [コントロールパネル] を開き、[プログラムと機能] を選択します。

  3. インストールされたプログラムのリストで Amazon EC2Launch を探します。バージョン番号は [Version] 列に表示されています。

Windows AMI に含まれる EC2Launch v2 のバージョン情報については、「AWS Windows AMI」を参照してください。

EC2Launch v2 の最新バージョンについては、「EC2Launch v2 のバージョン履歴」を参照してください。

最新バージョンの EC2Launch v2 移行ツールについては、「EC2Launch v2 移行ツールのバージョン履歴」を参照してください。

EC2Launch v2 サービスの新しいバージョンがリリースされた際には、通知を受け取ることができます。詳細については、「EC2Launch v2 サービスの通知へのサブスクライブ」を参照してください。