ckassen/frontend

使用AWS X-Ray和Amazon CloudWatch实现Kubernetes可观测性

本工作坊旨在演示如何利用AWS弹性Kubernetes服务（EKS）、Amazon CloudWatch Logs和AWS X-Ray构建并监控现代应用。

工作坊结构

本工作坊包含3个实验：

1. 实验1：环境准备、用eksctl创建EKS集群、部署电商微服务演示应用
2. 实验2：部署日志聚合栈、指标收集与可视化工具
3. 实验3：部署AWS X-Ray并在示例应用中启用分布式追踪

注意
本工作坊为高级内容（300级），需具备AWS能力、软件开发、容器及Kubernetes的深入知识。

应用架构

部署的应用架构如下：
（原文档架构图链接：docs/images/architecture.png）
服务基于Node.js（Express）或Python（Flask）构建，数据存储用DynamoDB，购物车/会话数据存于自托管Redis，订单通过SQS队列处理。

实验指南

前提条件

前提条件文档

实验1 - EKS微服务部署

EKS微服务部署文档

实验2 - EKS可观测性配置

EKS可观测性文档

实验3 - X-Ray分布式追踪

X-Ray追踪配置文档

清理操作

清理说明文档

故障排除

Cloud9连接失败

确保Cloud9实例运行且有公网IP；若仍异常，改用普通EC2 Linux实例执行命令。

EKS认证失败

使用IAM用户创建集群，确保kubectl≥1.10.0且安装aws-iam-authenticator。

负载均衡器不可访问

等待ELB创建及DNS传播，或在EC2控制台查看负载均衡器详情。

追踪数据缺失

检查X-Ray守护进程日志，确认发送权限配置正确。

集群创建超时

EKS集群创建需10-15分钟，超时则删除重试。

ELB角色检查

执行命令创建缺失的ELB服务角色：

bash
aws iam get-role --role-name "AWSServiceRoleForElasticLoadBalancing" || aws iam create-service-linked-role --aws-service-name "elasticloadbalancing.amazonaws.com"

存储类配置

若缺失存储类，执行命令创建Prometheus存储类：

bash
kubectl create -f - <<EOF
{
  "kind": "StorageClass",
  "apiVersion": "storage.k8s.io/v1",
  "metadata": {"name":"prometheus","namespace":"prometheus"},
  "provisioner":"kubernetes.io/aws-ebs",
  "parameters":{"type":"gp2"},
  "reclaimPolicy":"Retain",
  "mountOptions":["debug"]
}
EOF

更新日志

• 2020-04-15：合并***分支到master，简化部署维护。

参考与致谢

1. Amazon EKS工作坊
2. https://github.com/weaveworks
3. https://github.com/GoogleCloudPlatform/microservices-demo

许可证摘要

本代码基于修改后的MIT许可证发布，详见LICENSE文件。