https://github.com/mickaelbaron/vuejs-polldle-tutorial-src
Voting done simply in real-time with PollDLE. PollDLE ~= Poll + the last part of Doo DLE (an Internet calendar tool for time management, famous for its simplification)
https://github.com/mickaelbaron/vuejs-polldle-tutorial-src
docker docker-compose java kumuluzee microprofile multistage-build vuejs
Last synced: 4 months ago
JSON representation
Voting done simply in real-time with PollDLE. PollDLE ~= Poll + the last part of Doo DLE (an Internet calendar tool for time management, famous for its simplification)
- Host: GitHub
- URL: https://github.com/mickaelbaron/vuejs-polldle-tutorial-src
- Owner: mickaelbaron
- Created: 2019-06-17T13:57:21.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T09:02:00.000Z (about 1 year ago)
- Last Synced: 2024-12-26T17:17:08.220Z (5 months ago)
- Topics: docker, docker-compose, java, kumuluzee, microprofile, multistage-build, vuejs
- Language: Vue
- Homepage:
- Size: 220 KB
- Stars: 1
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PollDLE (PollDLE ~= Poll + the last part of DooDLE)
Voting done simply in real-time with Polldle. PollDLE ~= Poll + the last part of Doo DLE (an Internet calendar tool for time management, famous for its simplification)
Some technicals concepts in this application:
* front-end in Vue.js 3 and Vite,
* back-end in Java with MicroProfile and KumuluzEE implementation (JAX-RS and CDI),
* using the given/when/then style for Java unit test,
* full build with Docker with multi-stage build feature,
* deployement with Docker.
> All instructions to understand how to develop a front part with [Vue.js](https://vuejs.org/) can be found here (in french): https://mickael-baron.fr/web/vuejs-miseenoeuvre-part2 and https://mickael-baron.fr/web/vuejs-deploiement-part3
## Software requirements
* Docker (that's all)
## Platform
Polldle building and deployement have been tested on:
* macOS Monterey (with Docker for Mac),
* Linux Ubuntu.
In fact, all operating systems that support Docker can build and test PollDLE.
## Download
Clone the latest development source:
```console
$ git clone https://github.com/mickaelbaron/vuejs-polldle-tutorial-src
```
## Configure
In the case you do not need a subpath, go to the next section.
If you want to use a subpath to deploy PollDLE (i.e. ), edit the *subpath.conf* and replace all `YOUR_SUBPATH` string by your preferred value (i.e. `polldle`).
```yaml
server {
listen 80;
location /YOUR_SUBPATH/server/ {
proxy_pass http://backend:9991/;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
location /YOUR_SUBPATH/ {
rewrite ^/YOUR_SUBPATH(/.*)$ $1 break;
proxy_pass http://frontend;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}
```
## Build
To build without subpath: , execute this command line:
```console
$ docker compose build --build-arg script_name=build
```
To build with subpath: , execute this command line:
```console
$ docker compose build --build-arg script_name=subpath
```
To check if the images are been built, execute this command line:
```console
$ docker compose ps
NAME COMMAND SERVICE STATUS PORTS
vuejs3-polldle-tutorial-src-backend-1 "java -cp /polldle/c…" backend running 0.0.0.0:9991->9991/tcp
vuejs3-polldle-tutorial-src-frontend-1 "nginx -g 'daemon of…" frontend running 80/tcp
vuejs3-polldle-tutorial-src-rp-1 "/docker-entrypoint.…" rp running 0.0.0.0:80->80/tcp
```
## Run
From the root of the project, execute this command line:
```console
$ docker compose up -d
```
Open your favorite web browser and go to this url: (without subpath) or (with a subpath).