在ECS中运行

亚马逊ECS 是一个容器管理服务。本指南将演示使用ECS中的linkerd路由和监控您的服务。

本指南中引用的所有命令和配置文件可以在 linkerd-examples repo 中找到。

概述

本指南将演示在全新的ECS集群上搭建linkerd作为服务网格，consul作为服务发现，hello-world示例应用程序和用于监控的 linkerd-viz。

系统由以下组件组成：

  • ECS: Docker容器管理。每个ECS实例运行以下Docker容器：

    • linkerd：代理请求到 hello-world
    • consul-agent：本地服务发现代理
    • consul-registrator：Docker和Consul之间的桥梁，自动使用consul注册服务

  • hello-world： 示例ECS任务,在基础 ECS + linkerd + consul-agent 配置上单独部署，组成hello，world 和 world-v2 服务

  • linkerd-viz：ECS任务, 在基础 ECS + linkerd + consul-agent 配置上单独部署, 为所有服务流量提供监控仪表板
  • consul-server：服务发现后端，在单个EC2实例上运行

在ECS中运行 - 图1

Linerd in ECS

需要注意的是 linkerd，consul-agent 和 consul-registrator 在每个ECS节点上运行。在本指南的撰写之前，ECS调度程序并没有明确支持这一点。相反，我们使用AWS启动配置来引导每个ECS节点和这三个基础服务。我们仍然通过 aws ecs start-task 命令启动这些基础服务，因此它们将可见,作为运行的ECS容器。

初始搭建

本指南假设您已经将AWS配置为适用于ECS群集的IAM，密钥对和VPC。更多信息，请从这里开始：

http://docs.aws.amazon.com/AmazonECS/latest/developerguide/get-set-up-for-amazon-ecs.html

设置您将用于访问实例的密钥对，或者省略参数以放弃ssh访问。

  1. KEY_PAIR=<MY KEY PAIR NAME>

创建安全组,以允许外部访问以下内容：

  • ssh：22
  • linkerd 路由：4140
  • linkerd admin UI：9990
  • linkerd-viz：3000
  • consul-agent 和 consul-serverUI：8500
  1. GROUP_ID=$(aws ec2 create-security-group --group-name l5d-demo-sg --description "Linkerd Demo" | jq -r .GroupId)
  2. aws ec2 authorize-security-group-ingress --group-id $GROUP_ID \
  3.   --ip-permissions \
  4.   FromPort=22,IpProtocol=tcp,ToPort=22,IpRanges=[{CidrIp="0.0.0.0/0"}] \
  5.   FromPort=4140,IpProtocol=tcp,ToPort=4140,IpRanges=[{CidrIp="0.0.0.0/0"}] \
  6.   FromPort=9990,IpProtocol=tcp,ToPort=9990,IpRanges=[{CidrIp="0.0.0.0/0"}] \
  7.   FromPort=3000,IpProtocol=tcp,ToPort=3000,IpRanges=[{CidrIp="0.0.0.0/0"}] \
  8.   FromPort=8500,IpProtocol=tcp,ToPort=8500,IpRanges=[{CidrIp="0.0.0.0/0"}] \
  9.   IpProtocol=-1,UserIdGroupPairs=[{GroupId=$GROUP_ID}]

安全组还打开节点之间的每个端口。有关节点间通信所需的所有端口的全面列表，请参考在 linkerd-examples repo 中找到的ECS任务定义文件.

Consul服务器

为了演示的目的，我们在ECS群集之外运行一个consul服务器。

  1. aws ec2 run-instances --image-id ami-7d664a1d \
  2.   --instance-type m4.xlarge \
  3.   --user-data file://consul-server-user-data.txt \
  4.   --placement AvailabilityZone=us-west-1a \
  5.   --tag-specifications "ResourceType=instance,Tags=[{Key=Name,Value=l5d-demo-consul-server}]" \
  6.   --key-name $KEY_PAIR --security-group-ids $GROUP_ID

我们用 l5d-demo-consul-server 标记这个实例。我们将在每个ECS节点上运行的 consul-agent 配置中引用此标签。这使得 consul-agent 能够找到 consul-server。

ECS集群

创建一个名为 l5d-demo 的新ECS集群

  1. aws ecs create-cluster --cluster-name l5d-demo

我们在引导ECS节点时引用 l5d-demo，指示他们加入我们刚创建的ECS集群。

角色政策

创建角色策略以允许ECS实例启动任务并描述实例。

  1. aws iam put-role-policy --role-name ecsInstanceRole --policy-name l5dDemoPolicy --policy-document file://ecs-role-policy.json

我们需要 ecs:StartTask 能力，因为我们的启动配置将启动我们在每个ECS节点上的三个基础任务。我们需要 ec2:DescribeInstances 能力，因为 consul-agent 需要通过 l5d-demo-consul-server 实例标签来查找 consul-server 。

注册任务定义

这些任务定义描述了如何配置和引导所有五个应用程序。请注意，hello-world 描述三个独立的Docker容器，hello, world，和 world-v2。

  1. aws ecs register-task-definition --cli-input-json file://linkerd-task-definition.json
  2. aws ecs register-task-definition --cli-input-json file://linkerd-viz-task-definition.json
  3. aws ecs register-task-definition --cli-input-json file://consul-agent-task-definition.json
  4. aws ecs register-task-definition --cli-input-json file://consul-registrator-task-definition.json
  5. aws ecs register-task-definition --cli-input-json file://hello-world-task-definition.json

创建启动配置

此步骤定义了启动配置。ecs-user-data.txt 文件指示启动配置来配置和引导每个ECS节点上的 linkerd， consul-agent 以及 consul-registrator。

  1. aws autoscaling create-launch-configuration \
  2.   --launch-configuration-name l5d-demo-lc \
  3.   --image-id ami-7d664a1d \
  4.   --instance-type m4.xlarge \
  5.   --user-data file://ecs-user-data.txt \
  6.   --iam-instance-profile ecsInstanceRole \
  7.   --security-groups $GROUP_ID \
  8.   --key-name $KEY_PAIR

注意 ecs-user-data.txt 文件为每个 linkerd，consul-agent 以及 consul-registrator 动态生成的配置文件, 使用它运行在其上的ECS实例的具体数据。

创建自动缩放组

根据上面定义的启动配置, 此步骤实际创建EC2实例。完成后，我们会有两个ECS节点，每个节点运行 linkerd，consul-agent 和 consul-registrator。

  1. aws autoscaling create-auto-scaling-group \
  2.   --auto-scaling-group-name l5d-demo-asg \
  3.   --launch-configuration-name l5d-demo-lc \
  4.   --min-size 1 --max-size 3 --desired-capacity 2 \
  5.   --tags ResourceId=l5d-demo-asg,ResourceType=auto-scaling-group,Key=Name,Value=l5d-demo-ecs,PropagateAtLaunch=true \
  6.   --availability-zones us-west-1a

我们命名我们的实例 l5d-demo-ecs 以便我们以后可以通过编程方式找到它们。

部署hello-world

现在我们已经部署了所有的基础服务，我们可以部署一个示例应用程序。该 hello-world 任务由 hello 服务，world 服务和 world-v2 服务组成。为了演示业务间通信，我们配置 hello 服务通过服务linkerd来呼叫 world 。

  1. aws ecs run-task --cluster l5d-demo --task-definition hello-world --count 2

请注意，我们已经部署了两个实例 hello-world，它们生成两个 hello 容器，两个 world 容器和两个 world-v2 容器。

验证所有工作

通过 l5d-demo-ecs 名称, 我们选择任意ECS节点，然后用 curl 通过linkerd 访问 hello 服务：

  1. # Select an ECS node
  2. ECS_NODE=$( \
  3.   aws ec2 describe-instances \
  4.     --filters Name=instance-state-name,Values=running Name=tag:Name,Values=l5d-demo-ecs \
  5.     --query Reservations[*].Instances[0].PublicDnsName --output text \
  6. )
  8. # test routing via linkerd
  9. http_proxy=$ECS_NODE:4140 curl hello
  10. Hello (172.31.20.160) World (172.31.19.35)!!
  12. # view linkerd and Consul UIs (osx)
  13. open http://$ECS_NODE:9990
  14. open http://$ECS_NODE:8500

我们刚刚测试的请求流程：

curl -> linkerd -> hello -> linkerd -> world

测试动态请求路由

我们的 hello-world 任务还包括一项 world-v2 服务，我们来测试每请求路由：

  1. http_proxy=$ECS_NODE:4140 curl -H 'l5d-dtab: /svc/world => /svc/world-v2' hello
  2. Hello (172.31.20.160) World-V2 (172.31.19.35)!!

通过设置 l5d-dtab header，我们指示 linkerd 动态路由所有目的地为 world 的请求到 world-v2。

在ECS中运行 - 图2

linkerd请求路由

更多信息，请参阅 动态请求路由。

linkerd-viz

linkerd-viz 收集并显示所有 linkerd 在群集中运行的指标。在部署之前，让我们给系统一点负载：

  1. while true; do http_proxy=$ECS_NODE:4140 curl -s -o /dev/null hello; done

现在部署一个单独的 linkerd-viz 实例：

  1. aws ecs run-task --cluster l5d-demo --task-definition linkerd-viz --count 1
  3. # find the ECS node running linkerd-viz
  4. TASK_ID=$(aws ecs list-tasks --cluster l5d-demo --family linkerd-viz --desired-status RUNNING --query taskArns[0] --output text)
  5. CONTAINER_INSTANCE=$(aws ecs describe-tasks --cluster l5d-demo --tasks $TASK_ID --query tasks[0].containerInstanceArn --output text)
  6. INSTANCE_ID=$(aws ecs describe-container-instances --cluster l5d-demo --container-instances $CONTAINER_INSTANCE --query containerInstances[0].ec2InstanceId --output text)
  7. ECS_NODE=$(aws ec2 describe-instances --instance-ids $INSTANCE_ID --query Reservations[*].Instances[0].PublicDnsName --output text)
  9. # view linkerd-viz (osx)
  10. open http://$ECS_NODE:3000

如果一切正常，我们会看到一个这样的仪表板：

在ECS中运行 - 图3

LINKERD-VIZ IN ECS

进一步阅读

关于配置linkerd的更多信息，请参阅 linkerd配置 页面。

关于linkerd-viz的更多信息，请参阅 linkerd-viz GitHub repo。