Esta página fornece instruções para configurar e usar a funcionalidade de preenchimento automático da CLI gdcloud, 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 de que comando 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 as 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 sua sessão de shell atual:
source <(gdcloud completion bash)
Para carregar conclusões para cada nova sessão, execute uma vez:
gdcloud completion bash > /etc/bash_completion.d/gdcloud
Zsh
Se a conclusão de comandos não estiver ativada no seu ambiente, tem de a ativar. Verifique se a conclusão do 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 automática de comandos com um comando e não funcionar, significa que a conclusão automática de comandos não está ativada. Por exemplo, experimente escrever o seguinte comando e premir Tab. Se a conclusão do shell estiver ativada, tem de ver uma lista de conclusões possíveis para o comando ls
.
ls
Verifique o resultado 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 tenham funções de conclusão.
compgen -c
Se não tiver a certeza de que a conclusão de comandos está ativada no seu ambiente, consulte a documentação da sua shell. Se a conclusão 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 sua sessão de shell atual:
source <(gdcloud completion zsh); compdef _gdcloud gdcloud
Para carregar conclusões para cada sessão, execute uma vez:
Linux
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 sua sessão de shell atual:
gdcloud completion fish | source
Para carregar conclusões para cada sessão, execute:
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