eost_gissmo_tools/README.md
2016-04-07 11:18:17 +02:00

56 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Gissmo Launch Script
This script, called **Gissmo Launcher**, aims to manage Docker containers while working on Gissmo project (Cf. https://github.com/eost/gissmo/).
It's not a part of previous Github's branch because it's only for Docker use.
## Requirements
I suggest you to check these points befaure using Gissmo Launcher:
* docker
* bash (Bourne Again Shell)
* tput command (try ```which tput``` to know if you have it)
* a default configuration file to give Gissmo Launcher some data
## Configuration file
A configuration example is available here: [config.example](./config.example).
Gissmo Launch Script search a file called **config** located in XDG_CONFIG_HOME.
If not, it searches this file: **.config/gissmo** located in your home directory.
## Usage
Just do:
./launch.sh
It will display you a list of available commands.
## Examples
Here is an example on how I frequently use Gissmo Launcher:
launch.sh init
launch.sh create
launch.sh restore ~/2015.05.06.dump
launch.sh migrate
launch.sh dev
launch.sh stop
launch.sh start python manage.py shell
launch.sh stop
## A different configuration file
If you want to use another configuration file than current, use the **GISSMO_CFG** variable as:
GISSMO_CFG=~/new_config launch.sh
It will use *new_config* file instead.
## License
This tool is under [WTFPL Do What the Fuck You Want to Public License](http://www.wtfpl.net/).