Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A Google Cloud CLI fornece um instalador para cada plataforma compatível e pode
ser implantada de maneira interativa ou não interativa.
Instalação interativa
O instalador permite fazer o download, instalar e configurar rapidamente a versão mais recente da Google Cloud CLI no modo interativo. Quando você executa o instalador,
ele faz o download dos componentes da Google Cloud CLI e os instala no sistema
local. Ele também executa outras tarefas de configuração, como adicionar componentes da CLI gcloud
ao PATH e ativar a conclusão do comando no shell.
Linux e macOS
Na linha de comando, execute o seguinte:
curlhttps://sdk.cloud.google.com|bash
Quando solicitado, escolha um local no seu sistema de arquivos (geralmente o diretório principal) para criar
o subdiretório google-cloud-sdk.
Se você quiser enviar estatísticas de uso anônimas para ajudar a melhorar a CLI gcloud,
responda Y quando solicitado.
Para adicionar ferramentas de linha de comando da CLI gcloud ao PATH e ativar o preenchimento
do comando, responda Y quando solicitado.
Reinicie o shell:
exec-l$SHELL
Para inicializar o ambiente da Google Cloud CLI, execute
gcloud init:
gcloudinit
Windows (instalador)
A Google Cloud CLI funciona no Windows 8.1 e versões mais recentes e no Windows Server 2012 e versões mais recentes.
Inicie o instalador e siga os prompts. O instalador é assinado pela Google LLC.
Se você estiver usando um leitor de tela, marque a caixa de seleção Ativar modo leitor de tela. Essa opção configura gcloud para usar rastreadores de status em vez de spinners unicode, exibir o progresso como uma porcentagem e nivelar tabelas. Para mais informações, consulte o Guia de recursos de acessibilidade.
A Google Cloud CLI requer Python. As versões compatíveis são o Python de 3.9 a 3.13. Por
padrão, a versão para Windows da CLI do Google Cloud vem com o Python 3. Para usar
a CLI do Google Cloud, seu sistema operacional precisa executar uma versão compatível do Python.
O instalador instala todas as dependências necessárias, incluindo a versão necessária do Python.
Embora o SDK da CLI do Google Cloud instale e gerencie o Python 3 por padrão, é possível usar uma
instalação atual do Python ao desmarcar a opção de instalar o Bundled Python, se necessário.
Consulte gcloud topic startup para
saber como usar uma instalação existente do Python.
Depois que a instalação for concluída, o instalador oferecerá a opção de criar os atalhos do menu
e da área de trabalho, iniciar o shell da CLI do Google Cloud e configurar a
CLI gcloud. Deixe as opções para iniciar o shell e configurar a instalação selecionadas. 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 da CLI gcloud.
Dicas de solução de problemas:
Se a instalação não for bem-sucedida devido ao comando find não ter sido reconhecido, verifique se sua variável de ambiente PATH está definida para incluir a pasta que contém find. Geralmente, isso é C:\WINDOWS\system32;.
Se você desinstalou a CLI gcloud, é necessário reinicializar o sistema antes de instalá-la novamente.
Se a descompactação falhar, execute o instalador como um administrador.
Windows (Zip)
Também é possível instalar a versão mais recente a partir de um arquivo .zip transferido por download:
Faça o download do google-cloud-sdk.zip e extraia o conteúdo dele. Clique com o botão direito do mouse no arquivo transferido e selecione Extrair tudo.
Inicie o script google-cloud-sdk\install.bat e siga as instruções de instalação.
Quando a instalação for concluída, reinicie o prompt de comando (cmd.exe).
É possível automatizar a instalação da Google Cloud CLI usando o script de instalação.
Para Linux e MacOS:
Salve o script de instalação localmente em vez de encaminhá-lo para o bash.
Digite o seguinte comando no prompt:
curlhttps://sdk.cloud.google.com > install.sh
Execute o script, transmitindo os argumentos descritos da seguinte maneira:
bashinstall.sh--disable-prompts
As opções de install.sh são:
--disable-prompts: desativa prompts.
--install-dir=DIRECTORY: define o diretório raiz da instalação como DIRECTORY. A Google Cloud CLI está instalada em
DIRECTORY/google-cloud-sdk. O padrão é $HOME.
Para Windows:
/S: instala silenciosamente. Nenhuma página do instalador é exibida. Use sinalizações para alterar as configurações de instalação
/D: define o diretório de instalação padrão. Precisa ser o último parâmetro usado na linha de comando e não pode incluir aspas, mesmo que o caminho contenha espaços. Somente caminhos absolutos são compatíveis. Por exemplo, /D=C:\CloudSDK.
/allusers: instala para todos os usuários
/singleuser: instala para o usuário atual (padrão)
/screenreader: ativa o modo de leitor de tela (o padrão é desativá-lo).
/reporting: ativa o relatório de uso (o padrão é desativar os relatórios de uso)
/noreporting: desativa o relatório de uso (o padrão é desativar os relatórios de uso)
/nostartmenu: não cria atalho do menu iniciar (o padrão é criar um atalho)
/nodesktop: não cria atalho na área de trabalho (o padrão é criar um atalho)
Faça um teste
Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos
produtos em situações reais. Clientes novos também recebem US$ 300 em
créditos para executar, testar e implantar cargas de trabalho.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# Using the Google Cloud CLI installer\n\nThe Google Cloud CLI provides an installer for each supported platform and can\nbe deployed interactively or non-interactively.\n\nInteractive installation\n------------------------\n\nThe installer lets you download, install, and set up the latest version of\nGoogle Cloud CLI in an interactive mode. When you run the installer,\nit downloads Google Cloud CLI components and installs them on the local\nsystem. It also performs additional setup tasks like adding gcloud CLI\ncomponents to your `PATH` and enabling command completion in your shell.\n| **Note:** The installer is designed to make it easy for a user to install the latest version of Google Cloud CLI. If you want to use a script to install a specific version in non-interactive mode --- for example, to install the same version automatically every time you build a production system --- use a [versioned archive](/sdk/docs/downloads-versioned-archives) of the Google Cloud CLI.\nLinux and macOS\n\n1. At the command line, run the following command: \n\n ```bash\n curl https://sdk.cloud.google.com | bash\n ```\n2. When prompted, choose a location on your file system (usually your Home directory) to create the `google-cloud-sdk` subdirectory under.\n3. If you want to send anonymous usage statistics to help improve gcloud CLI, answer `Y` when prompted.\n4. To add gcloud CLI command-line tools to your `PATH` and enable command completion, answer `Y` when prompted.\n5. Restart your shell: \n\n ```bash\n exec -l $SHELL\n ```\n6. To initialize the Google Cloud CLI environment, run [`gcloud init`](/sdk/gcloud/reference/init): \n\n ```bash\n gcloud init\n ```\nWindows (Installer)\n\nThe Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.\n1.\n Download the [Google Cloud CLI installer](https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe).\n\n\n Alternatively, open a PowerShell terminal and run the following PowerShell commands: \n\n ```bash\n (New-Object Net.WebClient).DownloadFile(\"https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe\", \"$env:Temp\\GoogleCloudSDKInstaller.exe\")\n\n & $env:Temp\\GoogleCloudSDKInstaller.exe\n \n ```\n2. Launch the installer and follow the prompts. The installer is signed by Google LLC.\n\n\n If you're using a screen reader, check the **Turn on screen reader mode** checkbox. This\n option configures `gcloud` to use status trackers instead of unicode spinners,\n display progress as a percentage, and flatten tables. For more information, see the\n [Accessibility features guide](/sdk/docs/enabling-accessibility-features).\n3. Google Cloud CLI requires Python; supported versions are Python 3.9 to 3.13. By\n default, the Windows version of Google Cloud CLI comes bundled with Python 3. To use\n Google Cloud CLI your operating system must be able to run a supported version of Python.\n\n\n The installer installs all necessary dependencies, including the needed Python version.\n While Google Cloud CLI installs and manages Python 3 by default, you can use an existing\n Python installation if necessary by **unchecking** the option to Install Bundled Python.\n See [`gcloud topic startup`](/sdk/gcloud/reference/topic/startup) to\n learn how to use an existing Python installation.\n4. After installation is complete, the installer gives you the option to create Start Menu\n and Desktop shortcuts, start the Google Cloud CLI shell, and configure the\n gcloud CLI. Make sure that you leave the options to start the shell and configure your\n installation selected. The installer starts a terminal window and runs the\n [`gcloud init`](/sdk/gcloud/reference/init) command.\n\n5. The default installation doesn't include the App Engine extensions required to deploy an application using `gcloud` commands. These components can be installed using the [gcloud CLI component manager](/sdk/docs/managing-components).\n\n**Troubleshooting tips:**\n\n- If your installation is unsuccessful due to the `find` command not being recognized, ensure your `PATH` environment variable is set to include the folder containing `find`. Usually, this is `C:\\WINDOWS\\system32;`.\n- If you uninstalled the gcloud CLI, you must reboot your system before installing the gcloud CLI again.\n- If unzipping fails, run the installer as an administrator.\nWindows (Zip)\n\nYou can also install the latest version from a downloaded\n`.zip` file:\n\n1.\n Download\n [google-cloud-sdk.zip](https://dl.google.com/dl/cloudsdk/channels/rapid/google-cloud-sdk.zip)\n and extract its contents. (Right click on the downloaded file and\n select **Extract All**.)\n\n2.\n Launch the `google-cloud-sdk\\install.bat` script and follow\n the installation prompts.\n\n3.\n When the installation finishes, restart the command prompt\n (`cmd.exe`).\n\n4. Run [`gcloud init`](/sdk/gcloud/reference/init):\n\n ```\n C:\\\u003e gcloud init\n ```\n\nNon-interactive (silent) deployment\n-----------------------------------\n\nYou can automate Google Cloud CLI installation using the install script.\n\n**For Linux and MacOS:**\n\nSave the install script locally instead of piping it to bash.\n\n1. Enter the following at a command prompt: \n\n ```bash\n curl https://sdk.cloud.google.com \u003e install.sh\n ```\n2. Run the script, passing arguments described as follows: \n\n ```bash\n bash install.sh --disable-prompts\n ```\n\nThe `install.sh` options are:\n\n- `--disable-prompts` - disable prompts.\n- `--install-dir=`\u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e - set the installation root directory to \u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e. The Google Cloud CLI is installed in \u003cvar translate=\"no\"\u003eDIRECTORY\u003c/var\u003e`/google-cloud-sdk`. The default is $HOME.\n\n**For Windows:**\n| **Important:** These flags are for the [Windows installer](/sdk/docs/install-sdk) and are case sensitive.\n\n- `/S` - install silently. No installer pages are displayed. Use flags to change install settings.\n- `/D` - set the default installation directory. It must be the last parameter used in the command line and must not contain any quotes, even if the path contains spaces. Only absolute paths are supported, for example `/D=C:\\CloudSDK`\n- `/allusers` - install for all users\n- `/singleuser` - install for current user (default)\n- `/screenreader` - turn on screen reader mode (default is to turn it off)\n- `/reporting` - enable usage reporting (default is to turn off usage reporting)\n- `/noreporting` - disable usage reporting (default is to turn off usage reporting)\n- `/nostartmenu` - don't create start menu shortcut (default is to create shortcut)\n- `/nodesktop` - don't create desktop shortcut (default is to create shortcut)\n\nTry it for yourself\n-------------------\n\n\nIf you're new to Google Cloud, create an account to evaluate how our\nproducts perform in real-world scenarios. New customers also get $300 in\nfree credits to run, test, and deploy workloads.\n[Get started for free](https://console.cloud.google.com/freetrial)"]]