初始化 Cloud SDK

本页面介绍了如何初始化 Google Cloud SDK。

安装 Cloud SDK 后,下一步通常是运行 gcloud init 命令来执行初始设置任务。您也可以稍后运行 gcloud init 来更改设置或创建新配置。

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

  • 授权 Cloud SDK 工具使用您的用户帐号凭据访问 Google Cloud Platform,或者,如果您有已经获得授权的访问权限,则通过此命令让您选择一个帐号
  • 设置 Cloud SDK 配置 并设置一组基本 属性,包括上述步骤中的活跃帐号、当前项目以及默认的 Google Compute Engine 区域和地区(如适用)

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

命令 说明
gcloud auth login 在无需设置配置的情况下,使用用户帐号进行授权。
gcloud auth activate-service-account 使用服务帐号而非用户帐号进行授权。

适用于在不使用网络浏览器的情况下以非交互方式进行授权。

gcloud config [COMMAND]
gcloud config configurations [COMMAND]
创建和管理 Cloud SDK 配置及属性。

运行 gcloud init

如需初始化 Cloud SDK,请执行以下操作:

  1. 运行 gcloud init

    gcloud init
    

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

    gcloud init --console-only
    
  2. 根据提示创建或选择配置。

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

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

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

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

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

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

    如果您只能访问一个项目(包括您的用户帐号的默认项目),gcloud init 会为您选择该项目。其他情况下,您可以从您拥有 OwnerEditorViewer 权限的项目列表中选择一个项目。gcloud init 会将配置中的 project 属性设置为您选择的属性。

  5. 如果出现提示,请选择默认的 Google Compute Engine 地区。

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

gcloud init 完成后,它会将活跃配置中的属性输出到终端:

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

您可以使用 gcloud config list 命令在其他任何时间查看这些属性。

后续步骤