> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/sso-connect-cloud/jp/device-approvals/automator/aws-elastic-container-service.md).

# Amazon Elastic Container Service

Amazon ECS (Fargate)サービスでKeeperオートメーターを実行

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2F2S2SKPsFNCCYquvSEGTs%2FKeeper%20Automator.jpg?alt=media&#x26;token=f3a8419c-a119-44cd-abe7-518349eb5ee7" alt=""><figcaption></figcaption></figure>

## 概要

本ページでは、Application Load Balancerの背後にあるAmazon ECS (Fargate) にKeeperオートメーターサービスをデプロイする手順を取り扱います。Amazon EFSのストレージを使用するため、ECSがタスクを置き換えても、オートメーターの構成は保持されます。

このデプロイでは、以下のAWSサービスを使用します。各リンクはAWSの料金ページに移動します。

* [Amazon VPC](https://aws.amazon.com/vpc/pricing/)
* [Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/)
* [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/) (無料)
* [Amazon Elastic File System (EFS)](https://aws.amazon.com/efs/pricing/)
* [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/pricing/)
* [AWS Certificate Manager (ACM)](https://aws.amazon.com/certificate-manager/pricing/)
* [Elastic Load Balancing](https://aws.amazon.com/elasticloadbalancing/pricing/) (Application Load Balancer)
* [Amazon Route 53](https://aws.amazon.com/route53/pricing/) (任意)

費用はリージョンと使用量によって異なります。合計の見積もりには、[AWS料金計算ツール](https://calculator.aws/)をご利用ください。

### 1. オートメーター構成キーの作成

オペレーティングシステムに応じて、以下のいずれかの方法でbase64形式の256ビットAESキーを生成します。

#### Mac/Linux

```
openssl rand -base64 32
```

#### Windows

```
[Byte[]]$key = New-Object Byte[] 32; [System.Security.Cryptography.RNGCryptoServiceProvider]::Create().GetBytes($key); [System.Convert]::ToBase64String($key)
```

ECSがタスクを置き換えても、EFSがオートメーターの構成を保持します。`AUTOMATOR_CONFIG_KEY` は、デプロイの存続期間を通じて同じ値を使用してください。このキーを変更または紛失すると、オートメーターは保存済みの構成を復号できなくなります。\
\
この値はKeeperボルトに保存してください。値は手順8のタスク定義の環境変数 AUTOMATOR\_CONFIG\_KEY に設定します。以降のタスク定義リビジョンでも再度必要になります。値を紛失した場合、EFS上の保存済み構成は読み取れなくなり、オートメーターを最初からセットアップし直す必要があります。

### 2. VPCの作成

オートメーターには、異なるアベイラビリティーゾーンに少なくとも2つのサブネットを持つVPCに加えて、ルートテーブルとインターネットゲートウェイが必要です。2つのAZを使用することで、ALBを稼働でき、タスクが配置される可能性のある各ゾーンにEFSのマウントターゲットを置けます。

新しいVPCを作成する場合は、**\[VPC]** → **\[Create VPC]** → **\[VPC and more]** の順に進み、以下を設定します。

1. Number of Availability Zones: **2** (または3)
2. Number of public subnets: **2** (または、AZごとに1つで3)。Number of private subnets: **0**。タスクはパブリックIP付きでパブリックサブネット内で実行されるため (手順12)、プライベートサブネットは不要で、NATゲートウェイも必要ありません。
3. NAT gateways: **None**
4. VPC endpoints: **None**。デフォルトで選択されている**Amazon S3 gateway endpoint**は、このデプロイでは不要です。
5. DNSオプションは有効のままにします。
6. **\[Create VPC]** をクリックします。VPC IDとサブネットIDを記録します。以降の手順でVPCやサブネットを指定する際に使用します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-50bf84b3ec2ee85a6d001591d0d0b1d979081932%2FVPC.png?alt=media" alt=""><figcaption></figcaption></figure>

### 3. Amazon CloudWatchロググループの作成

**\[Amazon CloudWatch]** > **\[Logs]** > **\[Log management]** > **\[Create log group]** を開き、名前を `automator-logs` に設定します。保持期間は、監査ポリシーに合わせて設定してください。手順8のタスク定義により、コンテナのログはここに送られます。タスクが起動に失敗したときは、最初にここを確認します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-ca6ea28f3b3463d27b8cd54a3c17f8178869ad9c%2Fcloudwatchlogs%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

### 4. IAMロールの作成

2つのロールが必要です。\*\*`AutomatorExecutionRole`**は、ECSエージェントがイメージのプルとログの書き込みに使用します。**`AutomatorTaskRole`\*\*は、実行中のコンテナが引き受けるロールで、EFSのマウントを認可します。

#### 実行ロール: `AutomatorExecutionRole`

1. **\[IAM]** > **\[Roles]** > **\[Create role]** を開きます。
2. Trusted entity: **\[AWS service]** > **\[Elastic Container Service]** > **\[Elastic Container Service Task]** を選択し、**\[Next]** をクリックします。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-67b15f096df92ee91a24e93824db6dd013049a0c%2Fiamrole1trustedidentity.png?alt=media" alt=""><figcaption></figcaption></figure>

3. AWS管理ポリシー**AmazonECSTaskExecutionRolePolicy**をアタッチします。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-1a6ea6e1f2423f71fb1fd014f29e3410be7aab03%2Fiamroletaskexec.png?alt=media" alt=""><figcaption></figcaption></figure>

4. ロール名を `AutomatorExecutionRole` に設定して作成します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-45610af4a40e5b60f9b3fb7360f5269ec6f0bf6f%2Fautoexecrolename%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

#### タスクロール: `AutomatorTaskRole`

1. **\[IAM]** > **\[Roles]** > **\[Create role]** を開き、\*\*`AutomatorExecutionRole`\*\*と同じ信頼されたエンティティを選択します。
2. **\[Add permissions]** ページで、**\[Use existing policy]** から **\[Create inline policy]** に切り替えます。
3. 以下のインラインポリシーを追加します。`REGION` と `ACCOUNT_ID` のプレースホルダーは、ご利用の環境の値に置き換えます。手順6の完了後、このインラインポリシーの `Resource` 要素にはEFSファイルシステムの完全なARN、`Condition` 要素にはEFSアクセスポイントの完全なARNを設定して更新します。

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "elasticfilesystem:ClientMount",
        "elasticfilesystem:ClientWrite"
      ],
      "Resource": "arn:aws:elasticfilesystem:REGION:ACCOUNT_ID:file-system/fs-XXXXXXXX",
      "Condition": {
        "StringEquals": {
          "elasticfilesystem:AccessPointArn": "arn:aws:elasticfilesystem:REGION:ACCOUNT_ID:access-point/fsap-XXXXXXXX"
        }
      }
    }
  ]
}
```

4. ロール名を `AutomatorTaskRole` に設定して作成します。

手順8のタスク定義で使用するため、**両方**のロールのARNを記録します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-5dab95fa8d5908f050f3f778163e65ded2bc4f6e%2Frolearnstep.png?alt=media" alt=""><figcaption></figcaption></figure>

### 5. セキュリティグループの作成

{% hint style="danger" %}
Keeperオートメーターサービスは、インバウンドトラフィックの送信元をKeeperのインフラストラクチャ**のみ**に限定するため、[インバウンドファイアウォールルール](https://docs.keeper.io/sso-connect-cloud/jp/device-approvals/automator/ingress-requirements.md)を設定して導入する必要があります。
{% endhint %}

Keeperテナントのリージョンに応じて、KeeperクラウドからのHTTPSポート443を許可するインバウンドルールを作成します。テナント所在地ごとのIP一覧は後述しますが、以下の例は米国データセンターです。\
\
**\[EC2]** > **\[Security Groups]** に移動し、**\[Create security group]** をクリックします。手順2のVPCに2つのグループを作成します。

#### `automator-service` セキュリティグループ

1. 1つ目のセキュリティグループを作成し、名前を `automator-service` に設定します。
2. 説明には、`ALB and ECS tasks` など任意の説明を入力します。
3. 以下のルールを入力します。

{% hint style="info" %}
以下のTCP 8089のルールは、セキュリティグループ自身を送信元とします。まずインバウンドのTCP 443ルールを追加してセキュリティグループを保存し、その後 `automator-service` セキュリティグループを編集して8089のルールを追加します。
{% endhint %}

| **方向**  | **プロトコル / ポート** | **送信元または送信先**                  | **目的**                        |
| ------- | --------------- | ------------------------------ | ----------------------------- |
| インバウンド  | TCP 443         | テナントのリージョンに対応するKeeperクラウドのIP範囲 | KeeperからALBへのHTTPS            |
| インバウンド  | TCP 8089        | automator-service (自身)         | ALBからコンテナへの通信とヘルスチェック         |
| アウトバウンド | すべて             | 0.0.0.0/0                      | イメージのプル、CloudWatch、Keeper API |

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-06378adc93b47bfc1c4676be69a384e81f4e62bf%2Fsecgroup1.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
ヘルスチェックを実行する場合は、`automator-service` セキュリティグループにルールを追加します。インバウンドルールのポート範囲を443、送信元タイプをヘルスチェックコマンドを実行するシステムのIPアドレスに設定します。
{% endhint %}

#### `automator-efs` セキュリティグループ

1. 2つ目のセキュリティグループを作成し、名前を `automator-efs` に設定します。
2. 説明には、`EFS mount targets` など任意の説明を入力します。
3. 以下のルールを入力します。

| **方向** | **プロトコル / ポート** | **送信元**           | **目的**                |
| ------ | --------------- | ----------------- | --------------------- |
| インバウンド | TCP 2049 (NFS)  | automator-service | ファイルシステムをマウントするECSタスク |

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-28806d048f3df31f49087797f22a34f9e15d4bc8%2Fsecgroup2.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
2049のルールがないと、タスクはEFSをマウントできず、ボリュームに関するResourceInitializationErrorで起動に失敗します。
{% endhint %}

地域別のIPは、以下をご参照ください。

[インバウンド要件](https://docs.keeper.io/sso-connect-cloud/jp/device-approvals/automator/ingress-requirements.md)

### 6. EFSファイルシステムの作成

EFSは、Fargateタスクがマウントできる唯一の永続ストレージで、オートメーターの構成の保存先になります。

#### ファイルシステム

1. **\[EFS]** > **\[Create file system]** > **\[Customize]** に移動します。
2. 名前を `automator-config` に設定します。
3. Storage class: **Regional**。**Automatic backups**は有効のままにします。
4. Lifecycle management: **Transition into IA**、**Transition into Archive**、**Transition into Standard**をすべて**None**に設定します。
5. **Encryption of data at rest**は、デフォルトの `aws/elasticfilesystem` キーで有効のままにするか、カスタマー管理のKMSキーを選択します。
6. Throughput mode: **Enhanced**を選び、続けて**Elastic**を選択します。
7. **\[Next]** をクリックします。**\[Network access]** で手順2のVPCを選択し、ECSサービスが使用する各サブネットにマウントターゲットを作成します。各マウントターゲットのデフォルトのセキュリティグループは、手順5の `automator-efs` に置き換えます。
8. ファイルシステムポリシーの画面も **\[Next]** で進み、ファイルシステムを作成します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-396b4b57d15027a82219962364c83bc27d930931%2Fefsstep1.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-2a72eb62e66ddb5aaee3e8c2c922da5a5a4bf71a%2Fefsstep2-3.png?alt=media" alt=""><figcaption></figcaption></figure>

9. ファイルシステムID (`fs-XXXXXXXX`) と完全なARN (`arn:aws:elasticfilesystem:REGION:ACCOUNT_ID:file-system/fs-XXXXXXXX`) を記録します。このARNを使用して、手順4の `AutomatorTaskRole` インラインポリシーの `Resource` 要素を更新します。

#### アクセスポイント

アクセスポイントを使用すると、コンテナに所有権が一定のディレクトリを割り当てられるため、ファイルのアクセス許可がイメージの実行UIDに左右されなくなります。

1. 作成した `automator-config` ファイルシステムを開き、**\[Access points]** タブ > **\[Create access point]** に進みます。
2. Name: `automator`
3. Root directory path: `/automator`
4. POSIX user: User ID `1000`、Group ID `1000`
5. Root directory creation permissions: Owner user ID `1000`、Owner group ID `1000`、アクセスポイントのアクセス許可 `0750`

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-ce78e89e4924c912c8f74e2a4914c9ea62d360fb%2Faccesspoint1.png?alt=media" alt=""><figcaption></figcaption></figure>

6. 作成して、アクセスポイントID (`fsap-XXXXXXXX`) と完全なARN (`arn:aws:elasticfilesystem:REGION:ACCOUNT_ID:access-point/fsap-XXXXXXXX`) を記録します。このARNを使用して、手順4の `AutomatorTaskRole` インラインポリシーの `Condition` 要素を更新します。

#### ファイルシステムポリシー

IAMで認可され、TLSで暗号化されたクライアントのみがマウントできるように制限します。

1. **\[Elastic File System]** > **\[File systems]** に移動し、`automator-config` ファイルシステムを選択します。
2. **\[File system policy]** タブを選択し、**\[Edit]** を選択します。

以下のJSONの Principal 要素を、IAM `AutomatorTaskRole` のARNに置き換えます。

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": { "AWS": "arn:aws:iam::ACCOUNT_ID:role/AutomatorTaskRole" },
      "Action": [
        "elasticfilesystem:ClientMount",
        "elasticfilesystem:ClientWrite"
      ],
      "Condition": {
        "Bool": { "elasticfilesystem:AccessedViaMountTarget": "true" }
      }
    },
    {
      "Effect": "Deny",
      "Principal": { "AWS": "*" },
      "Action": "*",
      "Condition": {
        "Bool": { "aws:SecureTransport": "false" }
      }
    }
  ]
}
```

ファイルシステムポリシーを保存します。その後、手順4で作成した `AutomatorTaskRole` インラインポリシーに戻り、ファイルシステムとアクセスポイントのARNを更新します。

### 7. Amazon ECSクラスターの作成

1. **\[Amazon ECS]** > **\[Clusters]** > **\[Create cluster]** に移動します。
2. Cluster name: `automator`
3. Infrastructure: **Fargate only** (serverless)
4. モニタリングと暗号化はデフォルトのままにして、**\[Create]** をクリックします。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-9104ee3768843fa2a2f19d230008952efaace982%2Fecscluster.png?alt=media" alt=""><figcaption></figcaption></figure>

### 8. Amazon ECSタスク定義の作成

タスク定義には、EFSをバックエンドとする `volumes` エントリ、そのボリュームをオートメーターの構成ディレクトリに配置する `mountPoints` エントリ、`taskRoleArn` が含まれます。任意のテキストエディタで、以下のJSONタスク定義をコピーして保存します。

{% hint style="info" %}
JSONファイルに以下の変更を加えます。
{% endhint %}

| フィールド名                 | プレースホルダーを置き換える値                       |
| ---------------------- | ------------------------------------- |
| `executionRoleArn`     | 手順4のIAMロールARN                         |
| `taskRoleArn`          | 手順4のIAMロールARN                         |
| `fileSystemId`         | 手順6のEFSファイルシステムID (`"fs-XXXXXXXX")`   |
| `accessPointId`        | 手順6のEFSアクセスポイントID ("`fsap-XXXXXXXX`") |
| `AUTOMATOR_CONFIG_KEY` | 手順1で生成した構成キー                          |
| `awslogs-group`        | 手順3のCloudWatchロググループ名                 |
| `awslogs-region`       | CloudWatchロググループを作成したAWSリージョン         |

```json
{
  "family": "automator",
  "networkMode": "awsvpc",
  "requiresCompatibilities": ["FARGATE"],
  "cpu": "1024",
  "memory": "3072",
  "runtimePlatform": {
    "cpuArchitecture": "X86_64",
    "operatingSystemFamily": "LINUX"
  },
  "executionRoleArn": "arn:aws:iam::ACCOUNT_ID:role/AutomatorExecutionRole",
  "taskRoleArn": "arn:aws:iam::ACCOUNT_ID:role/AutomatorTaskRole",
  "volumes": [
    {
      "name": "automator-config",
      "efsVolumeConfiguration": {
        "fileSystemId": "fs-XXXXXXXX",
        "rootDirectory": "/",
        "transitEncryption": "ENABLED",
        "authorizationConfig": {
          "accessPointId": "fsap-XXXXXXXX",
          "iam": "ENABLED"
        }
      }
    }
  ],
  "containerDefinitions": [
    {
      "name": "automator",
      "image": "keeper/automator:latest",
      "cpu": 1024,
      "essential": true,
      "portMappings": [
        {
          "containerPort": 8089,
          "hostPort": 8089,
          "protocol": "tcp",
          "appProtocol": "http"
        }
      ],
      "environment": [
        { "name": "SSL_MODE", "value": "none" },
        { "name": "AUTOMATOR_CONFIG_KEY", "value": "XXX (REPLACE THIS) XXX" },
        { "name": "AUTOMATOR_PORT", "value": "8089" },
        { "name": "PERSIST_STATE", "value": "true" }
      ],
      "mountPoints": [
        {
          "sourceVolume": "automator-config",
          "containerPath": "/usr/mybin/config",
          "readOnly": false
        }
      ],
      "readonlyRootFilesystem": false,
      "healthCheck": {
        "command": ["CMD-SHELL", "wget -q -O - http://localhost:8089/health || exit 1"],
        "interval": 30,
        "timeout": 5,
        "retries": 3,
        "startPeriod": 60
      },
      "logConfiguration": {
        "logDriver": "awslogs",
        "options": {
          "awslogs-group": "automator-logs",
          "awslogs-region": "REGION",
          "awslogs-stream-prefix": "automator"
        }
      }
    }
  ]
}
```

設定内容に関する補足です。

* `family` はタスク定義の名前です。同じ名前のファミリーがアカウント内にすでに存在する場合、ECSは別のタスク定義を作成せず、そのファミリーの新しいリビジョンを登録します。異なるタスク定義が必要な複数のオートメーターをセットアップする場合は、`family` の値を一意にしてください。
* `rootDirectory` は `/` のままにします。アクセスポイントによってマウントがすでに `/automator` に限定されているためです。両方を設定したタスク定義は、ECSに拒否されます。
* `containerPath` は `/usr/mybin/config` です。これは、Keeper自身のDocker Compose構成がマウントする構成ディレクトリです。デプロイするイメージタグで、このパスをご確認ください。マウント先のパスが誤っていても正常に起動しますが、何も保持されません。
* `transitEncryption` にはFargateのプラットフォームバージョン1.4.0以降が必要です。`LATEST` はこれを満たします。
* `PERSIST_STATE` はデフォルトで有効ですが、明示的に設定しておくと、他の場所で無効化されることを防げます。
* 正常に動作するデプロイが完成したら、イメージを `latest` ではなく特定のバージョンタグに固定してください。タスクの置き換え時に、オートメーターが意図せずアップグレードされることを防げます。

JSONの更新後、**\[Amazon ECS]** > **\[Task definitions]** > **\[Create new task definition]** > **\[Create new task definition with JSON]** に移動します。既存のJSONを削除し、変更したJSONをボックスに貼り付けて、**\[Create]** をクリックします。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-a607bdc357a1447eb410564e663055d4996db4bf%2Ftaskdefinition.png?alt=media" alt=""><figcaption></figcaption></figure>

### 9. AWS Certificate Managerによる証明書の作成

AWSのアプリケーションロードバランサーがオートメーターのリクエストを処理するには、SSL証明書がAWS Certificate Managerによって管理されている必要があります。証明書をインポートするか、AWSで作成します。

1. **\[AWS Certificate Manager]** > **\[Request]** に移動します。
2. **\[Request a public certificate]** を選択し、**\[Next]** をクリックします。
3. `automator.example.com` など、オートメーターサービスのドメイン名を入力します。
4. 任意の検証方式とキーアルゴリズムを選択します。
5. **\[Request]** をクリックします。

Amazon Route 53でドメインを管理している場合は、証明書をクリックして **\[Create records in Route 53]** を選択すると、ドメインが検証され、証明書が作成されます。

別のDNSプロバイダーを使用する場合は、画面に表示されるとおりにCNAMEレコードを作成する必要があります。CNAMEレコードを作成すると、ドメインは数分以内に検証されます。

この証明書は、手順11でアプリケーションロードバランサーを作成する際に参照します。

### 10. ターゲットグループの作成

1. **\[EC2]** > **\[Target Groups]** > **\[Create target group]** に移動します。
2. Target type: **IP addresses**
3. Target group name: `automator-tg`
4. Protocol and port: **HTTP**、**8089**
5. IP address type: IPv4
6. VPC: 手順2のVPC。Protocol version: **HTTP1**
7. Health check protocol: **HTTP**。Health check path: `/health`
8. **\[Advanced health check settings]** を展開し、ポートに **\[Override]** を選択して `8089` を入力します。healthyとunhealthyのしきい値は2、タイムアウトは5秒、間隔は30秒に設定します。
9. **\[Next]** をクリックします。
10. まだターゲットは選択せず、**\[Next]** をクリックします。
11. 設定内容を確認し、**\[Create target group]** をクリックします。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-7993fc94a45ad911664bcf1bf6a0f05bca9939a1%2FTargetGroup-fixed.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
タスクのIPは、手順12でECSサービスが自動的に登録します。
{% endhint %}

### 11. アプリケーションロードバランサー (ALB) の作成

1. **\[EC2]** > **\[Load balancers]** > **\[Create load balancer]** > **\[Application Load Balancer]** に移動します。
2. Load balancer name: `automator-alb`
3. Scheme: **Internet-facing**
4. Load balancer IP address type: **IPv4**

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-bbaee2298b38813264f7593b29232a808c35c4a5%2Falb1.png?alt=media" alt=""><figcaption></figcaption></figure>

5. VPC: 手順2のVPC
6. Availability Zones and subnets: パブリックサブネットを持つ、異なる2つ以上のアベイラビリティーゾーンを選択します。
7. Security groups: デフォルトを削除し、手順5の `automator-service` を選択します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-8b182a09345fe03ba0724912bf5a0050bc97481f%2Falb2.png?alt=media" alt=""><figcaption></figcaption></figure>

8. Listener Protocol: **HTTPS**、Port: **443**。HTTP:80のリスナーは設定しません。KeeperはHTTPSでのみ接続し、セキュリティグループも443でKeeperのIP範囲のみを許可するためです。
9. Pre-routing action: **No pre-routing action**
10. Routing action: **Forward to target groups**
11. Target group: `automator-tg`、Weight: 1

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-f92ac2a0e51b9f8532f5293b305ba0f45dc62d8e%2Falb3.png?alt=media" alt=""><figcaption></figcaption></figure>

12. Security category: **All security policies**。Policy nameには、最新のTLSセキュリティポリシーを選択します。
13. Certificate source: **From ACM**。手順9で発行した証明書を選択します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-91fa8dc616ffd4575062654cb7d4886265db7001%2Falb4.png?alt=media" alt=""><figcaption></figcaption></figure>

14. **\[Create load balancer]** をクリックし、DNS名を記録します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-b01065cc15e1429b76dc257c94f2ba81f93d85b7%2Falb5-dnsname.png?alt=media" alt=""><figcaption></figcaption></figure>

### 12. Amazon ECSサービスの作成

1. **\[Amazon ECS]** > **\[Task definitions]** > `automator` (手順8で作成) に移動します。
2. このタスク定義から、**\[Deploy]** > **\[Create service]** を選択します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-b8d0e22f8c64500f183d2fef3b86f40acc9501e8%2Fecscreateservice.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Task definition revision: 空白のままにします。
4. Service name: `automator-service`

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-5c9a8323c2bd09700eb9dae4946fc727274b85fd%2Ftaskdefserv1.png?alt=media" alt=""><figcaption></figcaption></figure>

5. Existing cluster: 手順7で作成した `automator` クラスター
6. Compute options: **Launch type**
7. Launch type: **FARGATE**、Platform version: **LATEST**

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-0d16a3bee58cfdd02d3524213d3e092896768491%2Ftaskdef2.png?alt=media" alt=""><figcaption></figcaption></figure>

8. Deployment configuration: Desired tasks は**1**に設定します。設定完了後に、必要に応じてこの値を増やします。
9. Health check grace period は120秒に設定します。
10. Deployment strategy: rolling update
11. Minimum running tasks: **100%**、Max running tasks: **200%**。これにより、ECSは古いタスクを停止する前に、置き換え用のタスクを起動できます。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-4797bcefa5463a617d5d1bb0df88e971dc242e74%2Ftaskdef3.png?alt=media" alt=""><figcaption></figcaption></figure>

12. VPC: 手順2のVPC
13. Subnets: EFSのマウントターゲットがあるサブネットと同じサブネット
14. Security group: **Use an existing security group**
15. Security group name: デフォルトを削除し、手順5で作成した `automator-service` セキュリティグループを選択します。
16. Public IP: **Turned on** (NATやVPCエンドポイントなしでイメージをプルし、KeeperのAPIに到達するために必要です)

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-f1e1436d1e2b1084f266ccac924fd97c16af31fe%2Ftaskdef4.png?alt=media" alt=""><figcaption></figcaption></figure>

17. **\[Load balancing]** セクションで、**\[Use load balancing]** をチェックします。
18. VPC: 自動入力されています。
19. Load balancer type: **Application Load Balancer**
20. Container: `automator 8089:8089`
21. Application Load Balancer: **Use an existing load balancer**
22. Load balancer: `automator-alb`
23. Listener: **Use an existing listener**を選択し、**HTTPS:443**を選びます。
24. Target group: **Use an existing target group**を選択し、手順10で作成した `automator-tg` を選びます。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-f4ffac6d553165706a48bc3d235f982b635e8773%2Ftaskdefserv5.png?alt=media" alt=""><figcaption></figcaption></figure>

**\[Create]** をクリックします。デプロイが完了するまでに少し時間がかかる場合があります。失敗した場合は、Amazon ECSの**Stopped reason**と、Amazon CloudWatchロググループのコンテナログを確認します。よくある原因については、**Amazon ECS固有のトラブルシューティング**をご参照ください。

### 13. DNSの更新

DNS名がAmazon Route 53でホストおよび管理されている場合は、以下の手順を実行します。

1. **\[Amazon Route 53]** > **\[Create or Edit record]** に移動します。
2. Aレコードを作成します。
3. **\[Alias]** を設定します。
4. Route traffic to: **Alias to Application and Classic Load Balancer**
5. **\[AWS Region]** を選択します。
6. `automator-alb` Application Load Balancerを選択します。
7. **\[Simple routing]** を選択します。
8. **\[Save]** を選択します。

Amazon Route 53を使用していない場合は、DNSプロバイダーで、ホスト名から手順11で記録したALBのDNS名へのCNAMEを作成します。

外部のDNSプロバイダーを使用している場合は、2つのCNAMEレコードが必要になります。手順9のACM検証レコードと、手順11のALB DNSレコードです。

* **ACM検証レコード:** `_46a43bcef00000f00cebac4464dc21de.automator.example.com` から `_a24513a48296e388d62565e30cc840ae.wzccmgtwzk.acm-validations.aws` を指します。
* **ALB DNSレコード:** `automator.example.com` から `automator-alb.REGION.elb.amazonaws.com` を指します。

証明書の発行後も、ACM検証レコードは削除しないでください。ACMは証明書の更新にこのレコードを使用するため、削除すると更新に失敗します。

### 14. Keeperコマンダーのインストール

この時点ではサービスは実行されていますが、まだKeeperと通信できない状態です。

ワークステーション、サーバー、または任意のコンピュータにKeeperコマンダーCLIをインストールします (初期設定のみ)。バイナリインストーラーを含むインストール手順は、以下をご参照ください。\
[**Keeperコマンダーのインストール**](https://docs.keeper.io/keeperpam/jp/commander-cli/commander-installation-setup.md)\
\
コマンダーをインストールした後、`keeper shell` を実行してセッションを開き、`login` コマンドでログインします。オートメーターをセットアップするには、Keeper管理者またはSSOノードを管理する権限を持つ管理者としてログインする必要があります。

```
$ keeper shell

My Vault> login admin@company.com
.
.
My Vault>
```

### 15. コマンダーでの初期設定

[Keeperコマンダー](https://docs.keeper.io/keeperpam/jp/commander-cli/overview.md)にログインした後、以下のコマンドでオートメーターを有効にします。最初に `automator create` を実行します。

```
My Vault> automator create --name="My Automator" --node="Azure Cloud"
```

ノード名は、コマンダーで `enterprise-info --nodes` を実行して確認できます。以下のように、管理コンソールUIからも確認できます。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-81306caabd13a3a0f0fe81e3fba2c322bddc3cc8%2Fnodename.png?alt=media" alt=""><figcaption></figcaption></figure>

コマンドの出力には、IDプロバイダからのメタデータを含むオートメーター設定が表示されます。

```
                    Automator ID: 1477468749950
                            Name: My Automator
                             URL: 
                         Enabled: No
                     Initialized: No
                          Skills: Device Approval
```

`automator edit` を実行します。これによりURLが設定され、`team`、`team_for_user`、`device` のスキルが構成されます。

{% code overflow="wrap" %}

```
automator edit --url https://<application URL> --skill=team --skill=team_for_user --skill=device "My Automator"
```

{% endcode %}

次にキーを交換します。オートメーターは、自身の公開キーで暗号化されたエンタープライズ秘密キーを受け取ります。

```
automator setup "My Automator"
```

新しい設定でオートメーターを初期化します。

```
automator init "My Automator"
```

サービスを有効にします。

```
automator enable "My Automator"
```

この時点で設定は完了となります。

自動ヘルスチェックには、以下のURLを使用できます。

**https\://\<server>/health**

以下は `curl` コマンドを使用した例です。

```
$ curl https://automator.example.com/health
OK
```

### 16. ユーザー体験のテスト

Keeperオートメーターがタスクを実行した状態でデプロイされましたので、エンドユーザー体験のテストが可能となります。ユーザーがSSO IDプロバイダで認証した後は、承認を求めるプロンプトは必要なくなります。

最も簡単な方法は、ブラウザのシークレットモードでKeeperウェブボルトを開き、クラウドSSOコネクトでログインすることです。デバイス承認のプロンプトは表示されません。

### 17. 構成が保持されることの確認

Amazon EFSの永続ストレージを使用するため、ECSがタスクを再デプロイするたびにオートメーターを初期化する必要はなくなります。以下の手順でECSにタスクを強制的に置き換えさせ、新しいタスクが初期化済みの状態で起動することを確認します。

1. **\[Amazon ECS]** > **\[Clusters]** > `automator` > **\[Services]** > `automator-service` > **\[Tasks]** を開きます。
2. 実行中のタスクを選択し、**\[Stop]** をクリックします。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-bbaac85135ab465b9c0c7775055420a2c723e366%2Fpersistantcheck.png?alt=media" alt=""><figcaption></figcaption></figure>

Amazon ECSが実行中のタスクの停止処理を開始し、数分以内に置き換え用のタスクを起動します。新しいタスクが**Running**になり、ターゲットグループが**healthy**と表示されるまで待ちます。

3. コマンダーに戻り、`setup`、`init`、`enable` を実行せずに `automator view "My Automator"` を実行します。

期待される結果: Initialized: Yes および Enabled: Yes

Amazon CloudWatchでは、`AutomatorServer.standardPeriodicMessage` が記録する起動ステータスのブロックに、再起動前の `Enabled at` タイムスタンプが表示されます。これは、状態がEFSから読み取られたことを意味します。`ConfigurationManager.getConfiguration` のオートメーター構成の行は、置き換え後のタスクが最初のデバイス承認リクエストを受信したときに記録されます。

代わりに、cryptoのセットアップまたは初期化が必要という状態が表示される場合は、EFSから構成を読み取れていません。以下を順に確認してください。

* EFSボリュームがマウントされているか。タスクの詳細の**Volumes**タブに、ルートディレクトリ `/` で `automator-config` が表示されます。コンテナ内のマウント先を確認するには、**Configuration**タブ > **Volume configuration**を開きます。`/usr/mybin/config` に `automator-config` が表示されます。
* マウントパスが、イメージが構成を書き込む場所と一致しているか。同じ定義で1回限りのタスクを実行し、ECS Exec経由で `cat /usr/mybin/config/*` を実行するか、デプロイしたイメージタグで文書化されているディレクトリ構成を確認します。
* 現在のタスク定義リビジョンの `AUTOMATOR_CONFIG_KEY` の値が、`automator init` を実行したときに使用した値と同一か。

任意で、EFS側からも確認できます。ファイルシステムを開き、**Monitoring**で、`automator init` を実行したときに**Data write I/O bytes**メトリクスが変動したことを確認します。

### 18. タスク定義の更新 (任意)

Keeperオートメーターサービスは、処理するリクエストの数が少ないため単一のコンテナ上で問題なく快適に実行できます。ただし、複数のコンテナを実行したい場合は以下の手順に従ってください。

1. **\[Amazon Elastic Container Service]** > **\[Clusters]** > `automator` > `automator-service` に移動します。
2. `automator-service` で、**\[Update service]** の横にあるドロップダウン矢印を選択し、**\[Quick service update]** を選びます。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-25373baf1cf312dd705567b1516bd23c1cfeed32%2Fquickupdateservice.png?alt=media" alt=""><figcaption></figcaption></figure>

3. 目的の**Task definition family**と**Task definition revision**のバージョン番号が選択されていることを確認します。
4. 起動する**Desired tasks**の数を選択します。
5. **\[Force new deployment]** のチェックボックスをオンにします。
6. **\[Update]** を選択します。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-5c9d582e87445d24713cc338ab776a70688178c1%2Fquickserviceoptionsupdate2%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

数分後、新しいコンテナがデプロイされます。すべてのコンテナがアクティブになるまで待ちます。

### ログと監視

オートメーターログは、Amazon CloudWatchのLog managementまたはAmazon ECSサービスの **\[Logs]** タブで検索および監視できます。

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-9f042243b3c9b34bb9a99045f14364b549aa0985%2Fcloudwatchlogs.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1914737032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mfd2v-YT48Ljtykb8qm%2Fuploads%2Fgit-blob-e93636b8e4becbea0df9776c864a66f7af0942eb%2Fecsservicelogs%20(1).png?alt=media" alt=""><figcaption></figcaption></figure>

### Amazon ECS固有のトラブルシューティング

* **ボリュームに関するResourceInitializationErrorでタスクが停止する:** タスクがEFSをマウントできていません。以下を確認します。`automator-efs` が `automator-service` からのTCP 2049を許可していること (手順5)。サービスが使用するすべてのサブネットにマウントターゲットが存在すること (手順6)。`AutomatorTaskRole` のインラインポリシーに、プレースホルダーではなく実際のファイルシステムとアクセスポイントのARNが設定されていること (手順4)。EFSファイルシステムポリシーで `AutomatorTaskRole` がプリンシパルに指定されていること (手順6)。
* **イメージのプルまたはネットワークのエラーでタスクが停止する:** タスクにインターネットへの経路がありません。サービスがインターネットゲートウェイを持つパブリックサブネットで実行されていること (手順2)、**Public IP**がオンになっていること (手順12) を確認します。
* **ResourceInitializationError: failed to validate logger argsでタスクが停止する:** タスク定義で指定したAmazon CloudWatchロググループをタスクが見つけられません。タスクとAmazon CloudWatchの間に接続の問題があります。VPCで**DNS resolution**と**DNS hostnames**が有効になっていることを確認します。
* **タスクは実行されているが、ターゲットグループでunhealthyと表示され、Amazon ECSがタスクを置き換え続ける:** ヘルスチェックのポートが `8089`、パスが `/health` で上書きされていること (手順10)、`automator-service` が自身からのTCP 8089を許可していること (手順5)、ヘルスチェックの猶予期間が120秒であること (手順12) を確認します。
* **手順15のヘルスチェックのcurlがタイムアウトする:** ALBのセキュリティグループは、KeeperのIP範囲のみを許可しています。`automator-service` の443のルールに、チェックを実行するマシンのパブリックIPを一時的に追加します (手順5)。
* **タスクの置き換え後、automator viewでセットアップまたは初期化が必要と表示される:** 構成がEFSから読み戻されていません。マウントパスが `/usr/mybin/config` であること、現在のタスク定義リビジョンの `AUTOMATOR_CONFIG_KEY` が `automator init` 以降変更されていないこと、`PERSIST_STATE` が `true` であること (手順8) を確認します。キーを変更した場合は、保存済みの構成を復号できません。元の値に戻すか、`automator setup`、`init`、`enable` を再度実行します。
* **ユーザーにデバイス承認のプロンプトが引き続き表示される:** コマンダーで、オートメーターが有効になっていること、ユーザーが `automator create` で指定したノードに所属していること、公開ホスト名経由で `/health` が `OK` を返すこと (手順15) を確認します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/sso-connect-cloud/jp/device-approvals/automator/aws-elastic-container-service.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
