Neste guia de início rápido, você verá como instalar e inicializar o SDK do Cloud
e executar alguns comandos gcloud
principais para começar.
Como instalar a versão mais recente do SDK do Cloud (33.0.0)
O SDK do Cloud requer o Python. As versões compatíveis são Python 3 (preferencial, 3.5 a 3.8) e Python 2 (2.7.9 ou superior).
python --version
Para mais informações sobre como escolher e configurar seu interpretador do Python, consultegcloud topic startup
.- Faça o download de um dos itens a seguir:
-
Como alternativa, para fazer o download do arquivo do Linux de 64 bits a partir da linha de comando, execute:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-336.0.0-linux-x86_64.tar.gz
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-336.0.0-linux-x86.tar.gz
- Extraia o conteúdo do arquivo em qualquer local no sistema de arquivos (preferencialmente o diretório Início). Se você quer substituir uma instalação atual, remova o diretório
google-cloud-sdk
atual e extraia o arquivo para o mesmo local. - Opcional. Use o script de instalação para adicionar ferramentas do SDK do Cloud ao seu
PATH
. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso.Execute o script (na raiz da pasta extraída na última etapa) usando este comando:
./google-cloud-sdk/install.sh
Isso também pode ser feito de forma não interativa (por exemplo, com um script), fornecendo preferências como sinalizações. Eles são descritos em:./google-cloud-sdk/install.sh --help
Abra um novo terminal para as alterações entrarem em vigor. - Execute gcloud init para inicializar o SDK:
- Opcional. Instale componentes adicionais usando o gerenciador de componentes.
Plataforma | Pacote | Tamanho | Soma de verificação SHA256 |
---|---|---|---|
Linux de 64 bits (x86_64) |
google-cloud-sdk-33.0.0-linux-x86_64.tar.gz | 84,5 MB | f929aa3b7959150cf6c7299f3277fc27a9bf729f4877a2906aca740639bad63e |
Linux de 32 bits (x86) |
google-cloud-sdk-33.0.0-linux-x86.tar.gz | 81,8 MB | 4c1755d1164db8b751ae5c60dc1bb167252d13fee3883fbef3f3538f143c6c0 |
./google-cloud-sdk/bin/gcloud init
Conteúdo do pacote
O SDK do Cloud está disponível no formato de pacote para instalação em sistemas Debian e Ubuntu. O pacote contém apenas os comandos gcloud
, gcloud alpha
, gcloud beta
, gsutil
e bq
. Ele não inclui kubectl
ou as extensões do App Engine necessárias para implantar um aplicativo usando os comandos gcloud
.
Se você quiser esses componentes, instale-os separadamente conforme descrito
mais adiante nesta seção.
Antes de instalar o SDK do Cloud, verifique se o sistema operacional é um dos seguintes:
- Uma versão do Ubuntu que não atingiu o fim da vida útil
- Uma versão estável do Debian a partir da Wheezy
- Adicione o URI de distribuição do SDK do Cloud como a origem do pacote:
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
verifique se apt-transport-https (em inglês) está instalado:sudo apt-get install apt-transport-https ca-certificates gnupg
- Importe a chave pública do Google Cloud:
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
- Atualize e instale o SDK do Cloud:
sudo apt-get update && sudo apt-get install google-cloud-sdk
Para mais opções deapt-get
, como desativação de prompts ou simulações, consulte as páginas de manual deapt-get
(em inglês).Dica do Docker: se você estiver instalando o SDK do Cloud dentro de uma imagem do Docker, use uma única etapa RUN:
RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg add - && apt-get update -y && apt-get install google-cloud-sdk -y
- Se preferir, instale qualquer um destes
componentes extras:
google-cloud-sdk-app-engine-python
google-cloud-sdk-app-engine-python-extras
google-cloud-sdk-app-engine-java
google-cloud-sdk-app-engine-go
google-cloud-sdk-bigtable-emulator
google-cloud-sdk-cbt
google-cloud-sdk-cloud-build-local
google-cloud-sdk-datalab
google-cloud-sdk-datastore-emulator
google-cloud-sdk-firestore-emulator
google-cloud-sdk-pubsub-emulator
kubectl
Por exemplo, o componente
google-cloud-sdk-app-engine-java
pode ser instalado da seguinte maneira:sudo apt-get install google-cloud-sdk-app-engine-java
- Execute
gcloud init
para começar:gcloud init
Como fazer downgrade das versões do SDK do Cloud
Se você quiser reverter para uma versão específica do SDK do Cloud, em que VERSION
esteja no formato 123.0.0
, execute:
sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0
Os 10 lançamentos mais recentes sempre estarão disponíveis no repositório.
Conteúdo do pacote
O SDK do Cloud está disponível no formato de pacote para instalação nos sistemas Red Hat Enterprise Linux 7, Red Hat
Enterprise Linux 8, Fedora 33 e CentOS 7 e 8. O pacote contém apenas os comandos gcloud
, gcloud alpha
, gcloud beta
, gsutil
e bq
. Ele não inclui kubectl
ou as extensões do App Engine necessárias para
implantar um aplicativo usando comandos gcloud
, que podem ser
instalados separadamente, conforme descrito nesta seção.
- Atualize o DNF com as informações de repositório do SDK do Cloud:
sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM [google-cloud-sdk] name=Google Cloud SDK baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM
- Instale o Cloud SDK:
sudo dnf install google-cloud-sdk
- Se preferir, instale qualquer um destes
componentes extras:
google-cloud-sdk-app-engine-python
google-cloud-sdk-app-engine-python-extras
google-cloud-sdk-app-engine-java
google-cloud-sdk-app-engine-go
google-cloud-sdk-bigtable-emulator
google-cloud-sdk-cbt
google-cloud-sdk-cloud-build-local
google-cloud-sdk-datalab
google-cloud-sdk-datastore-emulator
google-cloud-sdk-firestore-emulator
google-cloud-sdk-pubsub-emulator
kubectl
Por exemplo, o componente
google-cloud-sdk-app-engine-java
pode ser instalado da seguinte maneira:sudo dnf install google-cloud-sdk-app-engine-java
- Execute
gcloud init
para começar:gcloud init
Como fazer downgrade das versões do SDK do Cloud
Se você quiser reverter para uma versão específica do SDK do Cloud, em que VERSION
esteja no formato 123.0.0
, execute:
sudo dnf downgrade google-cloud-sdk-VERSION
Os 10 lançamentos mais recentes sempre estarão disponíveis no repositório.
- O SDK do Cloud requer o Python. As versões compatíveis são Python 3 (preferencial, 3.5 a 3.8) e
Python 2 (2.7.9 ou superior). As versões modernas do macOS incluem a versão adequada do Python exigida para o SDK do Cloud.
No entanto, se você quiser instalar o Python 3 com o SDK do Cloud, escolha o macOS de 64 bits com a oferta de instalação no pacote do Python.
Para verificar a versão atual do Python, execute:
python -V
Para mais informações sobre como escolher e configurar seu interpretador do Python, consultegcloud topic startup
. - Faça o download de um dos seguintes itens:
- Extraia o arquivo para qualquer local no seu sistema de arquivos, de preferência no diretório principal. No macOS, isso pode ser feito abrindo o arquivo
.tar.gz
salvo no local de preferência.Se você quer substituir uma instalação atual, remova o diretório
google-cloud-sdk
atual e extraia o arquivo para o mesmo local. - Opcional. Use o script de instalação para adicionar ferramentas do SDK do Cloud ao seu
PATH
. Você também poderá usar a conclusão do comando no shell e a coleta de estatísticas de uso.Execute o script (na raiz da pasta extraída na última etapa) usando este comando:
./google-cloud-sdk/install.sh
Isso também pode ser feito de forma não interativa (por exemplo, com um script), fornecendo preferências como sinalizações. Eles são descritos em:./google-cloud-sdk/install.sh --help
Se você quer executar o script de instalação com o modo de leitor de tela ativado:./google-cloud-sdk/install.sh --screen-reader=true
Abra um novo terminal para as alterações entrarem em vigor. - Execute gcloud init para inicializar o SDK:
- Opcional. Instale componentes adicionais usando o gerenciador de componentes.
Plataforma | Pacote | Tamanho | Soma de verificação SHA256 |
---|---|---|---|
macOS de 64 bits (x86_64) |
google-cloud-sdk-33.0.0-darwin-x86_64.tar.gz | 85,0 MB | e1f049c536491e77ff9bfb8e29755ba7006a43c7dd891350848b668025f6039 |
macOS de 64 bits (arm64) |
google-cloud-sdk-33.0.0-darwin-arm.tar.gz | 84,9 MB | 9d6dfd1d09a813a7e9a99304d7f76b980d5526482165fc7f3b5cb4002b3fd39 |
macOS de 64 bits com Python incluído (x86_64) |
google-cloud-sdk-33.0.0-darwin-x86_64-bundled-python.tar.gz | 126,9 MB | 65255e20c4ecd68ff89899c35e4db62ec18fcb6a6e9ccc72b912c6a13f634133 |
macOS de 32 bits (x86) |
google-cloud-sdk-33.0.0-darwin-x86.tar.gz | 88,8 MB | ab6974c6f627e4bec9474169d15165c9ddacc5f8b1b3076b47e07ec29e84d77b |
./google-cloud-sdk/bin/gcloud init
-
Faça o download do Instalador do SDK do Cloud.
Se preferir, abra um terminal do PowerShell e execute os comandos a seguir:
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe") & $env:Temp\GoogleCloudSDKInstaller.exe
-
Inicie o instalador e siga as instruções. O instalador é assinado pela Google LLC.
Se você quiser ativar o modo de leitor de tela, selecione a opção Ativar modo de leitor de tela para uma experiência mais simplificada. Para ler mais sobre a experiência do leitor de tela do SDK do Cloud, consulte o Guia de recursos de acessibilidade.
-
O SDK do Cloud requer o Python. As versões compatíveis são Python 3 (preferencial, 3.5 a 3.8) e Python 2 (2.7.9 ou superior).
O instalador implantará todas as dependências necessárias, incluindo a versão necessária do Python. Mesmo que o SDK do Cloud use atualmente o Python 3 por padrão, é possível usar uma instalação atual do Python ao desmarcar a opção "Instalar Bundled Python", se necessário.
Depois que a instalação for concluída, o instalador apresenta várias opções:
Verifique se as opções abaixo estão selecionadas:
- Start Google Cloud SDK Shell (Iniciar Shell do SDK do Google Cloud)
- Run
gcloud init
O instalador inicia uma janela de terminal e executa o comando
gcloud init
.- A instalação padrão não inclui as extensões do App Engine necessárias para implantar um
aplicativo usando comandos
gcloud
. Para instalar esses componentes, use o gerenciador de componentes do SDK do Cloud.
- Se o SDK do Cloud não funcionar depois de instalar a versão 274.0.0, consulte este rastreamento de erros (em inglês) para acessar soluções alternativas.
- Se a instalação não for bem-sucedida devido ao comando
find
não ter sido reconhecido, verifique se sua variável de ambientePATH
está definida para incluir a pasta que contémfind
. Geralmente, isso éC:\WINDOWS\system32;
. - Se você acabou de desinstalar o SDK do Cloud, precisará reinicializar o sistema antes de instalá-lo novamente.
Opcional: instalar as bibliotecas de cliente mais recentes do Google Cloud
É possível fazer o download das Bibliotecas de cliente do Cloud para as linguagens compatíveis.
Como inicializar o SDK do Cloud
Use o comando gcloud init
para executar várias tarefas comuns de configuração do SDK do Cloud. Entre elas: autorizar as ferramentas do SDK do Cloud a acessar o Google Cloud usando as credenciais da sua conta de usuário e definir a configuração padrão.
Para inicializar o SDK do Cloud:
Execute o seguinte comando em um prompt:
gcloud init
Aceite a opção de fazer login com sua conta de usuário do Google:
To continue, you must log in. Would you like to log in (Y/n)? Y
No seu navegador, faça login na sua conta de usuário do Google quando solicitado e clique em Permitir para permitir acesso aos recursos do Google Cloud.
No prompt de comando, selecione um projeto do Google Cloud na lista daqueles em que você tem as permissões de proprietário, editor ou visualizador:
Pick cloud project to use: [1] [my-project-1] [2] [my-project-2] ... Please enter your numeric choice:
Se você tiver apenas um projeto,
gcloud init
o selecionará para você.Se você tiver acesso a mais de 200 projetos, precisará inserir um ID do projeto, criar um novo projeto ou listar projetos.
This account has a lot of projects! Listing them all can take a while. [1] Enter a project ID [2] Create a new project [3] List projects Please enter your numeric choice:
Se a API do Google Compute Engine estiver ativada,
gcloud init
permitirá que você escolha uma zona padrão do Compute Engine:Which compute zone would you like to use as project default? [1] [asia-east1-a] [2] [asia-east1-b] ... [14] Do not use default zone Please enter your numeric choice:
gcloud init
confirma que você concluiu as etapas de configuração corretamente:gcloud has now been configured! You can use [gcloud config] to change more gcloud settings. Your active configuration is: [default]
(Opcional) Se você quiser uma experiência de leitor de tela mais otimizada, a ferramenta de linha de comando gcloud vem com uma propriedade
accessibility/screen_reader
.Para ativar essa propriedade, execute:
gcloud config set accessibility/screen_reader true
Para mais detalhes sobre os recursos de acessibilidade que acompanham a ferramenta de linha de comando gcloud, consulte este guia.
Como executar comandos principais
Execute estes comandos gcloud
para visualizar informações sobre a instalação do SDK do Cloud:
Para listar contas com as credenciais armazenadas no sistema local:
gcloud auth list
gcloud
exibe uma lista de contas credenciadas:Credentialed Accounts ACTIVE ACCOUNT * example-user-1@gmail.com example-user-2@gmail.com
Para listar as propriedades na configuração ativa do SDK do Cloud:
gcloud config list
gcloud
exibe a lista de propriedades:[core] account = example-user-1@gmail.com disable_usage_reporting = False project = example-project
Para ver informações sobre a instalação do SDK do Cloud e a configuração ativa:
gcloud info
gcloud
exibe um resumo das informações sobre a instalação do SDK do Cloud. Isso inclui informações sobre o sistema, os componentes instalados, a conta de usuário ativa, o projeto atual e as propriedades da configuração ativa.Para visualizar informações sobre os comandos
gcloud
e outros tópicos na linha de comando:gcloud help
Por exemplo, para visualizar a ajuda para
gcloud compute instances create
:gcloud help compute instances create
gcloud
exibe um tópico de ajuda que contém uma descrição do comando, uma lista de sinalizações e argumentos de comando e exemplos de como usá-lo.
A seguir
- Leia o guia da ferramenta de linha de comando gcloud para uma visão geral da ferramenta, incluindo uma introdução rápida aos principais conceitos, convenções de comando e dicas úteis.
- Leia o guia de referência da ferramenta de linha de comando gcloud para páginas detalhadas sobre cada comando
gcloud
, incluindo descrições, sinalizações e exemplos que podem ser usados para executar diversas tarefas no Google Cloud. - Consulte a folha de referência da ferramenta de linha de comando gcloud para ver uma lista de comandos e conceitos-chave mais usados.
- Instale componentes complementares, como os emuladores do App Engine ou
kubectl
, usando o gerenciador de componentes do SDK do Cloud.
Faça um teste
Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também ganham US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
Comece gratuitamente