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
flag da CLI da gcloud
--verbosity
com depuração, informações, 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
.
- Se preferir, defina apenas o formato de sua saída, use a sinalização
Como passar feedback
Para relatar um bug, enviar feedback ou sugestões, use gcloud feedback
para
melhorar a experiência da CLI do 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.