概要
今までAWS ECS on EC2を使っており、Fargateを使ったことがありませんでした。そこで、EC2で構築した際とFargateを利用した際を比較すると、Fargate構築時のみの注意点があると感じたので紹介します(特にCloudformationを利用して作成すると感じた点になります)。
注意点1:ネットワークモードはawsvpc
そもそもFargetはサーバーレスモデルなので、EC2ではなく、タスクにプライベートIPアドレス(正確にはENI)が割り当てられる形です。そのため、ネットワークモードはawsvpc
のみをサポートする形になっています。
公式ドキュメントにも以下のように記載されています。
Fargate 起動タイプを使用している場合、awsvpc ネットワークモードが必要です。
引用元:https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/task_definition_parameters.html
ネットワークモードには他にもbridge
やhost
があります。詳しくは公式ドキュメントご参照下さい。
注意点2:コンテナポートのみをマッピングする
networkMode
がawsvpc
の場合、ポートマッピング内のホストポートとコンテナポートが一致していないといけません。同じ数字にしても良いですが、Fargateではポートマッピングが動的に行われるため、コンテナポートのみを指定すれば良いです。HostPort
を記載しない方が一般的かと思います。
# NG例
PortMappings:
-
ContainerPort: 80
HostPort: 0
Protocol: "tcp"
# OK例
PortMappings:
-
ContainerPort: 80
Protocol: "tcp"
異なるポート番号を指定した場合、エラーメッセージは以下になります。
Invalid request provided: Create TaskDefinition: When networkMode=awsvpc, the host ports and container ports in port mappings must match
注意点3:特定のCPUとメモリの組み合わせにする
FARGATE
を使用している場合、特定のCPUとメモリの組み合わせを指定しない場合にエラーが発生します。例えば、CPUが256(.25 vCPU)
の場合は、メモリは0.5GB
から2GB
の範囲である必要があります。
公式ドキュメントにも以下のように記載されています。
requiresCompatibilities パラメータに FARGATE を指定しているタスク定義については (EC2 も指定されている場合も)、次の表のいずれかの値を使用する必要があります。これらの値によって、CPU とメモリのパラメータでサポートされる値の範囲が決まります。
引用元:https://docs.aws.amazon.com/ja_jp/AmazonECS/latest/developerguide/task-cpu-memory-error.html
上記の表に該当しない組み合わせを入れるとエラーになります。
エラーメッセージは以下。
Resource handler returned message: "Invalid request provided: Create TaskDefinition: No Fargate configuration exists for given values: 900 CPU, 3400 memory. See the Amazon ECS documentation for the valid values.
注意点4:ターゲットタイプはip
ECSタスクがawsvpc
ネットワークモードで実行される場合、ELBのターゲットグループのターゲットタイプはip
である必要があります。先述の通り、awsvpc
ネットワークモードでは、各タスクにENI(Elastic Network Interface)が割り当てられ、タスクはそのENIのIPアドレスを使用して通信します。固有のIPアドレスを持っているため、このタイプではないといけないんですね。
そのため、ターゲットグループはタスクのIPアドレスをターゲットとして使用するように設定する必要があるのです。ターゲットグループの定義でTargetType
プロパティがあるので、その値をip
に設定する必要があります。具体的には以下の通り。
TargetGroup:
Type: "AWS::ElasticLoadBalancingV2::TargetGroup"
Properties:
HealthCheckIntervalSeconds: 5
HealthCheckPath: "/"
HealthCheckPort: "traffic-port"
HealthCheckProtocol: "HTTP"
HealthCheckTimeoutSeconds: 2
HealthyThresholdCount: 2
UnhealthyThresholdCount: 2
Matcher:
HttpCode: "200"
Name: !Sub ${SysTag}-xxx
Port: 80
Protocol: "HTTP"
TargetType: "ip" ## これを追加
VpcId: !Ref VpcId
TargetGroupAttributes:
-
Key: deregistration_delay.timeout_seconds
Value: 0
ip
を指定しない場合(ターゲットタイプがインスタンスになってしまっている場合)、以下のエラーメッセージが表示されます。
Resource handler returned message: "Invalid request provided: CreateService error: The provided target group arn:aws:elasticloadbalancing:ap-northeast-1:1234567890123:targetgroup/xxxxx-xxxx/xxxx has target type instance, which is incompatible with the awsvpc network mode specified in the task definition.