https://github.com/2degrees/docker-dev

Development tools for Docker
https://github.com/2degrees/docker-dev

bash docker docker-compose

Last synced: about 1 month ago
JSON representation

Development tools for Docker

• Host: GitHub
• URL: https://github.com/2degrees/docker-dev
• Owner: 2degrees
• License: bsd-3-clause
• Created: 2016-02-17T10:10:29.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2017-08-18T11:36:35.000Z (over 7 years ago)
• Last Synced: 2024-11-15T00:53:58.008Z (about 1 month ago)
• Topics: bash, docker, docker-compose
• Language: Shell
• Homepage:
• Size: 51.8 KB
• Stars: 20
• Watchers: 8
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# docker-dev: Utilities to use Docker in development environments

`docker-dev` optimises Docker and Docker Compose for use on a developer's

computer, making some common tasks easier than they would be otherwise.

Once you've cloned or downloaded this project, you can enable it by adding

the following line to `~/.bashrc`:

```bash

source /path-to-dockerdev/dockerdevrc

```

## Commands

The following Bash scripts are included:

### docker-dev

`docker-dev` wraps some Docker Compose subcommands in order to pass extra

arguments. It's not opinionated about the structure of your Docker Compose

file, and you can switch between `docker-dev` and `docker-compose`.

`docker-dev` supports autocompletion in a Bash session.

#### `docker-dev build [EXTRA_ARGS...]`

Wraps `docker-compose build`, and also:

- Avoids leaving intermediate containers behind.

- Pulls the latest version of any parent Docker images.

- If an executable file called `.dockerdev-prebuild` exists in the current

  working directory, it'll be run before running `docker-compose build` (unless

  the executable fails).

#### `docker-dev run [EXTRA_ARGS...]`

Wraps `docker-compose run` to prevent leaving containers behind once the

command ends.

#### `docker-dev up [EXTRA_ARGS...]`

Wraps `docker-compose up` and prevents leaving containers behind once the

command ends and to exit once any of the services explicitly called exits.

#### `docker-dev up2 [SERVICES...]`

**Experimental:** This subcommand is expected to replace `docker-dev up`

eventually, and it will be changed or simply removed in future releases.

This subcommand wraps `docker-dev up` and works around limitations in Docker

Compose when the services you want to run depend on other services -- namely:

- Logs from dependent services are output in the foreground.

- Terminating the `docker-dev` process also terminates dependent services.

- Likewise, when a dependent service terminates, all the other services and

  the parent process are terminated.

#### `docker-dev down`

Runs `docker-compose down` so that all the resources in the project are removed.

## docker-clean

This command will remove **all** your Docker resources (e.g., containers,

volumes), except for images created in the past week.