Gdev is a helper script for all your container related development needs. It's for locally developing containerized applications.
Install gdev dependencies and start the development environment by running:
$ curl -fsSL https://raw.githubusercontent.com/devgeniem/gdev/master/bin/bootstrap | bash
If you're installing on a Ubuntu machine, run:
$ curl -fsSL https://raw.githubusercontent.com/devgeniem/gdev/master/bin/ubuntu | bash
When using linux and MacOS computers on a shared project and you have different docker-compose.yml files for each, linux users need to add an environment variable for gdev to be able to use the correct compose configuration. Add this to your chosen shell configuration (for example .bashrc or .zshrc).
$ # Export compose file for ubuntu
$ export COMPOSE_FILE="docker-compose-ubuntu.yml"
Start a new shell and cd to a project that uses docker-compose.yml
$ gdev up
gdev installer installs docker for mac plus few settings for better development environment. It setups 4 service containers into your docker.
This project uses excellent nginx proxy container from jwilder/nginx-proxy. This proxy reserver ports http/https ports from your localhost and proxies the requests to your project containers. Just provide VIRTUAL_HOST=your-address.test env in your projects docker-compose.yml and nginx proxy will take care of the rest.
We want to use real addresses for all containers. Some applications have strange behaviour if they are just used from localhost:8080. We use andyshinn/dnsmasq for local dnsmasq which always responds 127.0.0.1 to any request. Installation script adds custom resolver file for your machine:
$ cat /etc/resolver/test
domain test
nameserver 127.0.0.1
search_order 1
This means that all *.test addresses are now pointing into your local machine so you don't have to edit /etc/hosts file ever again. We used .test tld because it is reserved by IETF and will never be sold to google like what happened to it's popular cousin .dev.
It's a really good practise to use https in production but only a few people use it in development. This makes it harder for people to notice mixed content error messages in development.
While using gdev you won't see any of these:
and instead more of these:
gdev includes custom certificate generator onnimonni/signaler. gdev installer creates a self-signed unique ca certificate during installation and saves it in your system keychain. If you provide HTTPS_HOST=your-address.test env in your docker-compose.yml you will automatically have self-signed and trusted certificate for your development environment.
We included mailhog/mailhog docker container for easier debugging of emails. Just use 172.17.0.1:25 as smtp server in your application and you are good to go.
Or if your legacy application has hard coded email server you can use this trick in your docker-compose.yml:
extra_hosts:
- "my-mail-server.com:172.17.0.1"
and docker will add it into the /etc/hosts file inside the container automatically during startup.
# This is similiar to vagrant up
# It reads docker-compose.yml from current directory and starts up containers
$ gdev up
# Quickly pause the project and free resources
$ gdev pause
# Wake the project up from pause as quickly as it was paused
$ gdev unpause
# Open shell into web container
$ gdev shell
# Restart all project containers
$ gdev reload
# List all containers from project
$ gdev ps
# List all containers from docker
$ docker ps -a
# Open bash into any container
$ docker exec -it $CONTAINER_ID bash
# Create new project (interactive wizard for setting up project)
$ gdev create
Before creating a new project you should setup a GIT repository for your new project.
It's also advisable to create a config file to your home directory with some default values. File should be named ~/.gdev/gdevconf.yml
Example gdevconf.yml:
create:
defaults:
wordpress:
# Flynn stage cloud address
stage: stage.yourdomain.com
# Flynn production cloud address
production: production.yourdomain.com
smtp_host: "172.17.0.1"
components: "dustpress"
theme: "git@github.com:devgeniem/wp-starter-dustpress-theme.git"
nodejs: TODO
silverbullet: TODO
- The source code running inside a project container is loaded from the directory on your hard drive. You can use text editors and Git clients on the host machines, and shouldn't need to work in the guest machine or the container.
- You should not need to run any application code directly from your host machine. Try to force yourself to find a containerized way of accomplishing things.
- Run
gdevwithout any arguments for lots of help
Docker for Mac has only limited amount of disk space and this means that older images or stopped containers are taking all of the 60gb/120gb share.
To resolve this delete stopped containers, dangling images and dangling volumes. This can be done by running cleanup helper:
$ gdev cleanup
If Docker for Mac still has a bug with freeing up disk space, dump databases you need and reset Docker for Mac settings. This will free all the space Docker is hogging. Then you will need to set up your projects again (import databases).
To update all containers and settings run following global commands:
$ gdev pull
$ gdev update
$ gdev service pull
$ gdev service build
$ gdev service reload
Then restart docker for mac and run these commands:
# Reload project containers
$ cd /to/your/project
$ gdev reload
- Nicholas Silva, creator.
- Onni Hakala, forked the gdev version.
- Ville Pietarinen, initial sync and create commands, fixes and development.
- Otto Rautamaa, ubuntu fixes and development.
- Arttu Mäkipörhölä, ubuntu fixes and development.
- Miika Arponen, docker sync fixes and development.
- Fork it ( https://github.com/devgeniem/gdev/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
gdev is available under the MIT license. See the LICENSE file for more info.
Copyright 2017 Geniem Oy.