Ei kuvausta

4 Haarat

Bret Fisher f0fb81f707 Adding docker hub to push list (#271)		2 vuotta sitten
.github	f0fb81f707 Adding docker hub to push list (#271)	2 vuotta sitten
healthchecks	383b74158e healthchecks! move to compose spec version!	4 vuotta sitten
k8s-specifications	176ed0ee73 Merge pull request #152 from pocteo/feature/add_vote_namespace	4 vuotta sitten
result	3ccc624fd7 update result node.js deps for multi-arch	2 vuotta sitten
seed-data	a33c638b2f adding data seeding	4 vuotta sitten
vote	89e063d047 Update TargetFramework to 3.1	4 vuotta sitten
worker	7e7445a601 Clean up worker service (#272)	2 vuotta sitten
.gitignore	4350dd6738 ignore node_modules in git and docker build	5 vuotta sitten
ExampleVotingApp.sln	879e5bc477 Add .NET Core 2.1 versions	6 vuotta sitten
LICENSE	e41af6b81c Add LICENSE and MAINTAINERS	9 vuotta sitten
MAINTAINERS	af94bc5c08 added new maintainers!	4 vuotta sitten
README.md	7e7445a601 Clean up worker service (#272)	2 vuotta sitten
architecture.png	82fd54e28f Update architecture diagram	9 vuotta sitten
docker-compose-k8s.yml	6494a7a7e0 Version Was invalid, Fix to Version3 docker-compose	4 vuotta sitten
docker-compose-simple.yml	7d1e4a982d Set an explicit username/password for Postgres in the other Compose files too	5 vuotta sitten
docker-compose.seed.yml	a33c638b2f adding data seeding	4 vuotta sitten
docker-compose.yml	3ccc624fd7 update result node.js deps for multi-arch	2 vuotta sitten
docker-stack-simple.yml	e8e002bb23 Set an explicit username/password for Postgres in the swarm and k8s files too	5 vuotta sitten
docker-stack.yml	e8e002bb23 Set an explicit username/password for Postgres in the swarm and k8s files too	5 vuotta sitten
kube-deployment.yml	e8e002bb23 Set an explicit username/password for Postgres in the swarm and k8s files too	5 vuotta sitten

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.

Linux Containers

The Linux stack uses Python, Node.js, .NET Core, with Redis for messaging and Postgres for storage.

If you're using Docker Desktop on Windows, you can run the Linux version by switching to Linux containers, or run the Windows containers version.

Run in this directory:

docker compose up

The app will be running at http://localhost:5000, and the results will be at http://localhost:5001.

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.

First create the vote namespace

$ kubectl create namespace vote

Run the following command to create the deployments and services objects:

$ kubectl create -f k8s-specifications/
deployment "db" created
service "db" created
deployment "redis" created
service "redis" created
deployment "result" created
service "result" created
deployment "vote" created
service "vote" created
deployment "worker" created

The vote interface is then available on port 31000 on each host of the cluster, the result one is available on port 31001.

Architecture

A front-end web app in Python or ASP.NET Core which lets you vote between two options
A Redis or NATS queue which collects new votes
A .NET Core worker which consumes votes and stores them in…
A Postgres or TiDB database backed by a Docker volume
A Node.js or ASP.NET Core SignalR webapp which shows the results of the voting in real time

Notes

The voting application only accepts one vote per client. It does not register 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.

README.md