《Linkerd官方文档》在ECS中运行Linkerd
在ECS中运行
Amazon ECS是一个容器管理服务。本指南将演示使用ECS中的Linkerd进行路由和监控您的服务。
本指南中引用的所有命令和配置文件都可以在 linkerd-examples repo中找到。
概观
本指南将演示如何将Linkerd设置为服务网格,用于服务发现的Consul,hello-world示例应用程序以及用于监控的linkerd-viz,这些都位于全新的ECS集群上。
以下组件构成系统:
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实例上运行
需要注意的是linkerd
,consul-agent
和consul-registrator
在每个ECS节点上运行。在编写本指南时,ECS调度程序没有明确支持这一点。相反,我们使用AWS启动配置来引导这三个基础服务的每个ECS节点。我们仍然通过aws ecs start-task
命令启动这些基础服务,因此它们将作为运行ECS容器可见。
初始设置
本指南假定您已经为AWS配置了适当的IAM,密钥对和VPC。欲了解更多信息,请点击此处:http : //docs.aws.amazon.com/AmazonECS/latest/developerguide/get-set-up-for-amazon-ecs.html
设置一个你将用来访问你的实例的密钥对,或者省略参数来放弃ssh访问。
KEY_PAIR=<MY KEY PAIR NAME>
创建一个安全组,允许外部访问以下内容:
- ssh:22
linkerd
路由:4140linkerd
管理用户界面:9990linkerd-viz
:3000consul-agent
和consul-server
UI:8500GROUP_ID=$(aws ec2 create-security-group --group-name l5d-demo-sg --description "Linkerd Demo" | jq -r .GroupId) aws ec2 authorize-security-group-ingress --group-id $GROUP_ID \ --ip-permissions \ FromPort=22,IpProtocol=tcp,ToPort=22,IpRanges=[{CidrIp="0.0.0.0/0"}] \ FromPort=4140,IpProtocol=tcp,ToPort=4140,IpRanges=[{CidrIp="0.0.0.0/0"}] \ FromPort=9990,IpProtocol=tcp,ToPort=9990,IpRanges=[{CidrIp="0.0.0.0/0"}] \ FromPort=3000,IpProtocol=tcp,ToPort=3000,IpRanges=[{CidrIp="0.0.0.0/0"}] \ FromPort=8500,IpProtocol=tcp,ToPort=8500,IpRanges=[{CidrIp="0.0.0.0/0"}] \ IpProtocol=-1,UserIdGroupPairs=[{GroupId=$GROUP_ID}]
安全组还打开节点之间的每个端口。有关节点内通信所需的所有端口的完整列表,请参阅linkerd-examples repo的ECS任务定义文件
Consul服务器
出于演示目的,我们在ECS集群外运行一个Consul服务器。
aws ec2 run-instances --image-id ami-7d664a1d \
--instance-type m4.xlarge \
--user-data file://consul-server-user-data.txt \
--placement AvailabilityZone=us-west-1a \
--tag-specifications "ResourceType=instance,Tags=[{Key=Name,Value=l5d-demo-consul-server}]" \
--key-name $KEY_PAIR --security-group-ids $GROUP_ID
我们用l5d-demo-consul-server
来标记这个实例。然后,我们将在每个ECS节点上运行的consul-agent
配置中引用此标记。这使得 consul-agent
找到consul-server
。
ECS集群
创建一个名为l5d-demo
的新ECS集群
aws ecs create-cluster --cluster-name l5d-demo
我们可以参考l5d-demo
在引导我们的ECS节点时,以指示他们加入我们刚刚创建的ECS群集。
角色策略
创建角色策略以允许ECS实例启动任务并描述实例。
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
。
aws ecs register-task-definition --cli-input-json file://linkerd-task-definition.json
aws ecs register-task-definition --cli-input-json file://linkerd-viz-task-definition.json
aws ecs register-task-definition --cli-input-json file://consul-agent-task-definition.json
aws ecs register-task-definition --cli-input-json file://consul-registrator-task-definition.json
aws ecs register-task-definition --cli-input-json file://hello-world-task-definition.json
创建启动配置
这一步定义了启动配置。在 ecs-user-data.txt 文件指示 Launch Configuration配置和引导linkerd
, consul-agent
以及consul-registrator
在每个ECS节点上。
aws autoscaling create-launch-configuration \
--launch-configuration-name l5d-demo-lc \
--image-id ami-7d664a1d \
--instance-type m4.xlarge \
--user-data file://ecs-user-data.txt \
--iam-instance-profile ecsInstanceRole \
--security-groups $GROUP_ID \
--key-name $KEY_PAIR
注意 ecs-user-data.txt 文件为linkerd
,consul-agent
以及consul-registrator
中的每个动态生成配置文件,使用具体到其上运行的ECS实例数据。
创建Auto Scaling组
此步骤实际上基于上面定义的启动配置创建EC2实例。完成后,我们应该有两个ECS节点,每个节点运行 linkerd
,consul-agent
和consul-registrator
。
aws autoscaling create-auto-scaling-group \
--auto-scaling-group-name l5d-demo-asg \
--launch-configuration-name l5d-demo-lc \
--min-size 1 --max-size 3 --desired-capacity 2 \
--tags ResourceId=l5d-demo-asg,ResourceType=auto-scaling-group,Key=Name,Value=l5d-demo-ecs,PropagateAtLaunch=true \
--availability-zones us-west-1a
我们用l5d-demo-ecs
来命名实例,以便稍后以编程方式查找它们。
部署hello-world
现在我们已经部署了所有的基础服务,我们可以部署一个示例应用程序。该hello-world
任务由hello
服务,world
服务和world-v2
服务组成。为了演示服务间通信,我们通过linkerd
配置hello
服务来调用world
服务。
aws ecs run-task --cluster l5d-demo --task-definition hello-world --count 2
请注意,我们已经部署了hello-worldd
的两个实例,这导致了两个 hello
容器,两个world
容器和两个world-v2
容器。
测试一切正常
我们通过l5d-demo-ecs
名称选择一个任意的ECS节点,然后通过Linkerd curlhello
服务:
# Select an ECS node
ECS_NODE=$( \
aws ec2 describe-instances \
--filters Name=instance-state-name,Values=running Name=tag:Name,Values=l5d-demo-ecs \
--query Reservations[*].Instances[0].PublicDnsName --output text \
)
# test routing via Linkerd
http_proxy=$ECS_NODE:4140 curl hello
Hello (172.31.20.160) World (172.31.19.35)!!
# view Linkerd and Consul UIs (osx)
open http://$ECS_NODE:9990
open http://$ECS_NODE:8500
我们刚测试过的请求流程:
curl
– > linkerd
– > hello
– > linkerd
– >world
测试动态请求路由
由于我们的hello-world
任务还包括一项world-v2
服务,我们来测试每个请求路由:
http_proxy=$ECS_NODE:4140 curl -H 'l5d-dtab: /svc/world => /svc/world-v2' hello
Hello (172.31.20.160) World-V2 (172.31.19.35)!!
通过设置l5d-dtab
头,我们指示Linkerd动态路线运往从world
到world-v2
的所有请求。
有关更多信息,请查看 动态请求路由。
linkerd,即
linkerd-viz
收集并显示所有linkerd
在集群中运行的指标。在部署之前,让我们通过我们的系统加载一些负载:
while true; do http_proxy=$ECS_NODE:4140 curl -s -o /dev/null hello; done
现在部署一个linkerd-viz实例:
aws ecs run-task --cluster l5d-demo --task-definition linkerd-viz --count 1
# find the ECS node running linkerd-viz
TASK_ID=$(aws ecs list-tasks --cluster l5d-demo --family linkerd-viz --desired-status RUNNING --query taskArns[0] --output text)
CONTAINER_INSTANCE=$(aws ecs describe-tasks --cluster l5d-demo --tasks $TASK_ID --query tasks[0].containerInstanceArn --output text)
INSTANCE_ID=$(aws ecs describe-container-instances --cluster l5d-demo --container-instances $CONTAINER_INSTANCE --query containerInstances[0].ec2InstanceId --output text)
ECS_NODE=$(aws ec2 describe-instances --instance-ids $INSTANCE_ID --query Reservations[*].Instances[0].PublicDnsName --output text)
# view linkerd-viz (osx)
open http://$ECS_NODE:3000
如果一切正常,我们应该看到像这样的仪表板:
进一步阅读
有关配置Linkerd的更多信息,请参阅 Linkerd配置页面。
有关linkerd-viz的更多信息,请参阅 linkerd-viz GitHub repo。
原创文章,转载请注明: 转载自并发编程网 – ifeve.com本文链接地址: 《Linkerd官方文档》在ECS中运行Linkerd
暂无评论