ckassen/recommenderservice

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

镜像概述

本镜像对应一个进阶技术workshop（等级300），旨在演示如何使用AWS Elastic Kubernetes Service（EKS）、Amazon CloudWatch Logs和AWS X-Ray构建和监控现代应用。用户需具备AWS能力、软件开发、容器及Kubernetes的深入知识。

核心功能

该workshop包含3个实验室：

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

应用架构

演示应用架构包含以下组件：

• 服务：基于Node.js（Express框架）或Python（Flask框架）开发；
• 数据存储：使用DynamoDB；
• 会话与购物车数据：自托管Redis；
• 订单处理：通过SQS队列传递订单，由worker进程处理。

使用场景

• AWS EKS用户学习微服务可观测性实践；
• 开发人员掌握云原生应用的日志、指标与分布式追踪技术；
• 团队开展云原生监控方案的培训与演练。

配置说明

前提条件

需满足前提条件（如安装eksctl、kubectl、AWS CLI等）。

部署示例

检查并创建ELB服务角色

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

创建StorageClass（用于Prometheus和Grafana部署）

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

故障排除

• Cloud9无法连接：确保EC2实例运行且有公网IP，或使用常规EC2 Linux实例执行命令；
• EKS集群认证失败：避免使用根用户创建集群，确保kubectl版本≥1.10.0且安装aws-iam-authenticator；
• 负载均衡URL无法访问：等待ELB创建及DNS传播，或在EC2控制台查看负载均衡器详情；
• 追踪不可见：检查X-Ray守护进程运行状态及权限配置；
• 集群创建超时：删除集群后重试（正常需10-15分钟）。

许可证

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

参考与致谢

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