Skip to content

Commit bcb2e0e

Browse files
committed
Document Windows options
1 parent e16d6ef commit bcb2e0e

File tree

1 file changed

+36
-6
lines changed

1 file changed

+36
-6
lines changed

README.md

Lines changed: 36 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,19 @@
11
Example Voting App
22
=========
33

4+
A simple distributed application running across multiple Docker containers.
5+
46
Getting started
57
---------------
68

7-
Download [Docker](https://www.docker.com/products/overview). If you are on 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/). If you're using [Docker for Windows](https://docs.docker.com/docker-for-windows/) on Windows 10 pro or later, you must also [switch to Linux containers](https://docs.docker.com/docker-for-windows/#switch-between-windows-and-linux-containers).
9+
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/).
10+
11+
12+
## Linux Containers
13+
14+
The Linux stack uses Python, Node.js, .NET Core (or optionally Java), with Redis for messaging and Postgres for storage.
15+
16+
> If you're using [Docker Desktop on Windows](https://store.docker.com/editions/community/docker-ce-desktop-windows), you can run the Linux version by [switching to Linux containers](https://docs.docker.com/docker-for-windows/#switch-between-windows-and-linux-containers), or run the Windows containers version.
817
918
Run in this directory:
1019
```
@@ -21,6 +30,27 @@ Once you have your swarm, in this directory run:
2130
docker stack deploy --compose-file docker-stack.yml vote
2231
```
2332

33+
## Windows Containers
34+
35+
An alternative version of the app uses Windows containers based on Nano Server. This stack runs on .NET Core, using [NATS](https://nats.io) for messaging and [TiDB](https://github.com/pingcap/tidb) for storage.
36+
37+
You can build from source using:
38+
39+
```
40+
docker-compose -f docker-compose-windows.yml build
41+
```
42+
43+
Then run the app using:
44+
45+
```
46+
docker-compose -f docker-compose-windows.yml up -d
47+
```
48+
49+
> Or in a Windows swarm, run `docker stack deploy -c docker-stack-windows.yml vote`
50+
51+
The app will be running at [http://localhost:5000](http://localhost:5000), and the results will be at [http://localhost:5001](http://localhost:5001).
52+
53+
2454
Run the app in Kubernetes
2555
-------------------------
2656

@@ -47,11 +77,11 @@ Architecture
4777

4878
![Architecture diagram](architecture.png)
4979

50-
* A Python webapp which lets you vote between two options
51-
* A Redis queue which collects new votes
52-
* A .NET worker which consumes votes and stores them in…
53-
* A Postgres database backed by a Docker volume
54-
* A Node.js webapp which shows the results of the voting in real time
80+
* A front-end web app in [Python](/vote) or [ASP.NET Core](/vote/dotnet) which lets you vote between two options
81+
* A [Redis](https://hub.docker.com/_/redis/) or [NATS](https://hub.docker.com/_/nats/) queue which collects new votes
82+
* A [.NET Core](/worker/src/Worker), [Java](/worker/src/main) or [.NET Core 2.1](/worker/dotnet) worker which consumes votes and stores them in…
83+
* A [Postgres](https://hub.docker.com/_/postgres/) or [TiDB](https://hub.docker.com/r/dockersamples/tidb/tags/) database backed by a Docker volume
84+
* A [Node.js](/result) or [ASP.NET Core SignalR](/result/dotnet) webapp which shows the results of the voting in real time
5585

5686

5787
Note

0 commit comments

Comments
 (0)