dockersamples/examplevotingapp_worker

示例投票应用工作节点镜像

镜像概述和主要用途

该镜像为Docker示例投票应用（Example Voting App）的工作节点组件，是一个基于.NET开发的服务，负责从Redis消息队列中消费投票数据，并将处理后的结果存储到Postgres数据库，是整个分布式投票应用的数据处理核心。

核心功能和特性

• 数据处理：消费Redis中收集的新投票数据
• 数据持久化：将投票结果存储到Postgres数据库
• 跨语言协作：与Python前端、Node.js结果展示、Redis消息队列及Postgres数据库协同工作
• 轻量级部署：支持Docker Compose、Docker Swarm和Kubernetes等多种容器编排环境

使用场景和适用范围

• Docker容器化应用开发学习示例
• 分布式系统多组件协作演示
• 微服务架构基础部署实践
• 容器编排工具（Docker Compose/Swarm、Kubernetes）使用教学

使用方法和配置说明

前置要求

• 安装Docker Desktop（Mac/Windows）或最新版Docker Compose（Linux）
• 如需在Kubernetes环境运行，需提前配置Kubernetes集群

使用Docker Compose部署

在项目根目录执行以下命令构建并启动整个应用栈（包含工作节点）：

shell
docker compose up

应用启动后，投票界面可通过http://localhost:5000访问，结果界面通过http://localhost:5001访问。

使用Docker Swarm部署

1. 初始化Swarm集群（如未初始化）：

shell
docker swarm init

2. 部署应用栈：

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

在Kubernetes中部署

1. 使用k8s-specifications目录下的YAML配置创建资源：

shell
kubectl create -f k8s-specifications/

2. 访问服务：
   • 投票应用：集群各节点的31000端口
   • 结果应用：集群各节点的31001端口
3. 移除资源：

shell
kubectl delete -f k8s-specifications/

架构

!https://raw.githubusercontent.com/dockersamples/example-voting-app/main/architecture.png

整个应用架构包含：

• Python前端：提供投票界面（http://localhost:5000）
• Redis：作为消息队列收集新投票
• .NET工作节点（当前镜像）：消费投票并存储到数据库
• Postgres：持久化存储投票结果（使用Docker卷）
• Node.js结果应用：实时展示投票结果（http://localhost:5001）

注意事项

• 投票限制：每个客户端浏览器仅允许提交一次投票，重复提交将被忽略
• 架构说明：本应用仅作为演示容器化分布式应用基础组件（队列、持久化存储等）及Docker使用方法的示例，非生产级架构设计