Sem descrição

Justin Cormack 5edf3f7c8d Merge pull request #197 from StefanScherer/update-dotnet-3-1 há 4 anos atrás
.github 44efef623c Update ISSUE_TEMPLATE há 8 anos atrás
healthchecks 383b74158e healthchecks! move to compose spec version! há 4 anos atrás
k8s-specifications 176ed0ee73 Merge pull request #152 from pocteo/feature/add_vote_namespace há 4 anos atrás
result 89e063d047 Update TargetFramework to 3.1 há 4 anos atrás
seed-data a33c638b2f adding data seeding há 4 anos atrás
vote 89e063d047 Update TargetFramework to 3.1 há 4 anos atrás
worker 89e063d047 Update TargetFramework to 3.1 há 4 anos atrás
.gitignore 4350dd6738 ignore node_modules in git and docker build há 5 anos atrás
ExampleVotingApp.sln 879e5bc477 Add .NET Core 2.1 versions há 6 anos atrás
LICENSE e41af6b81c Add LICENSE and MAINTAINERS há 9 anos atrás
MAINTAINERS af94bc5c08 added new maintainers! há 4 anos atrás
README.md bdac94dee9 Update readme há 4 anos atrás
architecture.png 82fd54e28f Update architecture diagram há 9 anos atrás
docker-compose-javaworker.yml 7d1e4a982d Set an explicit username/password for Postgres in the other Compose files too há 5 anos atrás
docker-compose-k8s.yml 6494a7a7e0 Version Was invalid, Fix to Version3 docker-compose há 4 anos atrás
docker-compose-simple.yml 7d1e4a982d Set an explicit username/password for Postgres in the other Compose files too há 5 anos atrás
docker-compose-windows-1809.yml 3dca8620e5 Update images for Windows 1809 há 5 anos atrás
docker-compose-windows.yml ac496c8b7e Pin to Nano Server SAC 2016 images há 6 anos atrás
docker-compose.seed.yml a33c638b2f adding data seeding há 4 anos atrás
docker-compose.yml 383b74158e healthchecks! move to compose spec version! há 4 anos atrás
docker-stack-simple.yml e8e002bb23 Set an explicit username/password for Postgres in the swarm and k8s files too há 5 anos atrás
docker-stack-windows-1809.yml 6dfc628088 Add Windows 1809 support há 6 anos atrás
docker-stack-windows.yml ac496c8b7e Pin to Nano Server SAC 2016 images há 6 anos atrás
docker-stack.yml e8e002bb23 Set an explicit username/password for Postgres in the swarm and k8s files too há 5 anos atrás
kube-deployment.yml e8e002bb23 Set an explicit username/password for Postgres in the swarm and k8s files too há 5 anos atrás

README.md

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 (or optionally Java), 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

Windows Containers

An alternative version of the app uses Windows containers based on Nano Server. This stack runs on .NET Core, using NATS for messaging and TiDB for storage.

You can build from source using:

docker-compose -f docker-compose-windows.yml build

Then run the app using:

docker-compose -f docker-compose-windows.yml up -d

Or in a Windows swarm, run docker stack deploy -c docker-stack-windows.yml vote

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

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

Architecture diagram

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.