Example Voting App

概述和主要用途

一个跨多个Docker容器运行的简单分布式应用，主要用于演示分布式应用在Docker生态系统中的部署和运行，适用于学***和非盈利目的。

核心功能和特性

• 多容器架构：由前端、队列、worker、数据库和结果显示多个组件构成
• 跨平台支持：提供Linux容器和Windows容器两种版本
• 多技术栈：包含Python、Node.js、.NET Core、Java等多种编程语言和技术
• 消息队列：使用Redis（Linux）或NATS（Windows）处理投票消息
• 数据存储：采用Postgres（Linux）或TiDB（Windows）数据库持久化存储投票数据
• 实时结果展示：通过Node.js或ASP.NET Core SignalR实时显示投票结果
• 多部署方式：支持Docker Compose、Docker Swarm和Kubernetes部署

使用场景和适用范围

• Docker、Docker Compose、Docker Swarm学***和实践
• Kubernetes部署演示
• 分布式应用基础架构组件（队列、持久化存储等）的Docker化处理演示
• 非生产环境下的娱乐和教育用途

详细使用方法和配置说明

准备工作

下载Docker Desktop（Mac或Windows），Docker Compose会自动安装。Linux用户需确保安装最新版本的Docker Compose。

Linux容器

Linux栈使用Python、Node.js、.NET Core（可选Java），Redis用于消息传递，Postgres用于存储。

若使用Windows版Docker Desktop，可通过切换到Linux容器运行Linux版本，或运行Windows容器版本。

在当前目录运行：

bash
docker-compose up

应用将运行在http://localhost:5000，结果页面在http://localhost:5001。

若要在Docker Swarm上运行，首先确保已创建swarm（若未创建，运行docker swarm init），然后在当前目录运行：

bash
docker stack deploy --compose-file docker-stack.yml vote

Windows容器

应用的另一个版本使用基于Nano Server的Windows容器，栈运行在.NET Core上，使用NATS进行消息传递，TiDB作为存储。

可通过以下命令从源代码构建：

bash
docker-compose -f docker-compose-windows.yml build

然后运行应用：

bash
docker-compose -f docker-compose-windows.yml up -d

或在Windows swarm中运行docker stack deploy -c docker-stack-windows.yml vote

应用将运行在http://localhost:5000，结果页面在http://localhost:5001。

在Kubernetes中运行应用

k8s-specifications文件夹包含投票应用服务的yaml规范。

首先创建vote命名空间：

bash
kubectl create namespace vote

运行以下命令创建部署和服务对象：

bash
kubectl create -f k8s-specifications/
deployment "db" created
service "db" created
deployment "redis" created
service "redis" created
deployment "result" created
service "result" created
deployment "vote" created
service "vote" created
deployment "worker" created

投票界面在集群各主机的31000端口可用，结果界面在31001端口可用。

架构

!架构图

• 前端Web应用：Python或ASP.NET Core，用于在两个选项间投票
• 队列：Redis或NATS，用于收集新投票
• Worker：.NET Core、Java或.NET Core 2.1，用于处理投票并存储到...
• 数据库：Postgres或TiDB，由Docker卷支持持久化数据
• 结果Web应用：Node.js或ASP.NET Core SignalR，用于实时显示投票结果

注意事项

• 投票应用仅接受每个客户端一次投票，若客户端已提交投票则不再记录。
• 这不是一个架构完善、设计完美的分布式应用……只是一个简单示例，展示了可能遇到的各种组件和语言（队列、持久化数据等），以及如何在Docker中进行基本处理。