Esta página fornece instruções para configurar e usar a funcionalidade de preenchimento automático da CLI gcloud, que lhe permite usar a tecla Tab para concluir um comando introduzido parcialmente. Esta funcionalidade está disponível para shells Bash, Zsh e Fish. O preenchimento automático da CLI gcloud é uma funcionalidade que fornece sugestões de comandos e opções à medida que escreve. Isto pode ser útil quando não tem a certeza do comando a usar ou quando quer usar um comando que nunca usou antes.
Ative o preenchimento automático
Para ativar a funcionalidade de preenchimento automático, tem de executar um comando para o seu terminal. A funcionalidade de preenchimento automático da CLI gcloud está disponível para o sistema operativo Linux nas shells Bash, Zsh e Fish. Use o seguinte comando para saber que shell usa.
echo $SHELL
O resultado tem o seguinte aspeto: bin/$SHELL, em que $SHELL é bash, zsh ou fish.
Bash
Para carregar conclusões na sessão de shell atual:
source <(gdcloud completion bash)
Para carregar conclusões para cada nova sessão, execute os seguintes comandos uma vez:
gdcloud completion bash > gdcloud-completion.bash
sudo cp gdcloud-completion.bash /etc/bash_completion.d/
Zsh
Se a conclusão automática de comandos ainda não estiver ativada no seu ambiente, tem de a ativar. Verifique se a conclusão de comandos da shell está ativada.
Verifique o valor da variável COMP_LINE. Se o valor da variável COMP_LINE estiver vazio, a conclusão do shell não é ativada. Pode verificar este valor executando o seguinte comando:
echo $COMP_LINE
Experimente usar a conclusão de comandos com um comando. Se tentar usar a conclusão de comandos com um comando e não funcionar, a conclusão de comandos não está ativada. Por exemplo, experimente escrever o seguinte comando e premir Tab. Se o preenchimento automático da shell estiver ativado, tem de ver uma lista de possíveis preenchimentos automáticos para o comando ls.
ls
Verifique a saída do comando compgen -c. Se o resultado do comando compgen -c não contiver comandos, o preenchimento automático da shell não está ativado. Pode executar o seguinte comando para ver o resultado do comando compgen -c. Se a conclusão de comandos estiver ativada, o resultado do comando deve incluir uma lista de comandos que têm funções de conclusão.
compgen -c
Se não tiver a certeza de que a conclusão automática de comandos está ativada no seu ambiente, consulte a documentação da sua shell. Se a conclusão automática de comandos não estiver ativada no seu ambiente, execute o seguinte comando para a ativar:
echo "autoload -U compinit; compinit" >> ~/.zshrc
Para carregar conclusões na sessão de shell atual:
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
Para carregar conclusões para cada sessão, execute uma vez:
gdcloud completion zsh > "${fpath[1]}/_gdcloud"
Tem de iniciar uma nova shell para que esta configuração entre em vigor.
Peixes
Para carregar conclusões na sessão de shell atual:
gdcloud completion fish | source
Para carregar conclusões para cada sessão, execute o seguinte comando:
gdcloud completion fish > ~/.config/fish/completions/gdcloud.fish
Tem de iniciar uma nova shell para que esta configuração entre em vigor.
Use o preenchimento automático
Para usar a conclusão automática da CLI gdcloud, escreva os primeiros carateres do comando que quer usar e, de seguida, prima a tecla Tab. Se existir apenas uma conclusão possível, esta é inserida automaticamente na linha de comandos. Se o comando não for preenchido automaticamente, significa que existem várias conclusões possíveis e tem de premir novamente a tecla Tab para ver todos os comandos possíveis.
Exemplos de preenchimento automático
Escreva um comando parcialmente e, em seguida, prima Tab para preencher automaticamente o comando:
gdcloud con <TAB>
Concluir comando depois de premir Tab uma vez:
gdcloud config
Escreva um comando parcialmente e, de seguida, prima Tab duas vezes para ver uma lista de todos os comandos possíveis:
gdcloud clusters <TAB> <TAB>
describe get-credentials list
gdcloud clusters