初始化 gcloud CLI

本页面介绍了如何初始化 gcloud CLI。

安装 gcloud CLI 后,运行 gcloud init 以执行初始设置任务。您还可以运行 gcloud init 来更改设置或创建新配置。

gcloud init 可执行以下设置步骤:

  • 授权 gcloud CLI 使用您的用户账号凭据访问 Google Cloud,或者,如果您有已经获得授权的访问权限,则让您选择一个账号
  • 设置 gcloud CLI 配置并设置一组基本属性,包括上一步中的活动账号、当前项目以及默认的 Compute Engine 区域和可用区(如适用)

您可以运行以下命令来代替 gcloud init

命令 说明
gcloud auth login 在无需设置配置的情况下,对用户账号进行授权。
gcloud auth activate-service-account 使用服务账号(而非用户账号)授权。
适用于在不使用网络浏览器的情况下进行非交互式授权。
gcloud config [COMMAND]
gcloud config configurations [COMMAND]
创建和管理 gcloud CLI 配置和属性。

初始化 gcloud CLI

如需初始化 gcloud CLI,请执行以下操作:

  1. 运行 gcloud init

    gcloud init
    

    如果您处于远程终端会话中,您可以使用 --no-launch-browser 标志来防止该命令启动基于浏览器的授权流程(如有必要):

    gcloud init --no-launch-browser
    
  2. 根据提示创建或选择配置。

    如果您要初始化新的 gcloud CLI 安装, gcloud init 会为您创建一个名为 default 的配置,并将 并将其设为有效配置如果您已有配置,gcloud init 会提示您在三个选项中进行选择:重新初始化活跃配置、切换到另一个配置并重新初始化,或者创建新配置。

  3. 根据提示完成授权步骤。

    根据您以前是否已获得授权访问 Google Cloud,系统可能会提示您登录并在网络浏览器中授予访问权限,或提示您选择现有账号。

    如果您使用了 --no-launch-browser 标志并且需要登录,您必须将提供的授权网址复制并剪贴到另一个浏览器窗口中,并按照提供的提示进行操作。

    完成此步骤后,gcloud init 会将配置中的 account 属性设置为指定的账号。

  4. 如果出现提示,请选择当前的 Google Cloud 项目。

    如果您只能访问一个项目(包括您的用户账号的默认项目),gcloud init 会为您选择该项目。

    其他情况下,您可以从您拥有 OwnerEditorViewer 权限的项目列表中选择一个项目。gcloud init 会将配置中的 project 属性设置为您选择的属性。如果您有权访问超过 200 个项目,则系统会提示您输入项目 ID、创建新项目或列出项目。

    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:
    
  5. 如果出现提示,请选择默认的 Compute Engine 可用区。

    如果您没有启用 Compute Engine API,或者您的 项目级层元数据 中已经存在默认可用区,那么您不会看到此步骤。gcloud init 会使用您选择的可用区设置配置中的 regionzone 属性。

如需查看通过 gcloud init 命令设置的属性,请使用 gcloud config list 命令。

[compute]
region = us-east1
zone = us-east1-b
[core]
account = dana@example.com
disable_usage_reporting = False
project = example-project

后续步骤