Preenchimento automático da CLI gcloud

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