命令行完成 | Command-line completion (Compose)

Compose 附带了 bash 和 zsh shell 的命令补全。

安装命令完成

Bash

确保安装完毕。

• 在当前的 Linux 操作系统上（非最小安装），bash 完成应该可用。

• 在 mac 上安装brew install bash-completion。

将完成脚本放入/etc/bash_completion.d/（或/usr/local/etc/bash_completion.d/在 Mac 上）：

sudo curl -L https://raw.githubusercontent.com/docker/compose/1.15.0/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose

在 Mac 上，将以下内容添加到您的~/.bash_profile：

if [ -f $(brew --prefix)/etc/bash_completion ]; then
. $(brew --prefix)/etc/bash_completion
fi

你可以从你的~/.bash_profile或者启动一个新的终端来利用完工。

如果您使用的是 MacPorts 而不是 BREW ，则需要将您的步骤稍微修改如下：

运行sudo port install bash-completion来安装 bash 完成。将以下行添加到~/.bash_profile：

if [ -f /opt/local/etc/profile.d/bash_completion.sh ]; then
    . /opt/local/etc/profile.d/bash_completion.sh
fi

您可以获取~/.bash_profile或启动新终端以利用完成。

Zsh

将完成脚本放在你的/path/to/zsh/completion，使用例如~/.zsh/completion/：

$ mkdir -p ~/.zsh/completion
$ curl -L https://raw.githubusercontent.com/docker/compose/1.15.0/contrib/completion/zsh/_docker-compose > ~/.zsh/completion/_docker-compose

在你的$fpath中添加目录，例如添加~/.zshrc：

fpath=(~/.zsh/completion $fpath)

确保compinit已加载或通过添加~/.zshrc：

autoload -Uz compinit && compinit -i

然后重新加载 shell ：

exec $SHELL -l

可用完成

根据到目前为止在命令行上键入的内容，它将完成：

• 可用的 docker-compose 命令

• 可用于特定命令的选项

• 服务名称在给定的上下文中有意义（例如，服务运行或停止的实例或基于图像的服务与基于 Dockerfiles 的服务）。因为docker-compose scale，完成的服务名称将自动附加“=”。

• 选定选项的参数，例如docker-compose kill -s将完成一些信号，如 SIGHUP 和 SIGUSR 1。

享受快速写作和少排字的工作

撰写文件

• 用户指南

• 安装组合

• 从 Django 开始

• 从 Rails 开始

• 从 WordPress 开始

• 命令行引用

• 合成文件引用

fig, composition, compose, docker, orchestration, cli, reference