Cette page explique comment configurer et utiliser la fonctionnalité de saisie semi-automatique de la CLI gdcloud, qui vous permet d'utiliser la touche Tab pour compléter une commande partiellement saisie. Cette fonctionnalité est disponible pour les interfaces système Bash, Zsh et Fish. La saisie semi-automatique de la CLI gdcloud est une fonctionnalité qui fournit des suggestions de commandes et d'options à mesure que vous saisissez du texte. Cela peut être utile lorsque vous ne savez pas quelle commande utiliser ou lorsque vous souhaitez utiliser une commande que vous n'avez jamais utilisée auparavant.
Activer la saisie semi-automatique
Pour activer la fonctionnalité de saisie semi-automatique, vous devez exécuter une commande pour votre terminal. La fonctionnalité de saisie semi-automatique de la CLI gdcloud est disponible pour le système d'exploitation Linux dans les interfaces système Bash, Zsh et Fish. Utilisez la commande suivante pour déterminer l'interface système que vous utilisez.
echo $SHELL
Le résultat ressemble à bin/$SHELL, où $SHELL est bash, zsh ou fish.
Bash
Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :
source <(gdcloud completion bash)
Pour charger les saisies semi-automatiques à chaque nouvelle session, exécutez une fois les commandes suivantes :
gdcloud completion bash > gdcloud-completion.bash
sudo cp gdcloud-completion.bash /etc/bash_completion.d/
Zsh
Si la saisie semi-automatique n'est pas déjà activée pour l'interface système dans votre environnement, vous devez l'activer. Vérifiez si la saisie semi-automatique est activée.
Vérifiez la valeur de la variable COMP_LINE. Si la valeur de la variable COMP_LINE est vide, la saisie semi-automatique n'est pas activée. Vous pouvez vérifier cette valeur en exécutant la commande suivante :
echo $COMP_LINE
Essayez d'utiliser la saisie semi-automatique avec une commande. Si vous essayez d'utiliser la saisie semi-automatique avec une commande et que cela ne fonctionne pas, la saisie semi-automatique n'est pas activée. Par exemple, essayez de saisir la commande suivante, puis appuyez sur Tab. Si la saisie semi-automatique est activée, vous devez voir une liste des saisies semi-automatiques possibles pour la commande ls.
ls
Vérifiez le résultat de la commande compgen -c. Si le résultat de la commande compgen -c ne contient aucune commande, la saisie semi-automatique n'est pas activée. Vous pouvez exécuter la commande suivante pour afficher le résultat de la commande compgen -c. Si la saisie semi-automatique est activée, le résultat de la commande doit inclure une liste des commandes qui comportent des fonctions de saisie semi-automatique.
compgen -c
Si vous ne savez pas si la saisie semi-automatique est activée dans votre environnement, consultez la documentation de votre interface système. Si la saisie semi-automatique n'est pas activée dans votre environnement, exécutez la commande suivante pour l'activer :
echo "autoload -U compinit; compinit" >> ~/.zshrc
Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
Pour charger les saisies semi-automatiques à chaque session, exécutez une fois la commande suivante :
gdcloud completion zsh > "${fpath[1]}/_gdcloud"
Vous devez démarrer une nouvelle interface système pour que cette configuration prenne effet.
Poisson
Pour charger les saisies semi-automatiques dans votre session d'interface système actuelle, procédez comme suit :
gdcloud completion fish | source
Pour charger les saisies semi-automatiques à chaque session, exécutez la commande suivante :
gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish
Vous devez démarrer une nouvelle interface système pour que cette configuration prenne effet.
Utiliser la saisie semi-automatique
Pour utiliser la saisie semi-automatique de la CLI gdcloud, saisissez les premiers caractères de la commande que vous souhaitez utiliser, puis appuyez sur la touche Tab. S'il n'existe qu'une seule saisie semi-automatique possible, elle est automatiquement insérée dans la ligne de commande. Si la commande ne se remplit pas automatiquement, cela signifie qu'il existe plusieurs saisies semi-automatiques possibles. Vous devez appuyer à nouveau sur la touche Tab pour afficher toutes les commandes possibles.
Exemples de saisie semi-automatique
Saisissez une commande partiellement, puis appuyez sur Tab pour la compléter automatiquement :
gdcloud con <TAB>
Commande complète après avoir appuyé une fois sur Tab :
gdcloud config
Saisissez une commande partiellement, puis appuyez deux fois sur Tab pour afficher la liste de toutes les commandes possibles :
gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters