Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dockersamples/example-voting-app
Example distributed app composed of multiple containers for Docker, Compose, Swarm, and Kubernetes
https://github.com/dockersamples/example-voting-app
demo docker docker-compose example kubernetes sample swarm
Last synced: 22 days ago
JSON representation
Example distributed app composed of multiple containers for Docker, Compose, Swarm, and Kubernetes
- Host: GitHub
- URL: https://github.com/dockersamples/example-voting-app
- Owner: dockersamples
- License: apache-2.0
- Created: 2015-11-15T19:59:56.000Z (almost 9 years ago)
- Default Branch: main
- Last Pushed: 2024-09-20T16:34:31.000Z (about 2 months ago)
- Last Synced: 2024-10-01T22:21:31.792Z (about 1 month ago)
- Topics: demo, docker, docker-compose, example, kubernetes, sample, swarm
- Language: C#
- Homepage:
- Size: 1.17 MB
- Stars: 4,675
- Watchers: 123
- Forks: 10,676
- Open Issues: 39
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-list - example-voting-app
- awesome-list-docker - example-voting-app
README
# Example Voting App
A simple distributed application running across multiple Docker containers.
## Getting started
Download [Docker Desktop](https://www.docker.com/products/docker-desktop) for Mac or Windows. [Docker Compose](https://docs.docker.com/compose) will be automatically installed. On Linux, make sure you have the latest version of [Compose](https://docs.docker.com/compose/install/).
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](http://localhost:8080), and the `results` will be at [http://localhost:8081](http://localhost:8081).
Alternately, if you want to run it on a [Docker Swarm](https://docs.docker.com/engine/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
* A front-end web app in [Python](/vote) which lets you vote between two options
* A [Redis](https://hub.docker.com/_/redis/) which collects new votes
* A [.NET](/worker/) worker which consumes votes and stores them in…
* A [Postgres](https://hub.docker.com/_/postgres/) database backed by a Docker volume
* A [Node.js](/result) 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.