Windows コンテナの開始方法

このチュートリアルでは、手動で Windows コンテナを Amazon ECS で実行する手順について説明します。Windows コンテナインスタンスのクラスターを作成し、クラスターで 1 つ以上のコンテナインスタンスを起動します。次に、Windows コンテナイメージを使用するタスク定義を登録し、そのタスク定義を使用するサービスを作成して、コンテナが実行するサンプルのウェブページを表示します。

トピック

ステップ 1: Windows クラスターを作成する
ステップ 2: Windows コンテナインスタンスをクラスターで起動する
ステップ 3 (省略可能): Amazon ECS コンテナエージェントのインストール
ステップ 4: Windows タスク定義を登録する
ステップ 5: タスク定義を使用してサービスを作成する
ステップ 6: サービスを表示する

ステップ 1: Windows クラスターを作成する

Windows コンテナの新しいクラスターを作成する必要があります。Linux コンテナインスタンスは Windows コンテナで実行できず、Windows コンテナインスタンスは Linux コンテナで実行できません。したがって、適切なタスク配置を達成するには、Windows コンテナインスタンスと Linux コンテナインスタンスを別々のクラスターで実行します。このチュートリアルでは、Windows コンテナ用の windows というクラスターを作成します。

AWS マネジメントコンソールを使用してクラスターを作成するには

https://console.aws.amazon.com/ecs/ にある Amazon ECS コンソールを開きます。
ナビゲーションペインで [Clusters] を選択します。
[Clusters] ページで、[Create Cluster] を選択します。
[EC2 Windows + Networking]、[Next step] の順に選択します。
[Cluster name] に、クラスターの名前を入力します (この例では、クラスターの名前は windows です)。最大 255 文字の英字 (大文字と小文字)、数字、ハイフン、アンダースコアを使用できます。
[Create an empty cluster]、[Create] の順に選択します。

AWS CLI を使用してクラスターを作成するには

以下のコマンドを使用して AWS CLI でクラスターを作成することもできます。
```
aws ecs create-cluster --cluster-name windows
```

ステップ 2: Windows コンテナインスタンスをクラスターで起動する

このトピックで説明しているように、AWS マネジメントコンソールを使用して Windows コンテナインスタンスを起動できます。開始する前に、必ず「Amazon ECS でのセットアップ」の手順を完了してください。インスタンスを起動したら、そのインスタンスを使用してタスクを実行できます。

Windows コンテナインスタンスを起動するには

https://console.aws.amazon.com/ec2/) にある Amazon EC2 コンソールを開きます。
ナビゲーションバーから、使用するリージョンを選択します。
コンソールダッシュボードで、[Launch Instance] を選択します。

[Amazon マシンイメージ (AMI)] ページに、Windows Amazon ECS に最適化された AMI (推奨) または Amazon ECS 仕様をサポートする別の Windows AMI を選択するオプションがあります。

オプション 1: Windows Amazon ECS 最適化 AMI を使用する。[コミュニティ AMI] を選択します。

[Search community AMIs] フィールドに ECS_Optimized と入力し、Enter キーを押します。Windows_Server-2016-English-Full-ECS_Optimized-2018.07.25 AMI の横にある [Select] を選択します。

参考までに、現在のリージョン別の Amazon ECS-optimized Windows AMI ID を以下に示します。

サービス対象	AMI ID
`us-east-2`	`ami-7cecd619`
`us-east-1`	`ami-884e41f7`
`us-west-2`	`ami-b81048c0`
`us-west-1`	`ami-034ba660`
`eu-west-2`	`ami-702fc517`
`eu-west-3`	`ami-d173c3ac`
`eu-west-1`	`ami-4ff7eda5`
`eu-central-1`	`ami-8017156b`
`ap-northeast-2`	`ami-725fe81c`
`ap-northeast-1`	`ami-005621ed`
`ap-southeast-2`	`ami-26bd1b44`
`ap-southeast-1`	`ami-dabdfb30`
`ca-central-1`	`ami-adbb36c9`
`ap-south-1`	`ami-55e7d53a`
`sa-east-1`	`ami-16eacb7a`
`us-gov-west-1`	`ami-abb02cca`

オプション 2: 別の Windows AMI を使用する。選択する Windows AMI の横にある [選択] を選択します。

[Choose an Instance Type] ページで、インスタンスのハードウェア構成を選択できます。デフォルトでは、t2.micro インスタンスタイプが選択されます。選択したインスタンスタイプによって、タスクの実行に使用できるリソースが決まります。
[Next: Configure Instance Details] を選択します。
[Configure Instance Details] ページで、インスタンスをパブリックインターネットからアクセス可能にするかどうかに応じて、[Auto-assign Public IP] チェックボックスを設定します。インスタンスをインターネットからアクセス可能にする場合は、[Auto-assign Public IP] フィールドが [Enable] に設定されていることを確認します。インスタンスをインターネットからアクセス不可にする場合は、[Disable] を選択します。

注記

コンテナインスタンスには、Amazon ECS サービスエンドポイントと通信するために外部ネットワークアクセスが必要なため、コンテナインスタンスにパブリック IP アドレスがない場合は、NAT (ネットワークアドレス変換) を使用してこのアクセスを提供する必要があります。詳細については、Amazon VPC ユーザーガイドの「NAT ゲートウェイ」およびこのガイドの「HTTP プロキシ設定」を参照してください。詳細については、「チュートリアル: クラスターのパブリックサブネットとプライベートサブネットを持つ VPC を作成する」を参照してください。
[Configure Instance Details] ページで、IAM role] の値に「Amazon ECS でのセットアップ」でコンテナインスタンス用に作成した ecsInstanceRoleを選択します。

重要

適切な IAM アクセス権限を使用してコンテナインスタンスを起動しないと、Amazon ECS エージェントはクラスターに接続されません。詳細については、「Amazon ECS コンテナインスタンスの IAM ロール」を参照してください。
Amazon ECS 最適化 AMI を使用している場合は、[高度な詳細] セクションを展開し、提供されたユーザーデータの PowerShell スクリプトを [ユーザーデータ] フィールドに貼り付けます。デフォルトでは、このスクリプトによって、前に作成した windows クラスターにコンテナインスタンスが登録されます。windows 以外のクラスターで起動するには、以下のスクリプトで赤のテキストを、起動先のクラスターの名前に置き換えます。

Amazon ECS 最適化 AMI を使用していない場合は、次のステップに進みます。

注記

この -EnableTaskIAMRole オプションは、タスクの IAM ロールを有効にするために必要です。詳細については、「Windows タスク用の IAM ロール」を参照してください。
```
<powershell>
Import-Module ECSTools
Initialize-ECSAgent -Cluster 'windows' -EnableTaskIAMRole
</powershell>
```
[次の手順: ストレージの追加] を選択します。
[Add Storage] ページで、コンテナインスタンスのストレージを設定します。Windows OS およびコンテナイメージはきわめて大きい (Windows サーバーのコアベースレイヤーは約 9 GiB) ため、Amazon ECS-optimized Windows AMI で使用するデフォルトの 50 GiB ボリュームサイズはいくつかのイメージやコンテナだけですぐに満杯になります。より大きなルートボリュームサイズ (200 GiB など) を使用することで、インスタンスのコンテナとイメージの数を増やすことができます。

オプションで、アプリケーションのニーズに合わせてインスタンスのボリュームサイズを増減できます。
[Review and Launch] を選択します。
[Review Instance Launch] ページの [Security Groups] に、ウィザードで作成および選択したセキュリティグループが表示されます。デフォルトでは、RDP 接続用のポートは 3389 です。インターネットからのインバウンドトラフィックをコンテナで受信する場合は、そのためのポートも開きます。
1. [Edit security groups] を選択します。
2. [Configure Security Group] ページで、[Create a new security group] オプションが選択されていることを確認します。
3. コンテナに必要と思われるその他のポートのルールを追加し、[確認と作成] を選択します。このウォークスルーの後半のサンプルのタスク定義ではポート 8080 を使用するため、それを [任意の場所] に対して開きます。
[Review Instance Launch] ページで、[Launch] を選択します。
[Select an existing key pair or create a new key pair] ダイアログボックスで、[Choose an existing key pair] を選択し、セットアップ時に作成したキーペアを選択します。

準備ができたら、確認フィールドを選択してから、[Launch Instances] を選択します。
インスタンスを起動することを知らせる確認ページが表示されます。[View Instances] を選択して確認ページを閉じ、コンソールに戻ります。
[Instances] 画面でインスタンスのステータスを表示できます。インスタンスはすぐに起動します。インスタンスを起動した直後のステータスは pending です。インスタンスを起動した後は、状態が running に変わり、パブリック DNS 名を受け取ります ([Public DNS] 列が非表示になっている場合は、[Show/Hide] アイコンを選択して [Public DNS] を選択します)。
インスタンスが起動したら、Amazon ECS コンソールでクラスターを表示し、クラスターにコンテナインスタンスが登録されていることを確認します。

注記

Windows コンテナインスタンスがクラスターに登録されるまでには最大 15 分かかる場合があります。

ステップ 3 (省略可能): Amazon ECS コンテナエージェントのインストール

Windows インスタンスを作成するときに Amazon ECS に最適化された AMI 以外の AMI を使用した場合は、Amazon ECS コンテナエージェントを手動でインストールする必要があります。

最新の Amazon ECS コンテナエージェントファイルを、リージョン別に以下に示します。

サービス対象	リージョン名	コンテナエージェント	コンテナエージェントの署名
us-east-2	米国東部 (オハイオ)	ECS コンテナエージェント	PGP 署名
us-east-1	米国東部（バージニア北部）	ECS コンテナエージェント	PGP 署名
us-west-2	米国西部 (オレゴン)	ECS コンテナエージェント	PGP 署名
us-west-1	米国西部 (北カリフォルニア)	ECS コンテナエージェント	PGP 署名
eu-west-3	EU (パリ)	ECS コンテナエージェント	PGP 署名
eu-west-2	欧州 (ロンドン)	ECS コンテナエージェント	PGP 署名
eu-west-1	欧州 (アイルランド)	ECS コンテナエージェント	PGP 署名
eu-central-1	欧州 (フランクフルト)	ECS コンテナエージェント	PGP 署名
ap-northeast-2	アジアパシフィック (ソウル)	ECS コンテナエージェント	PGP 署名
ap-northeast-1	アジアパシフィック (東京)	ECS コンテナエージェント	PGP 署名
ap-southeast-2	アジアパシフィック (シドニー)	ECS コンテナエージェント	PGP 署名
ap-southeast-1	アジアパシフィック (シンガポール)	ECS コンテナエージェント	PGP 署名
ca-central-1	カナダ (中部)	ECS コンテナエージェント	PGP 署名
ap-south-1	アジアパシフィック (ムンバイ)	ECS コンテナエージェント	PGP 署名
sa-east-1	南米 (サンパウロ)	ECS コンテナエージェント	PGP 署名
us-gov-west-1	AWS GovCloud (米国)	ECS コンテナエージェント	PGP 署名
cn-north-1	中国 (北京)	ECS コンテナエージェント	PGP 署名

インスタンスに Amazon ECS コンテナエージェントを手動でインストールするには

インスタンスに接続します。
Docker をインストールし、サービスとして実行します。詳細については、Install Docker Enterprise Edition for Windows Server を参照してください。

Amazon ECS コンテナエージェントはサービスまたはプロセスとして実行できます。

オプション 1: コンテナエージェントをサービスとして実行する。PowerShell を開き、次の一連のコマンドを実行します。$agentZipUri をリージョン固有の URL に置き換えます。


# Set up the file directories the Amazon ECS container agent will use.
PS C:\> New-Item -Type directory -Path ${env:ProgramFiles}\Amazon\ECS -Force
PS C:\> New-Item -Type directory -Path ${env:ProgramData}\Amazon\ECS -Force
PS C:\> New-Item -Type directory -Path ${env:ProgramData}\Amazon\ECS\data -Force

# Set up the configuration.
PS C:\> $ecsExeDir = "${env:ProgramFiles}\Amazon\ECS"

# Replace "windows" in the following command with your own cluster name
PS C:\> [Environment]::SetEnvironmentVariable("ECS_CLUSTER", "windows", "Machine")
PS C:\> [Environment]::SetEnvironmentVariable("ECS_LOGFILE", "${env:ProgramData}\Amazon\ECS\log\ecs-agent.log", "Machine")
PS C:\> [Environment]::SetEnvironmentVariable("ECS_DATADIR", "${env:ProgramData}\Amazon\ECS\data", "Machine")

# Download the container agent.
# Replace the "agentVersion" with the version of the container agent you want to download. For example, "latest" will download the most current stable version.
PS C:\> $agentVersion = "latest"

# Replace the "agentZipUri" with the URL of the regional bucket you want to download the Amazon ECS container agent from.
PS C:\> $agentZipUri = "http://s3.amazonaws.com/amazon-ecs-agent-us-east-1/ecs-agent-windows-$agentVersion.zip" 
PS C:\> $zipFile = "${env:TEMP}\ecs-agent.zip"
PS C:\> Invoke-RestMethod -OutFile $zipFile -Uri $agentZipUri

# Put the executables in the executable directory.
PS C:\> Expand-Archive -Path $zipFile -DestinationPath $ecsExeDir -Force
PS C:\> Set-Location ${ecsExeDir}

# Set $EnableTaskIAMRoles to $true to enable task IAM roles.
# Note that enabling IAM roles will make port 80 unavailable for tasks.
PS C:\> [bool]$EnableTaskIAMRoles = $false
PS C:\> if (${EnableTaskIAMRoles}) {.\hostsetup.ps1}

# Install the container agent service.
PS C:\> New-Service -Name "AmazonECS" -BinaryPathName "$ecsExeDir\amazon-ecs-agent.exe -windows-service" -DisplayName "Amazon ECS" -Description "Amazon ECS service runs the Amazon ECS agent" -DependsOn Docker -StartupType Manual
PS C:\> sc.exe failure AmazonECS reset=300 actions=restart/5000/restart/30000/restart/60000
PS C:\> sc.exe failureflag AmazonECS 1

# Start the AmazonECS service.
PS C:\> Start-Service AmazonECS

オプション 2: コンテナエージェントをプロセスとして実行する。PowerShell を開き、次の一連のコマンドを実行します。


PS C:\> # Set up directories the agent uses
PS C:\> New-Item -Type directory -Path ${env:ProgramFiles}\Amazon\ECS -Force
PS C:\> New-Item -Type directory -Path ${env:ProgramData}\Amazon\ECS -Force
PS C:\> New-Item -Type directory -Path ${env:ProgramData}\Amazon\ECS\data -Force

PS C:\> # Set up configuration
PS C:\> $ecsExeDir = "${env:ProgramFiles}\Amazon\ECS"

PS C:\> # Replace "windows" in the following command with your own cluster name
PS C:\> [Environment]::SetEnvironmentVariable("ECS_CLUSTER", "windows", "Machine")
PS C:\> [Environment]::SetEnvironmentVariable("ECS_LOGFILE", "${env:ProgramData}\Amazon\ECS\log\ecs-agent.log", "Machine")
PS C:\> [Environment]::SetEnvironmentVariable("ECS_DATADIR", "${env:ProgramData}\Amazon\ECS\data", "Machine")

PS C:\> # Set this environment variable to "true" to enable IAM roles.  Note that enabling IAM roles will make port 80 unavailable for tasks.
PS C:\> [Environment]::SetEnvironmentVariable("ECS_ENABLE_TASK_IAM_ROLE", "false", "Machine")

# Download the container agent.
# Replace the "agentVersion" with the version of the container agent you want to download. For example, "latest" will download the most current stable version.
PS C:\> $agentVersion = "latest"

# Replace the "agentZipUri" with the URL of the regional bucket you want to download the Amazon ECS container agent from.
PS C:\> $agentZipUri = "http://s3.amazonaws.com/amazon-ecs-agent-us-east-1/ecs-agent-windows-$agentVersion.zip"
PS C:\> $zipFile = "${env:TEMP}\ecs-agent.zip"
PS C:\> Invoke-RestMethod -OutFile $zipFile -Uri $agentZipUri

PS C:\> # Put the executables in the executable directory.
PS C:\> Expand-Archive -Path $zipFile -DestinationPath $ecsExeDir -Force

PS C:\> # Run the container agent.
PS C:\> cd '$ecsExeDir'; .\amazon-ecs-agent.ps1

注記

Windows インスタンスを再起動すると、${env:TEMP} ディレクトリ内のファイルは削除されます。この問題が発生した場合は、再度 zip ファイルをダウンロードする必要があります。

(省略可能) Windows バイナリおよび PGP 署名を使用して、コンテナエージェントファイルの有効性を検証できます。

Windows バイナリ署名を取得します。


PS C:\> $sig=Get-AuthenticodeSignature -FilePath ${env:ProgramFiles}\Amazon\ECS\amazon-ecs-agent.exe

Windows バイナリ署名を検証します。


PS C:\> $sig.Status

正常な出力:

有効


PS C:\> $sig.SignerCertificate.Subject

正常な出力:

CN=Amazon Services LLC, OU=Software Services, O=Amazon Services LLC, L=Seattle, S=Washington, C=US

GnuPG をダウンロードし、インストールします。Windows の場合は、GnuPG ウェブサイトから Windows のシンプルなインストーラをダウンロードして使用します。GNUpg の詳細については、「GnuPG ウェブサイト」を参照してください。

Amazon ECS PGP パブリックキーを取得します。コマンドを使用してこのキーを取得するか、手動でキーを作成してからインポートします。

オプション 1: 次のコマンドを使用してキーを取得します。
```
gpg --keyserver hkp://keys.gnupg.net --recv BCE9D9A42D51784F
```

オプション 2: 次の Amazon ECS PGP パブリックキーの内容でファイルを作成してからインポートします。

Amazon ECS PGP パブリックキーの詳細を参照用として以下に示します。

キー ID: BCE9D9A42D51784F タイプ: RSA サイズ: 4096/4096 有効期限: なし ユーザー ID: Amazon ECS キーのフィンガープリント: F34C 3DDA E729 26B0 79BE AEC6 BCE9 D9A4 2D51 784F

次のコマンドを使用して、Amazon ECS PGP パブリックキーをインポートします。


gpg --import <public_key_filename>

ECS コンテナエージェント署名をダウンロードします。ECS コンテナエージェント署名は、ascii でデタッチされた PGP 署名であり、拡張子が .asc のファイルに保存されています。この署名ファイルには、対応する実行可能ファイルと同じ名前がつけられており、拡張子は .asc です。
```
PS C:\> Invoke-WebRequest -OutFile ecs-agent.asc http://s3.amazonaws.com/amazon-ecs-agent-us-east-1/ecs-agent-windows-latest-zip.asc
```

署名を検証します。


gpg --verify ecs-agent.asc ${env:TEMP}\ecs-agent.zip

正常な出力:

gpg: Signature made Wed 16 May 2018 08:21:06 PM UTC using RSA key ID 710E61AF gpg: Good signature from "Amazon ECS <ecs-security@amazon.com>" [unknown] gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: F34C 3DDA E729 26B0 79BE AEC6 BCE9 D9A4 2D51 784F Subkey fingerprint: D64B B6F9 0CF3 77E9 B5FB 346F 50DE CCC4 710E 61AF

注記

出力に警告が表示されることがありますが、問題ありません。これは、個人 PGP キー (持っている場合) と Amazon ECS PGP キーの間に信頼チェーンがないために表示されます。詳細については、「Web of trust」を参照してください。

ステップ 4: Windows タスク定義を登録する

Amazon ECS クラスターで Windows コンテナを実行する前に、タスク定義を登録する必要があります。次のタスク定義の例では、microsoft/iis コンテナイメージを使用してコンテナインスタンスのポート 8080 でシンプルなウェブページを表示します。

AWS マネジメントコンソールを使用してサンプルタスク定義を登録するには

https://console.aws.amazon.com/ecs/ にある Amazon ECS コンソールを開きます。
ナビゲーションペインで、[Task Definitions] を選択します。
[Task Definitions] ページで、[Create new Task Definition] を選択します。
ページの末尾までスクロールし、[Configure via JSON] を選択します。

以下のサンプルタスク定義 JSON をテキスト領域に貼り付け (その領域にあらかじめ入力されている JSON を置き換え)、[Save] を選択します。


{
  "family": "windows-simple-iis",
  "containerDefinitions": [
    {
      "name": "windows_sample_app",
      "image": "microsoft/iis",
      "cpu": 100,
      "entryPoint":["powershell", "-Command"],
      "command":["New-Item -Path C:\\inetpub\\wwwroot\\index.html -Type file -Value '<html> <head> <title>Amazon ECS Sample App</title> <style>body {margin-top: 40px; background-color: #333;} </style> </head><body> <div style=color:white;text-align:center> <h1>Amazon ECS Sample App</h1> <h2>Congratulations!</h2> <p>Your application is now running on a container in Amazon ECS.</p>'; C:\\ServiceMonitor.exe w3svc"],
      "portMappings": [
        {
          "protocol": "tcp",
          "containerPort": 80,
          "hostPort": 8080
        }
      ],
      "memory": 500,
      "essential": true
    }
  ]
}

情報を確認し、[Create] を選択します。

AWS CLI でサンプルタスク定義を登録するには

windows-simple-iis.json という名前のファイルを作成します。
このファイルを任意のテキストエディタで開き、上のサンプルの JSON を追加して保存します。
AWS CLI を使用し、次のコマンドを実行して Amazon ECS にタスク定義を登録します。

注記

Windows クラスターがあるリージョンと同じリージョンを使うように AWS CLI が設定されていることを確認します。そうでない場合は、--region your_cluster_region オプションをコマンドに追加します。
```
aws ecs register-task-definition --cli-input-json file://windows-simple-iis.json
```

ステップ 5: タスク定義を使用してサービスを作成する

タスク定義を登録したら、それを使用してクラスターにタスクを配置できます。次の手順では、タスク定義を使用してサービスを作成し、クラスターに 1 つのタスクを配置します。

コンソールを使用してタスク定義からサービスを作成するには

[Task Definition: windows-simple-iis] 登録確認ページで、[Actions]、[Create Service] の順に選択します。
[Create Service] ページで、以下の情報を入力し、[Create service] を選択します。
- Cluster: windows
- Number of tasks: 1
- Service name: windows-simple-iis

AWS CLI でタスク定義からサービスを作成するには

AWS CLI で、次のコマンドを実行してサービスを作成します。


aws ecs create-service --cluster windows --task-definition windows-simple-iis --desired-count 1 --service-name windows-simple-iis

ステップ 6: サービスを表示する

サービスによってクラスターでタスクが起動されたら、サービスを表示し、ブラウザで IIS テストページを開いてコンテナが実行中であることを確認できます。

注記

コンテナインスタンスで Windows コンテナベースレイヤーをダウンロードして抽出するまでに最大 15 分かかる場合があります。

サービスを表示するには

https://console.aws.amazon.com/ecs/ にある Amazon ECS コンソールを開きます。
[Clusters] ページで、[windows] クラスターを選択します。
[Services] タブで、[windows-simple-iis] サービスを選択します。
[Service: windows-simple-iis] ページで、サービスのタスクのタスク ID を選択します。
[Task] ページで、iis コンテナを展開してその情報を表示します。
コンテナの [Network bindings] で、[External Link] の IP アドレスとポートの組み合わせのリンクを確認します。そのリンクを選択してブラウザで IIS テストページを開きます。