Lupus localdev Setup
Provides a central docker-compose configuration for making local development with docker-compose based projects nicer. The setup plays nice together with projects using drunomics/devsetup-docker.
Features
-
Runs a central traefik reverse proxy and binds it to localhost, such that multiple projects can be run at the same time. It's dashboard is available at http://traefik.localdev.space
-
Provides portainer as docker UI at http://portainer.localdev.space/
-
Provides some useful bash aliases and short-cuts, see "Provided commands" below.
Installation
git clone git@github.com:drunomics/lupus-localdev.git --branch=2.x ~/.lupus-localdev
echo "# Add lupus-localdev setup and aliases." >> ~/.bashrc
echo 'source ~/.lupus-localdev/bashrc' >> ~/.bashrc
bash
# Register and launch docker containers.
localdev-dcp up -d
Usage
By default, traefik is started on boot automatically. So it's automatically avaiable
all the time. However one can manually restart / stop / start it with the provided
localdev-dcp
command:
# Stop
localdev-dcp stop
# Start
localdev-dcp start
# Restart
localdev-dcp restart
Per-project setup changes
Using this centralized traefik network means it is an external network in respect to projects' own ecosystem and it should be declared as such:
networks:
traefik:
name: traefik
external: true
Uninstall
localdev-dcp down -v
sed -i '/lupus-localdev/d' ~/.bashrc
rm -rf ~/.lupus-localdev
Provided commands
-
dcp
A simple short-hand fordocker-compose
. -
localdev-dcp
Runs docker-compose for the lupus-localdev services, like traefik. -
localdev-update
Updates the localdev setup with latest upstream changes. Updates just pull in changes in the current branch, what will never including breaking changes.