快速入门:安装 Google Cloud CLI

安装 Google Cloud CLI

本快速入门将指导您安装和初始化 Google Cloud CLI,并运行一些核心 gcloud CLI 命令。


如需直接在 Cloud Shell 中完成此任务的分步说明,请点击操作演示

操作演示


以下部分将引导您完成与点击操作演示相同的步骤。

准备工作

  1. 登录您的 Google Cloud 帐号。如果您是 Google Cloud 新手,请创建一个帐号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
  2. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  3. 确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能

  4. 在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

    转到“项目选择器”

  5. 确保您的 Cloud 项目已启用结算功能。了解如何检查项目是否已启用结算功能

完成本教程后,您可以删除所创建的资源以避免继续计费。如需了解详情,请参阅清理

安装最新的 gcloud CLI 版本 (377.0.0)

Linux
  1. 确认您拥有受支持的 Python 版本。Google Cloud CLI 要求 Python 3(3.5 到 3.8,推荐 3.7)和 Python 2(2.7.9 或更高版本)。如需了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下内容之一:
    平台 软件包 大小 SHA256 校验和
    Linux 64 位

    (x86_64)

    google-cloud-sdk-377.0.0-linux-x86_64.tar.gz 101.7 MB 46d80d1fbf3ca52c606b5ce931f7ea77311b3c10df9e5677dae5ba9db85c0578
    Linux 64 位

    (arm)

    google-cloud-sdk-377.0.0-linux-arm.tar.gz 98.6 MB 42dd29714b052d3460b005b3d09faacdb0818e70edd60c20d447a1594fd6aa83
    Linux 32 位

    (x86)

    google-cloud-sdk-377.0.0-linux-x86.tar.gz 98.5 MB ee70208bb29d0d0cbed500fc93c5b77095d00bfac9c00688593d0cec666586b2

    或者,如需下载 Linux 64 位归档文件,请在命令行中运行以下命令:

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

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

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

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

    curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-377.0.0-linux-x86.tar.gz
  3. 将文件内容提取到文件系统上的任意位置(最好是主目录)。如需替换现有安装,请移除现有的 google-cloud-sdk 目录,然后将归档解压缩到同一位置。
    tar -xf google-cloud-sdk-377.0.0-linux-x86.tar.gz
  4. 如果您想发送匿名使用情况统计信息以帮助改进 gcloud CLI,请在出现提示时回答 Y
  5. 如需将 gcloud CLI 添加到您的 PATH 并启用命令补全功能,请在出现提示时回答 Y
  6. 可选。使用安装脚本将 gcloud CLI 工具添加到您的 PATH。您还可以选择为您的 shell 启用命令补全功能以及选择启用使用情况统计信息收集功能

    使用以下命令运行脚本(从解压缩到的文件夹的根目录运行):

    ./google-cloud-sdk/install.sh
    
    也可以通过提供偏好设置作为标志以非交互方式(例如使用脚本)完成此操作。相关说明,请参阅:
    ./google-cloud-sdk/install.sh --help
    
    打开新终端,以使更改生效。
  7. 如需初始化 gcloud CLI,请运行 gcloud init
  8. ./google-cloud-sdk/bin/gcloud init
    
  9. 可选。使用组件管理器安装其他组件。
Debian/Ubuntu

软件包内容

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

准备工作

在安装 gcloud CLI 之前,请确保您的操作系统满足以下要求:

安装
  1. 添加 gcloud CLI 发行版 URI 作为软件包源。如果您的发行版支持 signed-by 选项,请运行以下命令:
    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

    如果您的发行不支持 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
  2. 导入 Google Cloud 公钥。 如果您的发行版的 apt-key 命令支持 --keyring 参数,请运行以下命令:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

    如果您的发行版的 apt-key 命令不支持 --keyring 参数,请运行以下命令:

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

    如果您的发行版(Debian 11+ 或 Ubuntu 21.10+)不支持 apt-key,请运行以下命令:

    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.gpg

    如果您由于密钥过期而无法获取最新更新,请获取最新的 apt-get.gpg 密钥文件

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

    Docker 提示:如果安装 Docker 映像中的 gcloud CLI,请改用单个 RUN 步骤:

    RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://packages.cloud.google.com/apt cloud-cli 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-cli -y
          
    如果不支持 apt-key 命令:
    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 | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -y
          
  4. (可选)安装以下任何其他组件
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datalab
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

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

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

降级 gcloud CLI 版本

如需还原到特定版本的 gcloud CLI(其中 VERSION123.0.0 形式),请运行以下命令:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

代码库中始终提供最新的十个版本。

注意:对于 371.0.0 之前的版本,该软件包名称为 google-cloud-sdk

Red Hat/Fedora/CentOS

软件包内容

对于 Red Hat Enterprise Linux 7、Red Hat Enterprise Linux 8、Fedora 33、Fedora 34、CentOS 7 和 Centos 8 系统,可以通过软件包格式的 gcloud CLI 进行安装。此软件包仅包含 gcloudgcloud alphagcloud betagsutilbq 命令,而不包括 kubectl 或使用 gcloud 命令部署应用所需的 App Engine 扩展程序,您可以按照本部分稍后所述的方法单独安装。

安装
  1. 使用 gcloud CLI 代码库信息更新 DNF。以下示例命令适用于与 Red Hat Enterprise Linux 8 兼容的安装。对于与 Red Hat Enterprise Linux 7 兼容的安装,请将 baseUrl 值中的 el8 替换为 el7
    sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
    [google-cloud-cli]
    name=Google Cloud CLI
    baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el8-x86_64
    enabled=1
    gpgcheck=1
    repo_gpgcheck=0
    gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
           https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
    EOM
    
  2. 如果您要在 Fedora 35 上安装,请安装 libcrypt-compat.x86_64
    sudo dnf install libxcrypt-compat.x86_64
  3. 安装 gcloud CLI:
    sudo dnf install google-cloud-cli
  4. (可选)安装以下任何其他组件
    • google-cloud-cli
    • google-cloud-cli-anthos-auth
    • google-cloud-cli-app-engine-go
    • google-cloud-cli-app-engine-grpc
    • google-cloud-cli-app-engine-java
    • google-cloud-cli-app-engine-python
    • google-cloud-cli-app-engine-python-extras
    • google-cloud-cli-bigtable-emulator
    • google-cloud-cli-cbt
    • google-cloud-cli-cloud-build-local
    • google-cloud-cli-cloud-run-proxy
    • google-cloud-cli-config-connector
    • google-cloud-cli-datalab
    • google-cloud-cli-datastore-emulator
    • google-cloud-cli-firestore-emulator
    • google-cloud-cli-gke-gcloud-auth-plugin
    • google-cloud-cli-kpt
    • google-cloud-cli-kubectl-oidc
    • google-cloud-cli-local-extract
    • google-cloud-cli-minikube
    • google-cloud-cli-nomos
    • google-cloud-cli-pubsub-emulator
    • google-cloud-cli-skaffold
    • google-cloud-cli-spanner-emulator
    • google-cloud-cli-terraform-validator
    • google-cloud-cli-tests
    • kubectl

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

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

降级 gcloud CLI 版本

如果您想还原到特定版本的 gcloud CLI(其中 VERSION 的格式为 123.0.0),请运行 sudo dnf downgrade google-cloud-cli-VERSION。代码库中始终提供最新的十个版本。注意:对于 371.0.0 之前的版本,该软件包名称为 google-cloud-sdk

macOS
  1. 确认您拥有受支持的 Python 版本:
    • 受支持的版本是 Python 3(3.5 到 3.8,推荐 3.7)和 Python 2(2.7.9 或更高版本)。
    • 现代版本的 macOS 包含 Cloud SDK 所需的适当版本的 Python。 如需查看当前的 Python 版本,请运行 python -V
    • 对于 Cloud SDK 发布版本 352.0.0 及更高版本,主安装脚本允许在基于 Intel 的 Mac 上安装 CPython 的 Python 3.7。
    • 如需详细了解如何选择和配置 Python 解释器,请参阅 gcloud topic startup
  2. 下载以下内容之一:
  3. 平台 软件包 大小 SHA256 校验和
    macOS 64 位

    (x86_64)

    google-cloud-sdk-377.0.0-darwin-x86_64.tar.gz 102.0 MB 1175bfb9040dbc90e9f9efbb87064b3f8e7894b273a7c7eae7fa59fcb1b668c4
    macOS 64 位

    (arm64、Apple M1 silicon)

    google-cloud-sdk-377.0.0-darwin-arm.tar.gz 101.4 MB 7cf3421fb88d66b263964de6eb76aebfb39c93ab674109dbad3c8fa5f189d4c1
    macOS 32 位

    (x86)

    google-cloud-sdk-377.0.0-darwin-x86.tar.gz 106.7 MB b9ac993dbb3685e1d3022638a3585af1ab596a0b5ffd29026a8c854e1395d1aa

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

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

    2. (可选)使用安装脚本将 gcloud CLI 工具添加到您的 PATH。您还可以选择为 shell 启用命令补全功能、使用情况统计信息收集功能,并安装 Python 3.7。

      使用以下命令运行脚本(从您在上一步中解压缩的文件夹的根目录运行):

      ./google-cloud-sdk/install.sh
      
      也可以通过提供偏好设置作为标志以非交互方式(例如使用脚本)完成此操作。如需描述可用标志,请运行以下命令:
      ./google-cloud-sdk/install.sh --help
      
      如需在开启屏幕阅读器模式的情况下运行安装脚本,请运行以下命令:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      打开新终端,以使更改生效。
    3. 如需初始化 gcloud CLI,请运行 gcloud init
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. 可选。使用组件管理器安装其他组件。
Windows
    Google Cloud CLI 可以在 Windows 8.1 及更高版本和 Windows Server 2012 及更高版本上使用。
  1. 下载 Google Cloud CLI 安装程序

    或者,打开 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 签名。

    如果您使用的是屏幕阅读器,请选中启用屏幕阅读器模式复选框。此选项会将 gcloud 配置为使用状态跟踪器而不是 Unicode 旋转图标,以百分比表示显示进度和展开的表。如需了解详情,请参阅无障碍功能指南

  3. Cloud SDK 要求安装 Python;支持的版本是 Python 3(首选,3.5 到 3.8)和 Python 2(2.7.9 或更高版本)。默认情况下,Windows 版本的 Cloud SDK 附带 Python 3 和 Python 2。如需使用 Cloud SDK,您的操作系统必须能够运行受支持的 Python 版本。

    安装程序会安装所有必需的依赖项(包括所需的 Python 版本)。虽然 Cloud SDK 默认安装和管理 Python 3,但您可以根据需要使用已安装的 Python,只需取消选中“安装捆绑的 Python”选项即可。请参阅 gcloud topic startup,了解如何使用现有 Python 安装。

  4. 安装完成后,安装程序会为您提供创建开始菜单和桌面快捷方式、启动 Google Cloud CLI shell 以及配置 gcloud CLI 的选项。确保已选择用于启动 shell 并配置安装的选项。安装程序会启动终端窗口并运行 gcloud init 命令。

  5. 默认安装不包括使用 gcloud 命令部署应用所必需的 App Engine 扩展程序。您可以使用 gcloud CLI 组件管理器安装这些组件。
问题排查提示
  • 如果由于 find 命令未被识别而导致安装失败,请确保您的 PATH 环境变量设置为将包含 find 的文件夹包括在内。通常,此文件夹为 C:\WINDOWS\system32;
  • 如果您卸载了 gcloud CLI,则必须先重新启动系统,然后才能再次安装 gcloud CLI。
  • 如果解压缩失败,请以管理员身份运行安装程序。

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

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

初始化 gcloud CLI

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

  1. 初始化 gcloud CLI:

    gcloud init
    

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

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

  4. 在命令提示符处,从您拥有 OwnerEditorViewer 权限的项目列表中选择一个 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. 如果您启用了 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. (可选)如需提升屏幕阅读器体验,请启用 accessibility/screen_reader 属性:

    gcloud config set accessibility/screen_reader true
    

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

运行核心命令

运行核心命令以查看有关 gcloud CLI 安装的信息:

  1. 列出其凭据存储在本地系统上的帐号:

    gcloud auth list
    

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

    Credentialed Accounts
    ACTIVE             ACCOUNT
    *                  example-user-1@gmail.com
                       example-user-2@gmail.com
    
  2. 列出活跃 gcloud CLI 配置中的属性:

    gcloud config list
    

    gcloud CLI 会显示属性列表:

    [core]
    account = example-user-1@gmail.com
    disable_usage_reporting = False
    project = example-project
    
  3. 查看有关 gcloud CLI 安装和活动配置的信息:

    gcloud info
    

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

  4. 查看有关 gcloud 命令和其他主题的信息:

    gcloud help
    

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

    gcloud help compute instances create
    

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

清理

为避免因本页中使用的资源导致您的 Google Cloud 帐号产生费用,请按照以下步骤操作。

  1. 在 Cloud Console 中,转到管理资源页面。

    转到“管理资源”

  2. 在项目列表中,选择要删除的项目,然后点击删除
  3. 在对话框中输入项目 ID,然后点击关闭以删除项目。

后续步骤

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