快速入门:开始使用 Cloud SDK

本快速入门将指导您安装和初始化 Cloud SDK,以及运行几个核心 gcloud 命令来帮助您入门。

安装最新的 Cloud SDK 版本 (319.0.0)

Linux
  1. Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.8 版本,以及 2.7.9 或更高版本。

    python --version
    如需详细了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下某个软件包
  3. 平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-319.0.0-linux-x86_64.tar.gz 86.4 MB 28048af8fe83a1c80a37258d4e6c00edf22bc93edf570fb9bb6a42cca726d4c5
    Linux 32 位

    (x86)

    google-cloud-sdk-319.0.0-linux-x86.tar.gz 84.6 MB d54faf431374f83b08769e0ef5c126710a8ea1b3243a98ea69911d42742661ed

  4. 或者,如需通过命令行下载 Linux 64 位归档文件,请运行以下命令:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-319.0.0-linux-x86_64.tar.gz

    对于 32 位归档文件,请运行以下命令:

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-319.0.0-linux-x86.tar.gz
  5. 将文件内容解压缩到文件系统上的任意位置。如果您想替换现有安装,请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。
  6. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能。使用以下命令运行脚本:
    ./google-cloud-sdk/install.sh
    
    也可以通过提供偏好设置作为标志来以非交互方式(例如,使用脚本)完成此操作。相关说明,请参阅:
    ./google-cloud-sdk/install.sh --help
    
    打开新终端,以使更改生效。
  7. 运行 gcloud init 来初始化 SDK:
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. 可选。使用组件管理器安装其他组件。
Debian/Ubuntu

软件包内容

对于 Debian 和 Ubuntu 系统,可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutilbq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。如果您需要这些组件,则必须按照本部分稍后所述的方法另行安装。

前提条件

在安装 Cloud SDK 之前,请确保您的操作系统是下面某一项:

安装
  1. 添加 Cloud SDK 分发 URI 作为软件包源:
    echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    请确保您已安装 apt-transport-https
    sudo apt-get install apt-transport-https ca-certificates gnupg

    问题排查提示:如果您的发行版不支持 signed-by 选项,请改为运行以下命令:

    echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

    问题排查提示:请确保您没有重复的 cloud-sdk 代码库条目。

  2. 导入 Google Cloud 公钥:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    问题排查提示:如果您由于密钥过期而无法获取最新更新,请获取最新的 apt-get.gpg 密钥文件

    问题排查提示:如果您发行版的 apt-key 命令不支持 --keyring 参数,请改为运行以下命令:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

  3. 更新并安装 Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    如需了解其他 apt-get 选项(例如停用提示或试运行),请参阅 apt-get 手册页面

    Docker 提示:如果在 Docker 映像中安装 Cloud SDK,请改用单个 RUN 步骤:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-sdk -y
          

  4. 您可以选择安装以下任何其他组件
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    例如,google-cloud-sdk-app-engine-java 组件可以按以下方式安装:

    sudo apt-get install google-cloud-sdk-app-engine-java
  5. 运行 gcloud init 以开始执行初始化操作:
    gcloud init

降级 Cloud SDK 版本

如果您想还原到特定版本的 Cloud SDK(其中 VERSION 为 123.0.0 形式),请运行以下命令:sudo apt-get update && sudo apt-get install google-cloud-sdk=123.0.0-0

Red Hat/Fedora/CentOS

软件包内容

对于 Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8、Fedora 32 和 CentOS 7 系统,可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutilbq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所必需的 App Engine 扩展程序,但您可以单独安装这些内容,如本部分稍后所述。

安装
  1. 利用 Cloud SDK 代码库信息更新 DNF:
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-sdk]
    name=Google Cloud SDK
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el7-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=1
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. 安装 Cloud SDK:
    dnf install google-cloud-sdk
  3. 您可以选择安装以下任何其他组件
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-bigtable-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-firestore-emulator
    • google-cloud-sdk-pubsub-emulator
    • kubectl

    例如,google-cloud-sdk-app-engine-java 组件可以按以下方式安装:

    dnf install google-cloud-sdk-app-engine-java
  4. 运行 gcloud init 以开始执行初始化操作:
    gcloud init

降级 Cloud SDK 版本

如果您想还原到特定版本的 Cloud SDK(其中 VERSION 为 123.0.0 形式),请运行以下命令:sudo dnf downgrade google-cloud-sdk-VERSION

macOS
  1. Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.8 版本,以及 2.7.9 或更高版本。现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。
      python -V
      
    如需详细了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下某个软件包
  3. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    google-cloud-sdk-319.0.0-darwin-x86_64.tar.gz 86.7 MB 5c37fc7199141c63b6e5b1dfc55ed88ae681077fcf2e5fbd9945ad378cdf8d4e
    macOS 32 位

    (x86)

    google-cloud-sdk-319.0.0-darwin-x86.tar.gz 85.7 MB cbc88f1ac96504343b6f349b9289c22273f4803c64444d2161b015ff6a5c9fd6

    1. 将归档解压缩到文件系统上的任意位置;最好是解压缩到您的主目录。在 macOS 中,可通过打开下载到首选位置的 .tar.gz 归档文件来实现此目的。

      如果您想替换现有安装,请移除现有的 google-cloud-sdk 目录并将归档解压缩到同一位置。

    2. 可选。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以选择为您的 shell 启用命令补全功能以及选择开启使用情况统计信息收集功能。使用以下命令运行脚本:
      ./google-cloud-sdk/install.sh
      
      也可以通过提供偏好设置作为标志来以非交互方式(例如,使用脚本)完成此操作。相关说明,请参阅:
      ./google-cloud-sdk/install.sh --help
      
      如果您要在开启屏幕阅读器模式的情况下运行安装脚本,请执行以下操作:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      打开新终端,以使更改生效。
    3. 运行 gcloud init 来初始化 SDK:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. 可选。使用组件管理器安装其他组件。
Windows
  1. 下载 Cloud SDK 安装程序

    或者,打开 PowerShell 终端,然后运行以下 PowerShell 命令。

    (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
    
    & $env:Temp\GoogleCloudSDKInstaller.exe
          

  2. 启动安装程序并按提示操作。安装程序已经过 Google LLC 签名。

    如果您要启用屏幕阅读器模式,请选择启用屏幕阅读器模式 (Turn on screen reader mode) 选项,以畅享更精简的屏幕阅读器体验。如需详细了解 Cloud SDK 屏幕阅读器体验,请参阅无障碍功能指南

    Windows 中“Google Cloud SDK 安装程序”(Google Cloud SDK Setup) 的“欢迎使用”对话框,其中包含用于启用屏幕阅读器模式的复选框

  3. Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.8 版本,以及 2.7.9 或更高版本。

    安装程序将安装所有必需的依赖项(包括所需的 Python 版本)。 虽然 Cloud SDK 目前默认使用 Python 3,但您可以根据需要通过取消选中“安装捆绑的 Python”选项来使用已安装的 Python。

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

    Windows 安装程序提示

    确保选中以下选项:

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

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

  5. 默认安装不包括使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。这些组件可通过 Cloud SDK 组件管理器进行安装。
问题排查提示
  • 如果 Cloud SDK 在安装版本 274.0.0 后无法运行,请参阅此跟踪 bug,了解最新的解决方法。
  • 如果由于 find 命令未被识别而导致安装失败,请确保您的“PATH”环境变量设置为将包含“find”的文件夹(通常为 C:\WINDOWS\system32;)包括在内。
  • 如果您刚刚卸载了 Cloud SDK,则需要重新启动系统才能再次安装 Cloud SDK。

可选:安装最新的 Google Cloud 客户端库

您可以为支持的语言下载 Cloud 客户端库

初始化 Cloud SDK

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

如需初始化 Cloud 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 资源。

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

    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 命令可查看您安装的 SDK 的相关信息:

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

    gcloud auth list
    

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

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

    gcloud config list
    

    gcloud 会显示属性列表:

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. 如要查看您安装的 Cloud SDK 和活跃配置的相关信息,请执行以下操作:

    gcloud info
    

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

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

    gcloud help
    

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

    gcloud help compute instances create
    

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

后续步骤

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