dockersamples /example-voting-app
Example distributed app composed of multiple containers for Docker, Compose, Swarm, and Kubernetes
★ 5,851⑂ 16,620👁 122⑃ 441● 101▤ 0
+0
日增长
5,851
stars
16,620
forks
122
watchers
441
prs
101
issues
0
releases
README
Example Voting App A simple distributed application running across multiple Docker containers. Getting started Download Docker Desktop for Mac or Windows. Docker Compose will be automatically installed. On Linux, make sure you have the latest version of Compose. This solution uses Python, Node.js, .NET, with Redis for messaging and Postgres for storage. Run in this directory to build and run the app: shell docker compose up The vote app will be running at http://localhost:8080, and the results will be at http://localhost:8081. Alternately, if you want to run it on a Docker Swarm, first make sure you have a swarm. If you don't, run: shell docker swarm init Once you have your swarm, in this directory run: shell docker stack deploy --compose-file docker-stack.yml vote Run the app in Kubernetes The folder k8s-specifications contains the YAML specifications of the Voting App's services. Run the following command to create the deployments and services. Note it will create these resources in your current namespace (default if you haven't changed it.) shell kubectl create -f k8s-specifications/ The vote web app is then available on port 31000 on each host of the cluster, the result web app is available on port 31001. To remove them, run: shell kubectl delete -f k8s-specifications/ Architecture !Architecture diagram A front-end web app in Python which lets you vote between two options A Redis which collects new votes A .NET worker which consumes votes and stores them in… A Postgres database backed by a Docker volume A Node.js web app which shows the results of the voting in real time Notes The voting application only accepts one vote per client browser. It does not register additional votes if a vote has already been submitted from a client. This isn't an example of a properly architected perfectly designed distributed app... it's just a simple example of the various types of pieces and languages you might see (queues, persistent data, etc), and how to deal with them in Docker at a basic level.
Top issues
#202Permission denied12 comments · 2021-04-13#324Worker App build error9 comments · 2023-12-08#165Voter does not seems to be working as the result app only shows the same results over and over again8 comments · 2020-03-29#359Result apps not showing the results5 comments · 2024-07-21#262Cleanup Hub repo and images5 comments · 2022-12-03#289use GHA to update Docker Hub repo description4 comments · 2023-03-11#387Updated worker/Dockerfile for optimized Kubernetes deployment2 comments · 2025-03-07#332Port 5000 is used by MacOSX Ventura 13.6.2 2 comments · 2024-01-19