Windows 快速入门

本页面介绍了如何安装和初始化 Google Cloud SDK,以及如何通过命令行运行核心 gcloud 命令。

准备工作

  1. 创建一个 Google Cloud Platform 项目(如果您还没有此项目)。
  2. 下载 Google Cloud SDK 安装程序

  3. 启动安装程序并按提示操作。

  4. 安装完成后,安装程序会提供几个选项:

    Windows 安装程序提示

    确保选中以下选项:

    • 启动 Google Cloud SDK Shell (Start Google Cloud SDK Shell)
    • 运行 gcloud init (Run gcloud init)

    然后,安装程序会启动终端窗口并运行 gcloud init 命令。

问题排查提示

  • 如果 Cloud SDK 在安装版本 274.0.0 后无法运行,请参阅此 跟踪 bug,了解最新的解决方法。
  • 如果由于 find 命令未被识别而导致安装失败,请确保您的 PATH 环境变量设置为将包含 find 的文件夹包括在内。通常,此文件夹为 C:\WINDOWS\system32;
  • 如果您刚刚卸载了 Cloud SDK,则需要重新启动系统才能再次安装 Cloud SDK。

初始化 SDK

使用 gcloud init 命令可执行一些常见的 SDK 设置任务,其中包括授权 SDK 工具使用您的用户帐号凭据访问 Google Cloud Platform 以及设置默认的 SDK 配置。

要初始化 SDK,请执行以下操作:

  1. 在命令提示符处运行以下命令:

    gcloud init
    

  2. 接受使用您的 Google 用户帐号进行登录的选项:

    To continue, you must log in. Would you like to log in (Y/n)? Y
    
  3. 在浏览器中,根据提示登录您的 Google 用户帐号,然后点击允许以授权访问 Google Cloud Platform 资源。

  4. 在命令提示符处,从您拥有所有者编辑者查看者权限的项目列表中选择一个 Cloud Platform 项目:

    Pick cloud project to use:
     [1] [my-project-1]
     [2] [my-project-2]
     ...
     Please enter your numeric choice:
    

    如果您只有一个项目,则 gcloud init 会为您选择该项目。

    如果您有权访问超过 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 API,则通过 gcloud init,您可以选择默认的 Compute Engine 地区:

    Which compute zone would you like to use as project default?
     [1] [asia-east1-a]
     [2] [asia-east1-b]
     ...
     [14] Do not use default zone
     Please enter your numeric choice:
    

    gcloud init 可确认您已成功完成设置步骤:

    gcloud has now been configured!
    You can use [gcloud config] to change more gcloud settings.
    
    Your active configuration is: [default]
    
  6. (可选)如果您想要获得更精简的屏幕阅读器体验,gcloud 命令行工具会附带 accessibility/screen_reader 属性。

    如需启用此属性,请运行以下命令:

    gcloud config set accessibility/screen_reader true
    

    如需详细了解 gcloud 命令行工具附带的无障碍功能,请参阅 启用无障碍功能 指南。

运行核心 gcloud 命令

运行以下 gcloud 命令可查看您安装的 SDK 的相关信息:

  1. 如需列出其凭据存储在本地系统上的帐号,请运行以下命令:

    gcloud auth list
    

    gcloud 会显示存储了凭据的帐号列表:

           Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. 如需列出您的活跃 SDK 配置中的属性,请运行以下命令:

    gcloud config list
    

    gcloud 会显示属性列表:

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. 要查看您的 Cloud SDK 安装实例和活动 SDK 配置的相关信息,请运行以下命令:

    gcloud info
    

    gcloud 会显示您安装的 Cloud SDK 的相关信息摘要。其中包括与系统、已安装的 SDK 组件、活动用户帐号、当前项目以及活动 SDK 配置中的属性有关的信息。

  4. 如需通过命令行查看有关 gcloud 命令和其他主题的信息,请运行以下命令:

    gcloud help
    

    例如,如需查看 gcloud compute instances create 的帮助信息,请运行以下命令:

    gcloud help compute instances create
    

    gcloud 会显示一个帮助主题,其中包含该命令的说明、命令标志和参数的列表以及关于如何使用该命令的示例。

后续步骤

  • 请参阅 gcloud 工具指南,以大致了解 gcloud 命令行工具,其中包括关键概念的简单介绍、命令格式约定,以及实用提示。
  • 请参阅 gcloud 参考指南,以查看可用来在 Google Cloud Platform 上执行各项任务的每个 gcloud 命令的相关详情页面,其中包括说明、标志和示例。
  • 如需查看常用命令和关键概念的列表,请参阅 gcloud 命令行工具备忘单
  • 使用 Cloud SDK 组件管理器 安装其他组件,例如 App Engine 模拟器或 kubectl