Como ativar recursos de acessibilidade

Para fornecer uma experiência de leitor de tela mais otimizada, a ferramenta de linha de comando gcloud vem com uma propriedade accessibility/screen_reader. Quando essa propriedade é definida como "true", o seguinte comportamento é ativado:

  • Rastreadores de status em vez de ícone de carregamento Unicode: a frase "working" será exibida em stderr enquanto a gcloud estiver executando tarefas.
  • Porcentagem das barras de progresso: o progresso é exibido como uma porcentagem, gerado por stderr.
  • Tabelas niveladas: são tabelas resultantes de muitos comandos de lista. Em vez dos recursos consultados que são exibidos em tabelas desenhadas em Unicode, os resultados são renderizados como uma lista simplificada de itens. Além disso, use a sinalização --format para definir seu próprio formato.

Para ativar esses recursos de acessibilidade, execute:

 $ gcloud config set accessibility/screen_reader true

Outros recursos

Experiências de documentação alternativas

  • Para pesquisar os documentos de referência da CLI da gcloud por uma palavra-chave ou comando, use gcloud help. Isso executa uma pesquisa em todos os comandos com texto de ajuda que corresponde ao argumento ou argumentos fornecidos.

Como refinar a saída da CLI da gcloud

  • Para ajustar o nível de detalhamento de um comando, defina a sinalização CLI ampla da gcloud --verbosity com depuração, informação, aviso, erro, crítico ou nenhum.
  • Para comandos de lista, é possível refinar ainda mais sua saída usando a sinalização --limit para definir um número máximo de recursos a serem listados. Também será possível usar a sinalização --page-size para definir o número de recursos por página, se o serviço listar a saída em páginas. Para classificar, use a sinalização --sort-by com o campo relevante.
  • Para desativar a solicitação de prompts interativa, use a sinalização --quiet.
  • Para estruturar e produzir uma saída mais significativa, use as sinalizações de formato, filtro e projeção para aperfeiçoar sua saída.
    • Se preferir, defina apenas o formato de sua saída, use a sinalização --format para produzir uma versão tabulada ou simplificada da saída, para exibição interativa, ou uma versão legível por máquina de saída, como json, csv, yaml, value.
    • Se quiser formatar uma lista de chaves para selecionar valores de dados de recursos, use projections.
    • Para refinar ainda mais sua saída para um critério que você gostaria de definir, use a sinalização --filter.

Como passar feedback

Para relatar um bug, fornecer feedback ou enviar sugestões, use gcloud feedback para ajudar a melhorar a experiência da ferramenta de linha de comando gcloud. Esse comando abrirá o Issue Tracker público em uma janela do navegador.

Também é possível registrar problemas diretamente usando o Issue Tracker (em inglês). Para ajudar a tornar as respostas mais eficientes, certifique-se de alternar o campo "Type" para refletir a natureza do problema que você está registrando, seja bug, solicitação de recurso etc.