Linux 快速入门

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

准备工作

  1. 创建一个 Google Cloud 项目（如果您还没有的话）。

  2. Cloud SDK 要求安装 Python。受支持的版本有 3.5 到 3.7 版本，以及 2.7.9 或更高版本。如需检查系统上安装的 Python 版本，请执行以下操作：

    python -V

  3. 下载最适合您的操作系统的归档文件。 大多数机器都可运行 64 位软件包。如果您想检查确认，请运行 uname -m 以验证您是否运行 64 位系统。

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

    (x86_64)

    		 google-cloud-sdk-308.0.0-linux-x86_64.tar.gz 85.2 MB 9e8e31d9503340fc912374311ac1fffbfc5b59748d20b681f9aca3de2b68deb5
    Linux 32 位

    (x86)

    		 google-cloud-sdk-308.0.0-linux-x86.tar.gz 83.4 MB 35f53087034296e9e0275e0e07cded6b9ae20a1535c07a96b6f00dc9bdaecc09

    或者，要通过命令行下载 Linux 64 位归档文件，请运行以下命令：

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

    对于 32 位归档文件，请运行以下命令：

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

  4. 将归档解压缩到文件系统上的任意位置；最好是解压缩到您的主文件夹。在 Linux 中，您可以通过运行以下命令来解压缩归档文件：

    tar zxvf [ARCHIVE_FILE] google-cloud-sdk

  5. 可选：使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以在安装过程中选择为您的 bash shell 启用命令补全功能以及选择开启 使用情况统计信息收集功能。使用以下命令运行脚本：

    ./google-cloud-sdk/install.sh

    重新启动终端以使更改生效。

    或者，在解压缩下载的归档文件后，您可以通过完整路径来调用 Cloud SDK 的可执行文件，从而调用该 SDK。

初始化 SDK

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

要初始化 SDK，请执行以下操作：

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

    gcloud init

    问题排查提示：如果遇到与未找到的 gcloud 命令相关的错误，请运行./google-cloud-sdk/install.sh 以使用安装脚本；它会将 Cloud SDK 工具添加到 PATH。重启终端以使更改生效。

  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 命令

运行以下 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 上执行各项任务的每个 gcloud 命令的相关详情页面，其中包括说明、标志和示例。
  • 如需查看常用命令和关键概念的列表，请参阅 gcloud 命令行工具备忘单。
  • 使用 Cloud SDK 组件管理器 安装其他组件，例如 App Engine 模拟器或 kubectl。