codeandrew / flask-vue-semantic-docker

Flask+VueJS+SemanticUI+Nginx+Docker boilerplate. Also, see https://pypi.python.org/pypi/fvsd

What is this?

Setting up docker + nginx + flask + vue + semantic is hardly an easy task if you want to setup production and development environments. This is my attempt in the matter. Notice that, some containers are not complete (ux) because, well, vue does not have a non interactive install.

Getting started

# make sure you have fabric3 installed
# make sure to read each folder readme
# make sure you have docker and docker-compose installed

# call setup to install dependencies
fab setup

# now you're ready to go
fab env:dev up  # docker-compose up in development mode
fab env:prd up  # docker-compose up in production mode
fab env:dev build  # docker-compose build in development mode
fab env:prd build  # docker-compose build in production mode
fab env:dev on:<service_name> run:"<command>"  # docker-compose run in development mode
fab env:prd on:<service_name> run:"<command>"  # docker-compose run in production mode
fab env:dev logs:name  # docker logs on container called <name>
fab env:prd logs:name  # docker logs on container called <name>

What is what?

• app -> flask application container
• server -> nginx container
• styles -> semantic-ui container
• ux -> vuejs application container

Trouble?

As webpack is a every-changing beast, leave a issue at https://github.com/italomaia/flask-vue-semantic-docker/issues if something doesn't work. There might have been a change in a dependency at some point.

Changelog

0.3.1

• Added more feedback on dependencies

0.3.0

• Nothing, really

0.2.8

• Fixed semantic files import

0.2.7

• Flask "app" is now built inside $HOME/code to avoid bash session dirt
• Vue.JS "ux" is now built inside $HOME/code to avoid bash session dirt
• Fixed entrypoint.sh permissions for mounted folders
• Added entrypoint.sh to app/

0.2.6

• Fixed source reload on ux code change during dev

0.2.5

• Readme instructions are now configured by default

0.2.4

• webpack dev server endpoints have changed. Updated, so nginx can route to them.
• version bump for docker base images (node's, actually)

0.2.3

• Added on:<service> task; it is used to pick which service your command is run against. Right now, only works with run.

0.2.2

• Added adminer for dev
• Added logs command to fabfile
• Added run command to fabfile (docker-compose run)
• Small fixes

0.2.1

• installed extensions are now properly loaded
• added basic "auth" app implementation (for authentication)
• added some sensitive defaults for sqlalchemy configuration

0.2

• update to flask app dependencies (+flask-jsglue +flask-marshmallow +flask-migrate +flask-security +flask-sqlalchemy)

0.1

• initial version (docker + flask + vuejs + semantic-ui)