Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, mostramos como inicializar a CLI gcloud.
Depois de instalar a CLI gcloud, execute tarefas de configuração inicial executando
gcloud init. Também é possível executar gcloud init
para alterar as configurações ou criar uma nova configuração.
gcloud init executa as seguintes etapas de configuração:
Autoriza a CLI gcloud a usar as credenciais da sua
conta de usuário para acessar Google Cloudou permite que você selecione uma
conta se tiver um acesso previamente autorizado
Determina uma configuração da CLI gcloud
e define um conjunto básico de propriedades, que inclui
a conta ativa da etapa acima, o projeto atual e a região e a zona padrão do Compute Engine,
se aplicável.
É possível executar o seguinte como alternativas para gcloud init:
Cria e gerencia configurações e propriedades da CLI gcloud.
Inicializar a CLI gcloud
Para inicializar a CLI gcloud:
Execute gcloud init:
gcloud init
Se você estiver em uma sessão de terminal remota, use a sinalização --no-launch-browser para impedir que o comando inicie um fluxo de autorização baseado em navegador, se necessário:
gcloud init --no-launch-browser
Caso seja solicitado, crie ou selecione uma configuração.
Se você estiver inicializando uma nova instalação da CLI gcloud,
gcloud init criará uma configuração chamada default para você e a definirá
como a configuração ativa. Se você tiver configurações atuais,
gcloud init solicitará que você escolha entre três opções:
reinicializar a ativa, alternar para outra e a reinicializar ou
criar uma nova.
Conclua a etapa de autorização quando solicitado.
Se você já tiver um acesso previamente autorizado ao
Google Cloud, talvez receba uma solicitação para fazer login e conceder acesso em um
navegador da Web ou selecionar uma conta atual.
Se você usou a flag --no-launch-browser e o login for necessário, copie e cole o URL de autorização fornecido em outra janela do navegador e siga as instruções.
Quando essa etapa for concluída, gcloud init definirá a propriedade account na configuração para a conta especificada.
Se for solicitado, escolha um projeto Google Cloud atual.
Se você só tiver acesso a um projeto, incluindo o projeto padrão para sua conta de usuário, gcloud init o selecionará para você.
Caso contrário, é possível
selecionar um projeto a partir de uma lista de projetos para os que você tem as permissões de
proprietário, editor ou visualizador. gcloud init define project
na configuração da propriedade que você escolher. 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 for solicitado, escolha uma zona padrão do Compute Engine.
Se você não tiver a API Compute Engine ativada ou se já
tiver uma zona padrão nos
metadados para envolvidos no projeto,
não verá essa etapa. gcloud init define as propriedades region e zone na
configuração usando a zona que você escolher.
Para conferir as propriedades definidas com o comando gcloud init, use o
comando gcloud config list.
[compute]
region = us-east1
zone = us-east1-b
[core]
account = dana@example.com
disable_usage_reporting = False
project = example-project
Para saber mais sobre como autorizar o Application Default Credentials (ADC) para
bibliotecas de cliente do Cloud (e bibliotecas de cliente de APIs do Google),
consulte Configurar o Application Default Credentials.
[[["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,["# Initializing the gcloud CLI\n\nThis page shows you how to initialize the gcloud CLI.\n\nAfter you install the gcloud CLI, perform initial setup tasks by running\n[`gcloud init`](/sdk/gcloud/reference/init). You can also run `gcloud init`\nto change your settings or create a new configuration.\n\n`gcloud init` performs the following setup steps:\n\n- [Authorizes](/sdk/docs/authorizing) the gcloud CLI to use your user account credentials to access Google Cloud, or lets you select an account if you have previously authorized access\n- Sets up a gcloud CLI [configuration](/sdk/docs/configurations) and sets a base set of [properties](/sdk/docs/properties), including the active account from the step above, the current project, and if applicable, the default Compute Engine region and zone\n\nYou can run the following as alternatives to `gcloud init`:\n\nInitialize the gcloud CLI\n-------------------------\n\nTo initialize the gcloud CLI:\n\n1. Run `gcloud init`:\n\n gcloud init\n\n If you are in a remote terminal session, you can use the `--no-launch-browser`\n flag to prevent the command from launching a browser-based authorization\n flow, if required: \n\n gcloud init --no-launch-browser\n\n2. Create or select a configuration if prompted.\n\n If you are initializing a new gcloud CLI installation,\n `gcloud init` creates a configuration named `default` for you and sets\n it as the active configuration. If you have existing configurations,\n `gcloud init` prompts you to choose between three options ---\n re-initialize the active one, switch to another one and re-initialize it, or\n create a new one.\n3. Complete the authorization step when prompted.\n\n Depending on whether you have previously authorized access to\n Google Cloud, you might be prompted to log in and grant access in a\n web browser or to select an existing account.\n\n If you used the `--no-launch-browser` flag and login is required,\n you must then copy and paste the provided authorization URL into another\n browser window and follow the prompts provided.\n\n When this step is completed, `gcloud init` sets the `account` property in\n the configuration to the specified account.\n4. Choose a current Google Cloud project if prompted.\n\n If you only have access to one project, including the default project for\n your user account, `gcloud init` selects it for you.\n\n Otherwise, you can\n select a project from a list of projects for which you have **Owner** ,\n **Editor** or **Viewer** permissions. `gcloud init` sets the `project`\n property in the configuration to the property you choose. If you have\n access to more than 200 projects, you will be prompted to enter\n a project id, create a new project, or list projects. \n\n ```\n This account has a lot of projects! Listing them all can take a while.\n [1] Enter a project ID\n [2] Create a new project\n [3] List projects\n Please enter your numeric choice:\n ```\n | **Note:** If you choose to create a project, you'll also need to [enable billing on your project](/billing/docs/how-to/modify-project) to use Google Cloud services.\n5. Choose a default Compute Engine zone if prompted.\n\n If you don't have the Compute Engine API enabled or you already\n have a default zone in your\n [project-level metadata](/compute/docs/metadata), you will not see this\n step. `gcloud init` sets the `region` and `zone` properties in the\n configuration using the zone you choose.\n\nTo view the properties set through the `gcloud init` command, use the\n[`gcloud config list`](/sdk/gcloud/reference/config/list) command. \n\n```sh\n[compute]\nregion = us-east1\nzone = us-east1-b\n[core]\naccount = dana@example.com\ndisable_usage_reporting = False\nproject = example-project\n```\n\nWhat's next\n-----------\n\n- To learn more about tool authorization, see [Authorizing the gcloud CLI](/sdk/docs/authorizing).\n- To learn more about authorizing Application Default Credentials (ADC) for Cloud Client Libraries (and Google API Client Libraries), see [Set up Application Default Credentials](/docs/authentication/provide-credentials-adc#how-to).\n- To learn more about managing configurations, see [gcloud CLI configurations](/sdk/docs/configurations).\n- To learn more about managing properties, see [gcloud CLI properties](/sdk/docs/properties)."]]
