https://github.com/drunomics/lupus-localdev

Additions for making local development with docker-compose nicer.
https://github.com/drunomics/lupus-localdev

Last synced: about 2 months ago
JSON representation

Additions for making local development with docker-compose nicer.

• Host: GitHub
• URL: https://github.com/drunomics/lupus-localdev
• Owner: drunomics
• Created: 2019-05-15T15:51:15.000Z (about 7 years ago)
• Default Branch: 2.x
• Last Pushed: 2025-03-14T13:06:00.000Z (about 1 year ago)
• Last Synced: 2025-03-14T14:23:20.214Z (about 1 year ago)
• Language: Shell
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 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](https://github.com/drunomics/devsetup-docker/tree/2.x).

## Features

 * Runs a central [traefik](https://traefik.io/) 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](https://www.portainer.io/) 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:

```yaml

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 for `docker-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.