CLI 完成

目录

您可以使用 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 完成系统 会负责，只要完成可以使用 FPATH 加载。

如果您使用的是 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=(~/.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