Como usar o shell interativo da gcloud

O shell interativo da gcloud oferece uma experiência mais completa para o bash, que simplifica a descoberta de comandos e da documentação com o preenchimento automático enquanto você digita e snippets de texto de ajuda.

Ele produz sugestões e preenchimento automático para as ferramentas de linha de comando gcloud, bq, gsutil e kubectl e qualquer comando que tenha uma página man(1). Subcomandos, sinalizações e argumentos de arquivo e recurso são concluídos, com a ajuda in-line, conforme o comando é composto.

Instalação e uso

  1. Verifique se você tem os componentes gcloud beta instalados:

    gcloud components list
    
  2. Para instalar os componentes Beta:

    gcloud components install beta
    
  3. Insira o modo gcloud interactive:

    gcloud beta interactive
    

    O prompt do shell usual será substituído pelo prompt do shell interativo do $.

  4. Para sair do tipo de shell interativo exit, ctrl-d ou F9.

Preenchimento automático e ajuda

gcloud interactive tem um prompt automático para comandos e sinalizações e exibe os snippets de ajuda inline na seção inferior conforme o comando é digitado.

Informações estáticas, como nomes de comando e subcomando, nomes de sinalizações e valores de sinalizações enumeradas, são preenchidas automaticamente usando menus suspensos. Clique em tab para preencher o caminho do arquivo e os argumentos do recurso.

Digite o próximo caractere para refinar o menu suspenso de preenchimento ou use tab para percorrer o menu. Por fim, use space ou / para selecionar o item ou diretório destacado.

Sessão de exemplo do shell interativo da gcloud

Atalhos

Para realizar tarefas comuns, é possível usar as teclas de função para alternar entre configurações de modo/estado ou executar ações específicas.

  • F2:help:STATE alterna a seção de ajuda ativa: ON quando ativada, OFF quando desativada.
  • F7:context define o contexto para a entrada de comando, de modo que você não terá que digitar novamente prefixos de comando a cada prompt. O contexto é a linha de comando logo após o prompt até o cursor. Por exemplo, se você estiver prestes a trabalhar com gcloud compute por um tempo, digite gcloud compute e pressione F7. Pressione ctrl-c e F7 para limpar o contexto.
  • F8:web help abre uma janela/guia do navegador da Web para exibir a ajuda completa da página de manual do comando atual. Se o navegador da Web não estiver disponível, haverá uma tentativa de acessar a ajuda específica do comando ou a ajuda man(1).
  • F9:quit Sair. Também é possível executar o comando exit ou pressionar ctrl-d para sair.

Compatibilidade de bash

Configurações completas de bash, aliases, exportações, funções, configurações de set -o e variáveis inicializadas em .bashrc estão disponíveis no prompt de comando interativo. O modo de edição da linha de comando interativo é derivado da configuração set -o emacs ou set -o vi.

Mais informações

Para mais detalhes sobre o shell interativo e atalhos, caracteres de controle, modos de editor e opções de layout configuráveis, consulte a página de referência da gcloud beta interactive.