Cette page explique comment configurer et utiliser la fonctionnalité de saisie semi-automatique de la gdcloud CLI, qui vous permet d'utiliser la touche Tabulation pour compléter une commande partiellement saisie. Cette fonctionnalité est disponible pour les shells 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é d'autocomplétion, 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 shells Bash, Zsh et Fish. Utilisez la commande suivante pour déterminer le shell 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 la commande suivante :
gdcloud completion bash > /etc/bash_completion.d/gdcloud
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 du shell 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 du shell 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 du shell avec une commande. Si vous essayez d'utiliser la saisie semi-automatique dans le shell avec une commande et que cela ne fonctionne pas, cela signifie que la saisie semi-automatique dans le shell n'est pas activée. Par exemple, saisissez la commande suivante, puis appuyez sur la touche Tabulation. Si la saisie semi-automatique du shell est activée, vous devriez 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, cela signifie que la saisie semi-automatique dans le shell 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 du shell est activée, le résultat de la commande doit inclure une liste des commandes qui disposent de 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 shell. 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 session d'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 pour chaque session, exécutez la commande suivante :
gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish
Vous devez démarrer une nouvelle session d'interface système pour que cette configuration prenne effet.
Utiliser la saisie semi-automatique
Pour utiliser l'autocomplétion gdcloud CLI, saisissez les premiers caractères de la commande que vous souhaitez utiliser, puis appuyez sur la touche Tabulation. S'il n'y a qu'une seule saisie semi-automatique possible, elle est automatiquement insérée dans la ligne de commande. Si la commande ne se complète pas automatiquement, cela signifie qu'il existe plusieurs options de saisie. Vous devez appuyer à nouveau sur la touche Tabulation pour afficher toutes les commandes possibles.
Exemples de saisie semi-automatique
Saisissez partiellement une commande, puis appuyez sur Tabulation 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 la touche Tabulation pour afficher la liste de toutes les commandes possibles :
gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters