|
| 1 | +# FLASK MICROSERVICES |
| 2 | + |
| 3 | +This project is based on [testdriven.io](http://testdriven.io/) Microservices with Docker, Flask and React |
| 4 | + |
| 5 | +### Structure |
| 6 | +1. _[flask-microservices-main](https://github.com/repodevs/flask-microservices-main)_ Docker Compose files, Nginx, admin scripts |
| 7 | +2. _[flask-microservices-users](https://github.com/repodevs/flask-microservices-users)_ Flask App |
| 8 | +3. _[flask-microservices-client](https://github.com/repodevs/flask-microservices-client)_ client-side based on ReactJS |
| 9 | +--- |
| 10 | + |
| 11 | +## How To Run |
| 12 | +---- |
| 13 | +### Build for Local |
| 14 | +1. create docker-machine for local (with virtualbox driver) |
| 15 | +```bash |
| 16 | +$ docker-machine create --driver virtualbox dev |
| 17 | +``` |
| 18 | +2. activate docker-machine |
| 19 | +```bash |
| 20 | +$ eval $(docker-machine env dev) |
| 21 | +``` |
| 22 | +3. Build the images and spin up the containers |
| 23 | +```bash |
| 24 | +$ docker-compose up -d --build |
| 25 | +``` |
| 26 | +4. create and seed the db then run the tests |
| 27 | +```bash |
| 28 | +$ docker-compose run users-service python manage.py recreate_db |
| 29 | +$ docker-compose run users-service python manage.py seed_db |
| 30 | +$ docker-compose run users-service python manage.py test |
| 31 | +``` |
| 32 | + |
| 33 | +Test it by opening your browser [http://0.0.0.0:80](0.0.0.0:80) or [http://0.0.0.0:80/users](0.0.0.0:80/users) |
| 34 | + |
| 35 | +--- |
| 36 | +### Build for Production |
| 37 | + |
| 38 | +1. create docker-machine for production (with driver digitalocean based on ubuntu 14.04) |
| 39 | +```bash |
| 40 | +$ docker-machine create --driver digitalocean --digitalocean-access-token=DO_TOKEN --digitalocean-image ubuntu-14-04-x64 prod |
| 41 | +``` |
| 42 | +2. activate docker-machine |
| 43 | +```bash |
| 44 | +$ eval "$(docker-machine env prod)" |
| 45 | +``` |
| 46 | +3. Build the images and spin up the containers |
| 47 | +```bash |
| 48 | +$ docker-compose -f docker-compose-prod.yml up -d --build |
| 49 | +``` |
| 50 | +4. create and seed the db then run the tests |
| 51 | +```bash |
| 52 | +$ docker-compose -f docker-compose-prod.yml run users-service python manage.py recreate_db |
| 53 | +$ docker-compose -f docker-compose-prod.yml run users-service python manage.py seed_db |
| 54 | +$ docker-compose -f docker-compose-prod.yml run users-service python manage.py test |
| 55 | +``` |
| 56 | +5. watch the logs |
| 57 | +```bash |
| 58 | +$ docker-compose logs -f users-service |
| 59 | +``` |
| 60 | +6. grab ip |
| 61 | +```bash |
| 62 | +$ docker-machine ip prod |
| 63 | +``` |
| 64 | + |
| 65 | +Test it by opening your browser [http://YOUR_PROD_IP:80](YOUR_PROD_IP:80) or [http://YOUR_PROD_IP:80/users](YOUR_PROD_IP:80/users) |
| 66 | + |
| 67 | +---- |
| 68 | +## Other Commands |
| 69 | + |
| 70 | +To stop Docker container: |
| 71 | +```bash |
| 72 | +$ docker-compose stop |
| 73 | +``` |
| 74 | +To bring down the container: |
| 75 | +```bash |
| 76 | +$ docker-compose down |
| 77 | +``` |
| 78 | +Force build: |
| 79 | +```bash |
| 80 | +$ docker-compose build --no-cache |
| 81 | +``` |
| 82 | +Remove image: |
| 83 | +```bash |
| 84 | +$ docker rmi $(docker images -q) |
| 85 | +``` |
| 86 | +--- |
| 87 | +Access database via psql: |
| 88 | +```bash |
| 89 | +$ docker exec -ti users-db psql -U postgres -W |
| 90 | +``` |
| 91 | + |
0 commit comments