2019-10-19 15:28:43 +00:00
|
|
|
# Docker plugin
|
2013-08-07 15:59:53 +00:00
|
|
|
|
2022-04-12 19:52:41 +00:00
|
|
|
This plugin adds auto-completion and aliases for [docker](https://www.docker.com/).
|
2019-10-18 21:52:26 +00:00
|
|
|
|
|
|
|
|
To use it add `docker` to the plugins array in your zshrc file.
|
2020-03-11 18:57:46 +00:00
|
|
|
|
2019-10-18 21:52:26 +00:00
|
|
|
```zsh
|
|
|
|
|
plugins=(... docker)
|
|
|
|
|
```
|
|
|
|
|
|
2019-10-19 15:28:43 +00:00
|
|
|
A copy of the completion script from the docker/cli git repo:
|
|
|
|
|
https://github.com/docker/cli/blob/master/contrib/completion/zsh/_docker
|
2020-09-18 20:02:10 +00:00
|
|
|
|
|
|
|
|
## Settings
|
|
|
|
|
|
2022-11-15 19:05:13 +00:00
|
|
|
By default, the completion doesn't allow option-stacking, meaning if you try to complete
|
|
|
|
|
`docker run -it <TAB>` it won't work, because you're _stacking_ the `-i` and `-t` options.
|
2020-09-18 20:02:10 +00:00
|
|
|
|
2022-11-15 19:05:13 +00:00
|
|
|
[You can enable it](https://github.com/docker/cli/commit/b10fb43048) by **adding the lines below to your zshrc
|
|
|
|
|
file**, but be aware of the side effects:
|
2020-09-18 20:02:10 +00:00
|
|
|
|
2022-11-15 19:05:13 +00:00
|
|
|
> This enables Zsh to understand commands like `docker run -it ubuntu`. However, by enabling this, this also
|
|
|
|
|
> makes Zsh complete `docker run -u<tab>` with `docker run -uapprox` which is not valid. The users have to put
|
|
|
|
|
> the space or the equal sign themselves before trying to complete.
|
2020-09-18 20:02:10 +00:00
|
|
|
>
|
|
|
|
|
> Therefore, this behavior is disabled by default. To enable it:
|
|
|
|
|
>
|
2022-04-12 19:52:41 +00:00
|
|
|
> ```sh
|
2020-09-18 20:02:10 +00:00
|
|
|
> zstyle ':completion:*:*:docker:*' option-stacking yes
|
|
|
|
|
> zstyle ':completion:*:*:docker-*:*' option-stacking yes
|
|
|
|
|
> ```
|
2022-04-12 19:52:41 +00:00
|
|
|
|
2023-07-20 08:43:56 +00:00
|
|
|
### Use old-style completion
|
|
|
|
|
|
|
|
|
|
If the current completion does not work well for you, you can enable legacy completion instead with the
|
|
|
|
|
following setting. See https://github.com/ohmyzsh/ohmyzsh/issues/11789 for more information.
|
|
|
|
|
|
|
|
|
|
```zsh
|
|
|
|
|
zstyle ':omz:plugins:docker' legacy-completion yes
|
|
|
|
|
```
|
|
|
|
|
|
2022-04-12 19:52:41 +00:00
|
|
|
## Aliases
|
|
|
|
|
|
2022-11-15 19:05:13 +00:00
|
|
|
| Alias | Command | Description |
|
|
|
|
|
| :------ | :---------------------------- | :--------------------------------------------------------------------------------------- |
|
|
|
|
|
| dbl | `docker build` | Build an image from a Dockerfile |
|
|
|
|
|
| dcin | `docker container inspect` | Display detailed information on one or more containers |
|
|
|
|
|
| dcls | `docker container ls` | List all the running docker containers |
|
|
|
|
|
| dclsa | `docker container ls -a` | List all running and stopped containers |
|
|
|
|
|
| dib | `docker image build` | Build an image from a Dockerfile (same as docker build) |
|
|
|
|
|
| dii | `docker image inspect` | Display detailed information on one or more images |
|
|
|
|
|
| dils | `docker image ls` | List docker images |
|
|
|
|
|
| dipu | `docker image push` | Push an image or repository to a remote registry |
|
|
|
|
|
| dirm | `docker image rm` | Remove one or more images |
|
|
|
|
|
| dit | `docker image tag` | Add a name and tag to a particular image |
|
|
|
|
|
| dlo | `docker container logs` | Fetch the logs of a docker container |
|
|
|
|
|
| dnc | `docker network create` | Create a new network |
|
|
|
|
|
| dncn | `docker network connect` | Connect a container to a network |
|
|
|
|
|
| dndcn | `docker network disconnect` | Disconnect a container from a network |
|
|
|
|
|
| dni | `docker network inspect` | Return information about one or more networks |
|
|
|
|
|
| dnls | `docker network ls` | List all networks the engine daemon knows about, including those spanning multiple hosts |
|
|
|
|
|
| dnrm | `docker network rm` | Remove one or more networks |
|
|
|
|
|
| dpo | `docker container port` | List port mappings or a specific mapping for the container |
|
|
|
|
|
| dpu | `docker pull` | Pull an image or a repository from a registry |
|
|
|
|
|
| dr | `docker container run` | Create a new container and start it using the specified command |
|
|
|
|
|
| drit | `docker container run -it` | Create a new container and start it in an interactive shell |
|
|
|
|
|
| drm | `docker container rm` | Remove the specified container(s) |
|
|
|
|
|
| drm! | `docker container rm -f` | Force the removal of a running container (uses SIGKILL) |
|
|
|
|
|
| dst | `docker container start` | Start one or more stopped containers |
|
2023-07-20 08:43:56 +00:00
|
|
|
| drs | `docker container restart` | Restart one or more containers |
|
2022-11-15 19:05:33 +00:00
|
|
|
| dsta | `docker stop $(docker ps -q)` | Stop all running containers |
|
2022-11-15 19:05:13 +00:00
|
|
|
| dstp | `docker container stop` | Stop one or more running containers |
|
|
|
|
|
| dtop | `docker top` | Display the running processes of a container |
|
|
|
|
|
| dvi | `docker volume inspect` | Display detailed information about one or more volumes |
|
|
|
|
|
| dvls | `docker volume ls` | List all the volumes known to docker |
|
|
|
|
|
| dvprune | `docker volume prune` | Cleanup dangling volumes |
|
|
|
|
|
| dxc | `docker container exec` | Run a new command in a running container |
|
|
|
|
|
| dxcit | `docker container exec -it` | Run a new command in a running container in an interactive shell |
|
