macOS 快速入门

本页面介绍了如何安装 Google Cloud SDK、如何对 SDK 执行初始化,以及如何从命令行运行核心 gcloud 命令。

准备工作

  1. 创建一个 Google Cloud Platform 项目(如果您还没有此项目)。

  2. 确保您的系统上安装了 Python 2.7:

    python -V
    
  3. 下载最适合您的操作系统的归档文件。大多数机器都可运行 64 位软件包。

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

    (x86_64)

    google-cloud-sdk-245.0.0-darwin-x86_64.tar.gz 19.6 MB 78cbe75ebf17599217d4a6cb81897897faa72d6e5e0c515a8532c8827de59af7
    macOS 32 位

    (x86)

    google-cloud-sdk-245.0.0-darwin-x86.tar.gz 19.6 MB 3ca3575f19a21a589a75d2ed3c2a62af7d1be12482ad4cf3efba87e071977a61
  4. 将归档解压缩到文件系统上的任意位置;最好是解压缩到您的主目录。在 macOS 中,可通过打开下载到首选位置的 .tar.gz 归档文件来实现此目的。

  5. 可选:如果您在使用 gcloud 命令时遇到问题,请确保您已正确定义 $PATH。使用安装脚本将 Cloud SDK 工具添加至您的路径。您还可以在安装过程中选择为 bash shell 开启命令补全功能以及选择启用使用情况统计信息收集功能。使用以下命令运行脚本:

    ./google-cloud-sdk/install.sh
    

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

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

初始化 SDK

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

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

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

    gcloud init
    

    注意:要防止此命令启动网络浏览器,请改用 gcloud init --console-only。要在不使用网络浏览器的情况下通过非互动的方式进行授权,请使用 Google Cloud Platform Console 创建具有适当权限范围的服务帐号,并搭配使用 gcloud auth activate-service-account 和相应的 JSON 密钥文件。

  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 会为您选择该项目。

  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]
    

运行核心 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 命令的相关详情页面,包括说明、标志和示例。
  • 使用 kubectl安装其他组件,例如 App Engine 模拟器或 kubectl
此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Cloud SDK 文档