dockersamples/examplevotingapp_result

示例投票应用结果镜像

镜像概述和主要用途

该镜像为Docker示例投票应用（Example Voting App）的结果展示组件，是一个基于Node.js构建的前端应用。它作为分布式应用的一部分，负责从Postgres数据库获取投票数据并实时展示投票结果，是完整投票系统中用户查看结果的核心界面。

核心功能和特性

• 实时结果展示：通过前端界面动态展示投票数据，实时反映投票进展
• 数据交互：与Postgres数据库交互，获取最新投票统计信息
• 跨容器协作：作为分布式系统的一部分，与投票前端、Redis消息队列、.NET处理服务和Postgres数据库协同工作
• 多环境支持：可在Docker Compose、Docker Swarm和Kubernetes环境中部署运行

使用场景和适用范围

• Docker容器化应用教学示例
• 分布式系统架构演示
• Docker Compose、Docker Swarm和Kubernetes部署实践
• 多语言（Python、Node.js、.NET）混合应用开发参考

详细使用方法和配置说明

环境准备

1. 安装Docker Desktop（Mac/Windows），Docker Compose将自动安装
2. Linux用户需单独安装最新版本的Docker Compose

Docker Compose部署

在项目目录中执行以下命令构建并运行整个应用栈：

shell
docker compose up

结果应用将运行在 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. 结果应用将在集群的31001端口上可用

3. 移除部署：

shell
kubectl delete -f k8s-specifications/

架构说明

该结果镜像作为整个投票应用架构的一部分，与其他组件协同工作：

• 投票前端：Python应用（运行在5000端口），提供投票界面
• Redis：消息队列，收集新投票
• .NET Worker：处理投票数据并存储到Postgres数据库
• Postgres：数据库，持久化存储投票数据（使用Docker卷）
• 结果应用：Node.js前端（本镜像），实时展示投票结果（运行在5001端口/K8s的31001端口）

注意事项

• 投票应用对每个客户端浏览器仅接受一次投票，已提交投票的客户端不会记录额外投票
• 本应用仅作为演示示例，不代表生产级分布式应用的最佳架构设计，主要用于展示Docker容器化应用的基本组件和交互方式