完成

您可以使用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