Ativar funcionalidades de acessibilidade

Para oferecer uma experiência de leitor de ecrã mais simplificada, a ferramenta de linhas de comando gcloud inclui uma propriedade accessibility/screen_reader. Quando esta propriedade está definida como verdadeira, o seguinte comportamento é ativado:

  • Indicadores de estado em vez de ícones de carregamento Unicode: a expressão "a trabalhar" é apresentada em stderr enquanto o gcloud está a realizar tarefas.
  • Barras de progresso de percentagem: o progresso é apresentado como uma percentagem, enviado para stderr.
  • Tabelas simples: as tabelas com caixas são o resultado predefinido de muitos comandos list. Em vez de os recursos consultados serem apresentados em tabelas desenhadas em Unicode, os resultados são renderizados como uma lista simples de itens. Considere também usar a flag --format para definir o seu próprio formato.

Para ativar estas funcionalidades de acessibilidade, execute:

gcloud config set accessibility/screen_reader true

Recursos adicionais

Experiências de documentação alternativas

  • Para pesquisar nos documentos de referência da CLI gcloud uma palavra-chave ou um comando, use gcloud help. Isto executa uma pesquisa de todos os comandos com texto de ajuda correspondente ao argumento ou argumentos fornecidos.

Refinar o resultado da CLI gcloud

  • Para ajustar o nível de detalhe de um comando, pode definir a flag da CLI gcloud --verbosity com debug, info, warning, error, critical ou none.
  • Para comandos de lista, pode refinar ainda mais a saída usando a flag --limit para definir um número máximo de recursos a listar. Também pode usar a flag --page-size para definir o número de recursos por página se o serviço gerar a saída em páginas. Para ordenar, use a flag --sort-by com o campo relevante para ordenar.
  • Para desativar os comandos interativos, use a flag --quiet.
  • Para estruturar e produzir resultados mais significativos, pode usar as flags de formato, filtro e projeção para otimizar os resultados.
    • Se quiser definir apenas o formato da saída, use a flag --format para produzir uma versão tabelada ou simplificada da saída (para apresentação interativa) ou uma versão da saída legível por máquina (json, csv, yaml, value).
    • Para formatar uma lista de chaves que selecionam valores de dados de recursos, use projeções.
    • Para refinar ainda mais o resultado de acordo com um critério que quer definir, use a flag --filter.

Apresentar feedback

Para registar um erro, enviar feedback ou sugestões, use gcloud feedback para ajudar a melhorar a experiência da CLI gcloud. Este comando vai abrir o rastreador de problemas público numa janela do navegador.

Também pode registar problemas diretamente através do localizador de problemas. Certifique-se de que alterna o campo "Tipo" para refletir a natureza do problema que está a comunicar (erro, pedido de funcionalidade, etc.) para ajudar a tornar as respostas mais eficientes.