gdcloud CLI 概览

本文档概述了 gdcloud CLI、其用途、安装工作流以及各种配置方法，以便在 Google Distributed Cloud (GDC) 气隙环境中运行时，根据您的需求进行最佳配置。

本文档面向所有使用 GDC 的受众群体，这些受众群体必须使用专用命令行界面工具来处理其气隙硬件和软件工作流程。如需了解详情，请参阅 GDC 气隙环境受众群体文档。

什么是 gdcloud CLI？

gdcloud CLI 是一套用于创建和管理 Google Distributed Cloud (GDC) 气隙资源的工具。借助这些工具，您可以通过命令行或通过脚本和自动化功能执行常见任务。

您可以使用 gdcloud CLI 引导启动基础架构、管理身份验证和自定义本地配置。

下载并安装 gdcloud CLI

如需开始使用 gdcloud CLI，请执行以下操作：

  1. 下载软件包。
  2. 安装工具。
  3. 初始化配置。

当前 gdcloud CLI 版本为 1.16。从下载归档下载并安装旧版 gdcloud CLI。

属性

gdcloud CLI 属性是可对 gdcloud CLI 工具的行为产生影响的设置。

启用无障碍功能

如需获得更精简的屏幕阅读器体验，可以使用 gdcloud CLI 附带的 accessibility/screen_reader 属性。

如需启用无障碍属性，请运行以下命令：

gdcloud config set accessibility/screen_reader true

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

配置

配置是一组 gdcloud CLI 属性。配置的工作原理类似于配置文件。

开始使用 gdcloud CLI 时，您将使用名为 default 的单个配置，并且您可以通过运行 gdcloud init 或 gdcloud config set 命令来设置属性。default 配置适用于大多数使用情形。

如需处理多个项目或组织，您可以使用 gdcloud config configurations create 设置多个配置并在这些配置之间切换。在配置中，您可以自定义属性。例如，要在有效配置中设置项目，请使用 project 属性：

gdcloud config set project PROJECT_ID

如需查看这些概念的详细说明，请参阅管理 gcloud CLI 配置。

可用的 gdcloud CLI 软件包

GDC 提供多种 gdcloud CLI 软件包选项，以支持不同的操作系统 (OS) 和下载大小。根据您的环境和角色要求选择合适的软件包。

平台 软件包名称 gdcloud 命令支持
Linux - 64 位 (x86_64) gdcloud_cli_linux_amd64_VERSION.tar.gz 所有 gdcloud 命令。
Linux Lite - 64 位 (x86_64) gdcloud_cli_linux_amd64_lite_VERSION.tar.gz 排除以下命令组：
  • gdcloud appliance
  • gdcloud system
macOS - 64 位（ARM64、Apple 芯片） gdcloud_cli_darwin_arm64_VERSION.tar.gz 排除以下命令组：
  • gdcloud appliance
  • gdcloud kms
  • gdcloud system
macOS - 64 位 (x86_64) gdcloud_cli_darwin_amd64_VERSION.tar.gz 排除以下命令组：
  • gdcloud appliance
  • gdcloud kms
  • gdcloud system
Windows - 64 位 (x86_64) gdcloud_cli_windows_amd64_VERSION.tar.gz 排除以下命令组：
  • gdcloud appliance
  • gdcloud kms
  • gdcloud system

如需详细了解所有可用的 gdcloud CLI 命令，请参阅 gdcloud CLI 参考文档。

后续步骤