GitHub Hot Board

GitHub Hot Board · Repository archive

dockersamples/example-voting-app

Example distributed app composed of multiple containers for Docker, Compose, Swarm, and Kubernetes (This description comes from the repository itself.)

Data at October 26dockersamples

Best

#238

King of Forks

5.8K

Total stars

17K

Total forks

3

Days on boards (30d)

On boards 3d · +4 stars in 30d · ~+1/dayOn a 3-day streak

Project statusLicense: Apache-2.0Last push: October 10Open issues: 98

Collected since 2026-10-25; unknown = not yet harvested

Put your badge on the README · dockersamples/example-voting-app[![Put your badge on the README](https://git.vaiox.xyz/api/badge/dockersamples/example-voting-app.svg)](https://git.vaiox.xyz/en/repo/dockersamples/example-voting-app)
<a href="https://git.vaiox.xyz/en/repo/dockersamples/example-voting-app"><img src="https://git.vaiox.xyz/api/badge/dockersamples/example-voting-app.svg" alt="Put your badge on the README" height="20"></a>

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:

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:

docker swarm init

Once you have your swarm, in this directory run:

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.)

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:

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.

Current rankings

Momentum, past 30 days

Cumulative stars

Rank movement

Daily star gain

Racing nearby on the same board · Fork kings

Similar projects · shared topics

← Back to boards