Technical specifications for Consul on ECS

This topic describes the supported runtimes and environments for using Consul service mesh for your ECS workloads.

For requirements associated with using the Terraform mesh-task module to deploy Consul service mesh, refer Deploy Consul with the Terraform module. For requirements associated with manually deploying Consul service mesh to your ECS cluster, refer Deploy Consul manually.

Supported environments, runtimes, and capabilities

Consul on ECS supports the following environments, runtimes, and capabilities:

• Launch Types: Fargate and EC2

• Network Modes: awsvpc

• Subnets: Private and public subnets. Tasks must have network access to Amazon ECR or other public container registries to pull images.

• Consul servers: You can use your own Consul servers running on virtual machines or use HCP Consul Dedicated to host the servers for you.

• ECS controller: The ECS controller assists with reconciling state back to Consul and facilitates Consul security features.

• Admin partitions: EnterpriseEnterprise Enable ACLs and configure the ECS controller to use admin partitions. You must deploy one controller for each admin partition.

• Namespaces: EnterpriseEnterprise Enable ACLs and configure the ECS controller to use namespaces.

• Dataplane containers: To manage proxies using Consul dataplane, you must use the Terraform mesh-task module to install Consul service mesh.

• Transparent proxy: Consul on ECS 0.8.x supports transparent proxy for ECS on EC2 tasks. Transparent proxy in ECS requires the host to have NET_ADMIN capabilities, which ECS Fargate does not currently support. You can enable transparent proxy with the enable_transparent_proxy parameter in the mesh-task Terraform module or through ecs_config_json. The enable_transparent_proxy parameter has precedence over ecs_config_json.

  Refer to the terraform-aws-consul-ecs for an example.

• API Gateway: Consul on ECS 0.8.x supports API gateway. Refer to the terraform-aws-consul-ecs for an example.

  Refer to the Consul ECS GitHub repository for examples of how to use transparent proxy with Consul on ECS.

Resource usage

We used the following procedure to measure resource usage:

• Executed performance tests while deploying clusters of various sizes. We ensured that deployment conditions stressed Consul on ESC components.
• After each performance test session, we recorded resource usage for each component to determine worst-case scenario resource usage in a production environment.
• We used Fargate's minimum allowed CPU (256 shares) and memory settings (512 MB) on ECS during performance testing to demonstrate that Consul on ECS along with application containers can run on the smallest ECS tasks.

The following table describes the maximum resource usage we observed for each container under these testing conditions:

The containers added by Consul on ECS consume resources well below the minimum CPU and memory limits for an ECS task. Use the memory and cpu settings for the task definition if additional resources are necessary for your application task.

Refer to Architecture for details about each component.