安装 Google Cloud SDK

本页面包含有关下载和安装 Cloud SDK 的说明。

系统要求

Cloud SDK 可在 Linux、Mac OS X 和 Windows 上运行。它要求系统安装 Python 2.7.x,并且目前不支持 Python 3。一些与 Cloud SDK 捆绑在一起的工具还有其他要求。例如,用于 Google App Engine 开发的 Java 工具要求 Java 1.7 或更高版本。

安装选项

从下面选择一种方法安装 Cloud SDK:

  • 通过版本归档下载任何一版(包括以前的版本)
  • 运行交互式安装程序,以下载并安装最新版本
  • 使用 apt-get(仅限 Debian 和 Ubuntu)下载并安装最新版本
  • 使用 yum(Red Hat 和 CentOS)下载并安装最新版本

这些安装方法会安装默认的 Cloud SDK 组件,其中包括 gcloudgsutilbq 等命令行工具。要安装其他组件,您可以使用 gcloud components install 命令,也可以通过安装相应的 debRPM 软件包来进行安装。

版本归档

Cloud SDK 为各个版本提供可供下载的版本归档。每个版本归档都在名为 google-cloud-sdk 的目录中包含独立的 Cloud SDK 安装程序,您可以将此安装程序复制到您文件系统上的任意位置。

版本归档旨在实现特定版本 Cloud SDK 的非交互式安装,适合以下情况使用:

  • 您需要某个特定版本的 Cloud SDK。例如:

    • 您正在使用 gcloud 或其他某个 Cloud SDK 组件编写脚本,并且想确保您的脚本不会因 Cloud SDK 的更新而被破坏。
    • 您正在将 Cloud SDK 用作持续集成 (CI) 流程或生产系统的一部分,并且您希望控制依赖项,从而确保系统部件之间相互兼容。
    • 您正在向许多必须互相保持同步的机器自动部署 Cloud SDK。
    • 您使用了代理或防火墙,您需要额外配置这些组件才能访问互联网。
  • 您不想执行交互式安装。

要通过版本归档安装最新版 Cloud SDK,请执行以下操作:

  1. 下载以下软件包之一:

    平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-203.0.0-linux-x86_64.tar.gz 20.0 MB 0aa6958545a9ce7e56a161ae8e0cbcbacdf7a749845ed3e531f5a8ea2eb2aab4
    Linux 32 位

    (x86)

    google-cloud-sdk-203.0.0-linux-x86.tar.gz 19.6 MB db8de77bb284339ae6150008e06477cb4a07fea7028c78fe888909ddc4e57287
    Mac OS X 64 位

    (x86_64)

    google-cloud-sdk-203.0.0-darwin-x86_64.tar.gz 16.0 MB 791c69a721fa9b8fcf3d505987b7113d93a5dc3ee4d0458bb701df686ee91405
    Mac OS X 32 位

    (x86)

    google-cloud-sdk-203.0.0-darwin-x86.tar.gz 16.0 MB 4690a278dec04037252c520d256920572e8cb1970c6d78307eab7f415b9be0ad
    Windows 64 位

    (x86_64)

    google-cloud-sdk-203.0.0-windows-x86_64.zip 103.2 MB 3b0802a09f6f861956accd07278bce8c5db05faf6dcfbf1d1660d9f2a229bee2
    Windows 64 位

    (x86_64),捆绑了 Python

    google-cloud-sdk-203.0.0-windows-x86_64-bundled-python.zip 141.6 MB 186d6fe362288fe75e085e14d992b9e160da06b35e69b26ba3a7bcf8ef95124d
    Windows 32 位

    (x86)

    google-cloud-sdk-203.0.0-windows-x86.zip 103.4 MB 0a208e87da741db79b045ab06ef9ec60ffc098a629d40861799bd2634e615f6d
    Windows 32 位

    (x86),捆绑了 Python

    google-cloud-sdk-203.0.0-windows-x86-bundled-python.zip 137.7 MB 350c937ebb4465990887b75bc704fa60d53621d4a2e542a8847360cba30f1b05

  2. 将文件内容解压缩到文件系统上的任意位置。

  3. 可选。运行安装脚本,以将 Cloud SDK 工具添加至您的路径。运行该脚本还会生成相关说明,从而指导您在 bash shell 中启用命令补全功能(仅限 Linux 和 Mac OS),以及启用使用情况报告。

    • 在 Linux 或 Mac OS X 上:

      ./google-cloud-sdk/install.sh
      

      为了将 Cloud SDK 命令行工具添加至您的 PATH,您必须在配置文件中用 source 命令执行 /your/gcloud/filepath/path.bash.inc。 此外,请在配置文件中用 source 命令执行 /your/gcloud/filepath/completion.bash.inc,以便为 gcloud 启用 shell 命令补全功能。

    • 在 Windows 上:

      .\google-cloud-sdk\install.bat
      

    为您可以传递至该脚本的一系列标志运行 install.sh --helpinstall.bat --help

  4. 运行 gcloud init 来初始化 SDK:

    ./google-cloud-sdk/bin/gcloud init
    

先前版本

可从 Google Cloud Storage 上的下载归档中找到先前版本的 Cloud SDK。这些版本可直接在 https://storage.googleapis.com/cloud-sdk-release/<archive_name> 获取。

交互式安装程序

Cloud SDK 还为各个受支持的平台提供交互式安装程序。安装程序可让您以交互模式快速下载,安装并设置最新版本的 Cloud SDK。当您运行安装程序时,安装程序便会下载 Cloud SDK 组件,并将其安装在本地系统上。安装程序还会执行其他设置任务,例如,将 Cloud SDK 组件添加至您的 PATH 以及在您的 shell 中启用命令补全功能。

Linux
  1. 在命令提示符处输入以下内容:
    curl https://sdk.cloud.google.com | bash
  2. 重启 shell:
    exec -l $SHELL
  3. 运行 gcloud init 来初始化 gcloud 环境:
    gcloud init
Mac OS X
  1. 在命令提示符处输入以下内容:
    curl https://sdk.cloud.google.com | bash
  2. 重启 shell:
    exec -l $SHELL
  3. 运行 gcloud init 来初始化 gcloud 环境:
    gcloud init
Windows
  1. 下载 Cloud SDK 安装程序。该安装程序带有 Google Inc. 的标志。

  2. 启动安装程序并按提示操作。如果您的系统上未安装 Python 2.7.9 或更高版本的 Python 2,请确保选中安装 Bundled Python 这一选项。Cloud SDK 目前不支持 Python 3。

  3. 安装完成后,接受以下选项:

    • Start Cloud SDK Shell
    • Run gcloud init

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

  5. 默认安装不包括利用 gcloud 命令部署应用所必需的 App Engine 扩展程序。这些组件可通过 Cloud SDK 组件管理器进行安装。

注意:在运行 Windows Server 的 Google Compute Engine 实例上,Internet Explorer 启用了增强的安全配置。此设置会阻止您运行上述安装程序。请先停用“增强的安全配置”,然后重启 Internet Explorer,之后再运行安装程序。要查看有关如何在 Windows Server 实例上停用增强的安全功能的说明,请打开 Windows 帮助中心,并搜索“IE ESC”。

您也可以通过下载 .zip 文件来安装最新版本:

  1. 下载 google-cloud-sdk.zip 并解压缩。(右键点击下载的文件并选择全部提取。)

  2. 启动 google-cloud-sdk\install.bat 脚本并按照安装提示操作。

  3. 安装完成后,重新启动命令提示符 (cmd.exe)。

  4. 运行 gcloud init

    C:\> gcloud init

非交互式(静默)部署

通过将标志传递至安装程序,可以在没有任何提示的情况下部署 Cloud SDK。这样可以实现 Cloud SDK 的自动安装。

针对 Linux:

  • --disable-prompts - 停用提示。

  • --install-dir=DIRECTORY - 将安装根目录设为 DIRECTORY。Cloud SDK 将安装在 DIRECTORY/google-cloud-sdk 中。默认为 $HOME。

针对 Windows:

  • /S - 静默安装。不显示安装程序页面。可使用标志来更改安装设置。
  • /D - 设置默认安装目录。它必须是命令行中所使用的最后一个参数,且不能包含任何引号,即便路径包含空格也是如此。仅支持绝对路径,例如 /D=C:\CloudSDK
  • /allusers - 为所有用户安装
  • /singleuser - 为当前用户安装(默认)
  • /noreporting - 停用使用情况报告(默认设置为发送使用情况报告)
  • /nostartmenu - 不要创建“开始”菜单快捷方式(默认设置为创建快捷方式)
  • /nodesktop - 不要创建桌面快捷方式(默认设置为创建快捷方式)

管理安装

在通过上述任何一种方法安装 Cloud SDK 后,您可以使用 gcloud components 命令组中的命令来管理安装。这包括查看已安装的组件、添加和移除组件,以及升级到新的 Cloud SDK 版本。

如果您通过下述其中一种方法(apt-getyum)安装 Cloud SDK,则系统会禁止您通过 gcloud components 更新和移除组件。

apt-get(仅限 Debian 和 Ubuntu)

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

对于未到使用期限的所有官方 Ubuntu 版本以及从 Wheezy 开始的 Debian 稳定版本,您可以从 Debian/Ubuntu 软件包中安装 Cloud SDK。

注意:如果您使用了 Google Compute Engine 上的实例,则会默认安装 Cloud SDK。但您仍可按照以下说明手动安装 Cloud SDK。

  1. 创建环境变量,以便正确分发
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. 添加 Cloud SDK 分发 URI 作为软件包源:
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    注意:如果您已安装 apt-transport-https,则在此步骤中可以使用“https”代替“http”。
  3. 导入 Google Cloud 公钥:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    问题排查提示:如果您由于密钥过期而无法获取最新更新,请获取最新的 apt-get.gpg 密钥文件
  4. 更新并安装 Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    注意:有关其他 apt-get 选项(比如停用提示或试运行),请参阅 apt-get man 页面
  5. 可以选择安装以下任意额外组件:
    • 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-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-bigtable-emulator
    • kubectl

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

    sudo apt-get install google-cloud-sdk-app-engine-java
  6. 运行 gcloud init 以开始:
    gcloud init

yum(Red Hat 和 CentOS)

对于 Red Hat Enterprise Linux 7 和 CentOS 7 系统,可以通过软件包格式的 Cloud SDK 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutilbq 命令,而不包括 kubectl 或利用 gcloud 命令部署应用所必需的 App Engine 扩展程序,这些可以另行安装

注意:如果您使用了 Google Compute Engine 上的实例,则会默认安装 Cloud SDK。

  1. 利用 Cloud SDK 代码库信息更新 YUM:
    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
    

    重要提示gpgkey 的第二行必须如上所示进行缩进。

  2. 安装 Cloud SDK:
    yum install google-cloud-sdk
    注意:有关其他 yum 选项(比如停用提示或试运行),请参阅 yum man 页面
  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-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-pubsub-emulator
    • kubectl

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

    yum install google-cloud-sdk-app-engine-java
  4. 运行 gcloud init 以开始:
    gcloud init

卸载 Cloud SDK

要完全移除 Cloud SDK,请按照以下说明操作:

  1. 运行以下命令查找您的安装目录:

     gcloud info --format='value(installation.sdk_root)'
    

    删除此文件夹;Cloud SDK 安装程序仅将文件放入此目录。

  2. 删除用户配置目录(通常为 MacOS 和 Linux 上的 ~/.config/gcloud)。要查找此文件夹的路径,请运行以下命令:

     gcloud info --format='value(config.paths.global_config_dir)'
    
  3. 此外,请移除 .bashrc 或等效 shell init 文件中对 completion.bash.incpaths.bash.inc 执行 source 命令的命令行(如果您在安装期间添加了这些命令行)。

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Cloud SDK 文档