初始化 Cloud SDK

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

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

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

  • 授权 Cloud SDK 工具使用您的用户帐号凭据访问 Google Cloud,或者,如果您有已经获得授权的访问权限,则通过此命令让您选择一个帐号
  • 设置 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. 根据提示完成授权步骤。

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

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

    完成此步骤后,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. 如果出现提示,请选择默认的 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 命令在其他任何时间查看这些属性。

后续步骤