|
4 | 4 |
|
5 | 5 | [](https://circleci.com/gh/Cloudstek/zsh-plugin-appup) |
6 | 6 |
|
7 | | -This plugins adds `start`, `restart`, `stop`, `up` and `down` commands when it detects a docker-compose or Vagrant file in the current directory (e.g. your application). Just run `up` and get coding! This saves you typing `docker-compose` or `vagrant` every time or aliasing them. Also gives you one set of commands that work for both environments. |
| 7 | +This plugins adds `start`, `restart`, `stop`, `up` and `down` commands when it detects a docker-compose or Vagrant file |
| 8 | +in the current directory (e.g. your application). Just run `up` and get coding! This saves you typing `docker-compose` |
| 9 | +or `vagrant` every time or aliasing them. Also gives you one set of commands that work for both environments. |
8 | 10 |
|
9 | 11 | ### Docker |
10 | 12 |
|
11 | | -Aside from simply running `up`, you can also extend your configuration by running `up <name>`, which will run `docker-compose` with both `docker-compose.yml` and extend it with `docker-compose.<name>.yml`. For more on extending please see the [official docker documentation](https://docs.docker.com/compose/extends). Additional arguments will be directly supplied to the docker-compose. |
| 13 | +Aside from simply running `up`, you can also extend your configuration by running `up <name>`, which will |
| 14 | +run `docker-compose` with both `docker-compose.yml` and extend it with `docker-compose.<name>.yml`. For more on |
| 15 | +extending please see the [official docker documentation](https://docs.docker.com/compose/extends). Additional arguments |
| 16 | +will be directly supplied to the docker-compose. |
12 | 17 |
|
13 | 18 | ### Vagrant |
14 | 19 |
|
15 | | -Vagrant doesn't have a `down`, `restart`, `start` or `stop` commands natively but don't worry, that's been taken care of and running those commands will actually run vagrant's equivalent commands. Additional arguments will be directly supplied to vagrant. |
| 20 | +Vagrant doesn't have a `down`, `restart`, `start` or `stop` commands natively but don't worry, that's been taken care of |
| 21 | +and running those commands will actually run vagrant's equivalent commands. Additional arguments will be directly |
| 22 | +supplied to vagrant. |
16 | 23 |
|
17 | 24 | ### Command mapping |
18 | 25 |
|
19 | | -| Command | Vagrant command | Docker command | |
20 | | -| ------- | ---------------------------------------------------------- | ------------------------------------------------------------ | |
21 | | -| up | [up](https://www.vagrantup.com/docs/cli/up.html) | [up](https://docs.docker.com/compose/reference/up/) | |
22 | | -| down | [destroy](https://www.vagrantup.com/docs/cli/destroy.html) | [down](https://docs.docker.com/compose/reference/down/) | |
23 | | -| start | [up](https://www.vagrantup.com/docs/cli/up.html) | [start](https://docs.docker.com/compose/reference/start/) | |
| 26 | +| Command | Vagrant command | Docker command | |
| 27 | +|---------|------------------------------------------------------------|---------------------------------------------------------------| |
| 28 | +| up | [up](https://www.vagrantup.com/docs/cli/up.html) | [up](https://docs.docker.com/compose/reference/up/) | |
| 29 | +| down | [destroy](https://www.vagrantup.com/docs/cli/destroy.html) | [down](https://docs.docker.com/compose/reference/down/) | |
| 30 | +| start | [up](https://www.vagrantup.com/docs/cli/up.html) | [start](https://docs.docker.com/compose/reference/start/) | |
24 | 31 | | restart | [reload](https://www.vagrantup.com/docs/cli/reload.html) | [restart](https://docs.docker.com/compose/reference/restart/) | |
25 | | -| stop | [halt](https://www.vagrantup.com/docs/cli/halt.html) | [stop](https://docs.docker.com/compose/reference/stop/) | |
| 32 | +| stop | [halt](https://www.vagrantup.com/docs/cli/halt.html) | [stop](https://docs.docker.com/compose/reference/stop/) | |
| 33 | +| enter | | [exec](https://docs.docker.com/compose/reference/exec/) /bin/bash -l (or custom command/shell, e.g. with `enter /bin/sh`) | |
26 | 34 |
|
27 | 35 | ## Installation |
28 | 36 |
|
@@ -52,11 +60,14 @@ Vagrant doesn't have a `down`, `restart`, `start` or `stop` commands natively bu |
52 | 60 |
|
53 | 61 | ## Configuration options |
54 | 62 |
|
55 | | -AppUp has a few configuration options to customise its behaviour. Please make sure you define these in `~/.zshrc` *before* you load any plugins. |
| 63 | +AppUp has a few configuration options to customise its behaviour. Please make sure you define these in `~/.zshrc` |
| 64 | +*before* you load any plugins. |
56 | 65 |
|
57 | | -| Name | Values | Default | Description | |
58 | | -| -------------------- | ---------- | ------- | ------------------------------------------------------------ | |
59 | | -| APPUP_CHECK_STARTED | true/false | true | Enable/disable checking if docker is running completely. | |
| 66 | +Currently these options only affect docker. |
| 67 | + |
| 68 | +| Name | Values | Default | Description | |
| 69 | +|----------------------|------------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------| |
| 70 | +| APPUP_CHECK_STARTED | true/false | true | Enable/disable checking if docker is running completely. | |
60 | 71 | | APPUP_DOCKER_MACHINE | true/false | true | If both docker (e.g. Docker Desktop) and docker-machine are installed, check if docker-machine (when `true`) or docker (when `false`) is running. | |
61 | | -| | | | | |
| 72 | +| APPUP_LOAD_ENVS | true/false | true | When true, load .env, .env.local, .env.docker and .env.docker.local if they exist with `docker compose --env-file`. | |
62 | 73 |
|
0 commit comments