完成
目录
您可以使用docker completion
命令为 Docker CLI 生成 shell 代码补全脚本。当您在终端输入时按下<Tab>
键,代码补全脚本将为您提供命令、标志和 Docker 对象(例如容器和卷名称)的单词补全。
您可以为以下 shell 生成补全脚本:
Bash
要使用 Bash 获取 Docker CLI 代码补全,您首先需要安装包含许多用于 shell 代码补全的 Bash 函数的bash-completion
包。
# Install using APT:
sudo apt install bash-completion
# Install using Homebrew (Bash version 4 or later):
brew install bash-completion@2
# Homebrew install for older versions of Bash:
brew install bash-completion
# With pacman:
sudo pacman -S bash-completion
安装bash-completion
后,在您的 shell 配置文件(在此示例中为.bashrc
)中加载该脚本。
# On Linux:
cat <<EOT >> ~/.bashrc
if [ -f /etc/bash_completion ]; then
. /etc/bash_completion
fi
EOT
# On macOS / with Homebrew:
cat <<EOT >> ~/.bash_profile
[[ -r "$(brew --prefix)/etc/profile.d/bash_completion.sh" ]] && . "$(brew --prefix)/etc/profile.d/bash_completion.sh"
EOT
并重新加载您的 shell 配置。
$ source ~/.bashrc
现在,您可以使用docker completion
命令生成 Bash 代码补全脚本。
$ mkdir -p ~/.local/share/bash-completion/completions
$ docker completion bash > ~/.local/share/bash-completion/completions/docker
Zsh
只要可以使用FPATH
加载补全,Zsh 补全系统 会处理这些问题。
如果您使用 Oh My Zsh,您可以通过将补全脚本存储在~/.oh-my-zsh/completions
目录中来安装补全,而无需修改~/.zshrc
。
$ mkdir -p ~/.oh-my-zsh/completions
$ docker completion zsh > ~/.oh-my-zsh/completions/_docker
如果您不使用 Oh My Zsh,请将补全脚本存储在您选择的目录中,并将该目录添加到.zshrc
中的FPATH
。
$ mkdir -p ~/.docker/completions
$ docker completion zsh > ~/.docker/completions/_docker
$ cat <<"EOT" >> ~/.zshrc
FPATH="$HOME/.docker/completions:$FPATH"
autoload -Uz compinit
compinit
EOT
Fish
fish shell 原生支持补全系统。要激活 Docker 命令的代码补全,请将补全脚本复制或符号链接到您的 fish shell 的completions/
目录。
$ mkdir -p ~/.config/fish/completions
$ docker completion fish > ~/.config/fish/completions/docker.fish