⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Autocomplétion

Table des matières

Vous pouvez générer un script d'autocomplétion shell pour la CLI Docker en utilisant la commande docker completion. Le script d'autocomplétion vous donne la complétion automatique des mots pour les commandes, drapeaux, et objets Docker (comme les noms de conteneurs et volumes) lorsque vous appuyez sur <Tab> en tapant dans votre terminal.

Vous pouvez générer des scripts d'autocomplétion pour les shells suivants :

Bash

Pour obtenir l'autocomplétion de la CLI Docker avec Bash, vous devez d'abord installer le paquet bash-completion qui contient un certain nombre de fonctions Bash pour l'autocomplétion shell.

# Installation avec APT :
sudo apt install bash-completion

# Installation avec Homebrew (Bash version 4 ou ultérieure) :
brew install bash-completion@2
# Installation Homebrew pour les versions plus anciennes de Bash :
brew install bash-completion

# Avec pacman :
sudo pacman -S bash-completion

Après avoir installé bash-completion, sourcez le script dans votre fichier de configuration shell (dans cet exemple, .bashrc) :

# Sur Linux :
cat <<EOT >> ~/.bashrc
if [ -f /etc/bash_completion ]; then
    . /etc/bash_completion
fi
EOT

# Sur macOS / avec Homebrew :
cat <<EOT >> ~/.bash_profile
[[ -r "$(brew --prefix)/etc/profile.d/bash_completion.sh" ]] && . "$(brew --prefix)/etc/profile.d/bash_completion.sh"
EOT

Et rechargez votre configuration shell :

$ source ~/.bashrc

Maintenant vous pouvez générer le script d'autocomplétion Bash en utilisant la commande docker completion :

$ mkdir -p ~/.local/share/bash-completion/completions
$ docker completion bash > ~/.local/share/bash-completion/completions/docker

Zsh

Le système d'autocomplétion Zsh s'occupe des choses tant que l'autocomplétion peut être sourcée en utilisant FPATH.

Si vous utilisez Oh My Zsh, vous pouvez installer les autocompléments sans modifier ~/.zshrc en stockant le script d'autocomplétion dans le répertoire ~/.oh-my-zsh/completions.

$ mkdir -p ~/.oh-my-zsh/completions
$ docker completion zsh > ~/.oh-my-zsh/completions/_docker

Si vous n'utilisez pas Oh My Zsh, stockez le script d'autocomplétion dans un répertoire de votre choix et ajoutez le répertoire à FPATH dans votre .zshrc.

$ mkdir -p ~/.docker/completions
$ docker completion zsh > ~/.docker/completions/_docker

$ cat <<"EOT" >> ~/.zshrc
FPATH="$HOME/.docker/completions:$FPATH"
autoload -Uz compinit
compinit
EOT

Fish

Le shell fish prend en charge nativement un système d'autocomplétion. Pour activer l'autocomplétion pour les commandes Docker, copiez ou créez un lien symbolique du script d'autocomplétion vers le répertoire completions/ de votre shell fish :

$ mkdir -p ~/.config/fish/completions
$ docker completion fish > ~/.config/fish/completions/docker.fish