Esta página contém uma vista geral da CLI gcloud e dos respetivos padrões de comandos e capacidades comuns.
O que é a CLI gcloud?
A Google Cloud CLI é um conjunto de ferramentas para criar e gerir Google Cloud recursos. Pode usar estas ferramentas para realizar muitas tarefas comuns da plataforma a partir da linha de comandos ou através de scripts e outra automatização.
Por exemplo, pode usar a CLI gcloud para criar e gerir o seguinte:
- Instâncias de máquinas virtuais do Compute Engine e outros recursos
- Instâncias do Cloud SQL
- Clusters do Google Kubernetes Engine
- Clusters e tarefas do Dataproc
- Zonas geridas e conjuntos de registos do Cloud DNS
- Implementações do Cloud Deployment Manager
Também pode usar a CLI gcloud para implementar aplicações do App Engine, gerir a autenticação, personalizar a configuração local e realizar outras tarefas.
Transfira e instale a CLI gcloud
A versão atual da CLI gcloud é 539.0.0.
Embora recomendemos vivamente que use a versão atual da CLI gcloud, também pode transferir e instalar versões anteriores a partir do arquivo de transferências.
Se estiver a usar o Cloud Shell, a CLI gcloud está disponível automaticamente e não precisa de a instalar. Caso contrário, transfira e instale a CLI gcloud e, em seguida, inicialize-a.
Por predefinição, a CLI gcloud instala comandos que estão ao nível de disponibilidade geral. A funcionalidade adicional está disponível nos componentes da CLI gcloud denominados alpha e beta. Estes componentes
permitem-lhe usar a CLI gcloud para trabalhar com o Bigtable, o Dataflow e outras partes do Google Cloud em níveis de lançamento
anteriores à disponibilidade geral.
A referência rápida da CLI gcloud
Para uma introdução rápida à CLI gcloud, uma lista de comandos usados com frequência e uma explicação da estrutura destes comandos, consulte a referência rápida da CLI gcloud.
Níveis de lançamento
Os comandos da CLI gcloud têm os seguintes níveis de lançamento:
| Nível de lançamento | Etiqueta | Descrição |
|---|---|---|
| Disponibilidade geral | Nenhum | Os comandos são considerados totalmente estáveis e estão disponíveis para utilização em produção. Para receber um aviso prévio de alterações aos comandos que interrompem a funcionalidade atual, consulte as notas de lançamento. |
| Beta | beta |
Os comandos estão funcionalmente completos, mas ainda podem ter alguns problemas pendentes. As alterações significativas a estes comandos podem ser feitas sem aviso prévio. |
| Alfa | alpha |
Os comandos estão em lançamento antecipado e podem ser alterados sem aviso prévio. |
Os componentes alpha e beta não são instalados por predefinição quando instala a CLI gcloud. Tem de instalar estes componentes
separadamente através do comando gcloud components install. Se tentar executar um comando alfa ou beta e o componente correspondente não estiver instalado, a CLI gcloud pede-lhe que o instale.
Grupos de comandos
Em cada nível de lançamento, os comandos da CLI gcloud estão organizados numa hierarquia aninhada de grupos de comandos, cada um dos quais representa um produto ou uma funcionalidade do Google Cloud ou os respetivos subgrupos funcionais. Google Cloud
Por exemplo:
| Grupo de comandos | Descrição |
|---|---|
gcloud compute |
Comandos relacionados com o Compute Engine na disponibilidade geral |
gcloud compute instances |
Comandos relacionados com instâncias do Compute Engine em disponibilidade geral |
gcloud beta compute |
Comandos relacionados com o Compute Engine na versão beta |
gcloud alpha app |
Comandos relacionados com a gestão de implementações do App Engine em alfa |
Executar comandos da CLI gcloud
Pode executar comandos da CLI gcloud a partir da linha de comandos e de scripts e outras automatizações, por exemplo, quando usa o Jenkins para automatizar Google Cloud tarefas.
Propriedades
As propriedades da CLI gcloud são definições que afetam o comportamento das ferramentas da CLI gcloud. Algumas destas propriedades podem ser definidas por opções globais ou de comando. Nesse caso, o valor definido pela opção tem precedência.
Ativar funcionalidades de acessibilidade
Para uma experiência de leitor de ecrã mais simplificada, a CLI gcloud inclui uma propriedade accessibility/screen_reader.
Para ativar a propriedade de acessibilidade, execute o seguinte comando:
gcloud config set accessibility/screen_reader true
Para mais detalhes sobre as funcionalidades de acessibilidade incluídas na ferramenta de linha de comandos gcloud, consulte o guia Ativar funcionalidades de acessibilidade.
Configurações
Uma configuração é um conjunto de propriedades da CLI gcloud. Uma configuração funciona como um perfil.
Quando começa a usar a CLI gcloud, trabalha com uma única configuração denominada default e pode definir propriedades executando gcloud init ou gcloud config set. Esta única configuração predefinida é adequada para a maioria dos exemplos de utilização.
Para trabalhar com vários projetos ou contas de autorização, pode configurar
várias configurações com gcloud config configurations create e alternar
entre as configurações. Numa configuração, pode personalizar as propriedades.
Por exemplo, para definir o seu projeto numa configuração ativa, use a propriedade project:
gcloud config set project <project-id>
Para uma explicação detalhada destes conceitos, consulte o Guia de configurações.
Opções globais
A CLI gcloud fornece um conjunto de opções da CLI gcloud que regem o comportamento dos comandos ao nível de cada invocação. As opções substituem os valores definidos nas propriedades da CLI gcloud.
Argumentos e opções posicionais
Embora os argumentos posicionais e as opções afetem o resultado de um comando da CLI gcloud, existe uma diferença subtil nos respetivos exemplos de utilização. Um argumento posicional é usado para definir uma entidade na qual um comando opera, enquanto uma opção é necessária para definir uma variação no comportamento de um comando.
Utilização de stdout e stderr
O resultado dos comandos da CLI gcloud bem-sucedidos é escrito em
stdout. Todos os outros tipos de respostas (comandos, avisos e erros) são escritos em stderr. Não crie scripts com base nas respostas escritas para stderr porque estas respostas não são estáveis.
Para ver diretrizes sobre o processamento da saída, consulte o guia de scripts.
Interagir
Para se proteger contra ações destrutivas não intencionais, a CLI gcloud confirma as suas intenções antes de executar comandos como gcloud projects delete.
Pode ser-lhe pedido que forneça informações adicionais quando forem necessárias.
Por exemplo, é-lhe pedido que escolha uma zona quando cria uma instância de máquina virtual do Compute Engine usando gcloud compute instances create test-instance.
Para desativar os pedidos, use a opção --quiet.
Não crie scripts com base na redação dos comandos, uma vez que esta pode mudar.
Suprimir pedidos, escrita no terminal e registo
A opção --quiet (também -q) para a
CLI gcloud
desativa todas as instruções interativas quando executa comandos da CLI gcloud
e é útil para scripting. Se for necessária a introdução de dados, são usadas as predefinições. Se não existir uma predefinição, é gerado um erro.
Para suprimir a impressão da saída do comando para a saída padrão e o erro padrão no terminal, use a opção --no-user-output-enabled.
Para ajustar a verbosidade dos registos, especifique um nível de verbosidade (debug, info, warning,
error, critical ou none) através da opção
--verbosity.
Determinar a estrutura de saída
Por predefinição, quando um comando da CLI gcloud devolve uma lista de recursos, os recursos são formatados para apresentação no resultado padrão. Para produzir resultados mais significativos, as opções format, filter e projection permitem-lhe ajustar os resultados.
Para definir apenas o formato da saída, use a opção --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
projections. Para refinar ainda mais
o resultado de acordo com os critérios que definir, use
filter.
O que se segue?
- Saiba mais sobre os comandos da CLI gcloud na referência da CLI gcloud.