在Amazon EKS上部署Docker Compose on Kubernetes全指南

在Amazon EKS上部署Docker Compose on Kubernetes全指南

前言

Docker Compose on Kubernetes项目将我们熟悉的Compose体验带入了Kubernetes世界。本文将详细介绍如何在Amazon EKS（Elastic Kubernetes Service）上部署这一解决方案，帮助开发者在Kubernetes环境中无缝使用Compose工作流。

准备工作

在开始部署前，请确保满足以下先决条件：

1. 已创建好EKS集群（建议版本不低于1.14）
2. 本地环境已安装配置好kubectl工具，并能正常访问EKS集群
3. 已安装Helm包管理工具（用于后续etcd部署）
4. 已下载对应平台的Compose on Kubernetes安装程序

部署步骤详解

第一步：创建命名空间

首先需要为Compose组件创建专用的命名空间：

kubectl create namespace compose

这个命名空间将用于存放所有Compose相关的Kubernetes资源。

第二步：部署etcd集群

Compose on Kubernetes需要独立的etcd实例（与kube-system中的etcd分开），我们推荐使用Helm进行部署：

1. 添加etcd Helm仓库
2. 配置适当的values.yaml参数
3. 使用Helm安装到compose命名空间

etcd将负责存储Compose的元数据和状态信息。对于生产环境，建议配置3节点集群以确保高可用性。

第三步：安装Compose on Kubernetes

运行对应平台的安装程序：

./installer-[平台类型] -namespace=compose -etcd-servers=http://compose-etcd-client:2379

关键参数说明：

• -namespace：指定安装的目标命名空间
• -etcd-servers：指定etcd服务地址

安全提示：对于生产环境，建议启用etcd的mTLS认证，可以通过以下附加参数配置：

• etcd-ca-file：CA证书路径
• etcd-key-file：客户端私钥路径
• etcd-cert-file：客户端证书路径

第四步：验证部署

安装完成后，可以通过以下方式验证：

1. 检查compose命名空间下的Pod状态
2. 查看Compose API是否可用
3. 尝试部署示例应用栈

部署应用示例

成功安装后，我们可以部署一个示例应用栈。部署完成后，通过kubectl get svc可以看到类似以下输出：

NAME            TYPE           CLUSTER-IP       EXTERNAL-IP
db              ClusterIP      None             <none>
web             ClusterIP      None             <none>
web-published   LoadBalancer   10.100.130.153   ad0884309cd8a...eu-central-1.elb.amazonaws.com

其中web-published服务通过AWS LoadBalancer暴露，可以通过浏览器访问<LoadBalancer外部IP>:33000来访问应用。

高级配置：Kubernetes服务代理

在某些场景下（如运行端到端测试），可能需要通过Kubernetes API服务器代理访问服务。EKS默认的安全组配置会阻止控制平面与工作节点在特权端口(<1024)上的通信。

解决方案架构如下：

客户端 -> kubectl代理 -> Kubernetes API服务器 -> kube-proxy -> 目标服务

要启用此功能，需要调整EKS网络安全组设置，允许控制平面与工作节点间的必要通信。具体配置方法请参考EKS官方文档中的安全组要求部分。

最佳实践建议

1. 生产环境务必配置etcd的TLS加密和认证
2. 定期备份etcd数据
3. 为compose命名空间配置适当的资源限制和配额
4. 监控Compose控制器组件的运行状态
5. 考虑使用IAM角色进行细粒度的访问控制

通过以上步骤，您已成功在EKS上部署了Docker Compose on Kubernetes，现在可以像使用传统Compose一样在Kubernetes环境中定义和运行您的应用了。