Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

为项目安装并配置存储 CLI

本页面将引导您完成以下操作：安装和配置 gdcloud CLI，以便在处理 Google Distributed Cloud (GDC) 空气隔离项目时管理对象存储。本指南介绍了如何下载、安装和配置必要的组件和设置，这些组件和设置对于在此隔离环境中有效使用存储桶和对象至关重要。

本页面面向基础设施运维人员群组中的 IT 管理员或应用运维人员群组中的开发者等受众群体，他们希望在 GDC 网闸隔离配置环境中为项目预配和管理对象存储桶。如需了解详情，请参阅 GDC 气隙环境文档的受众群体。

准备工作

如需安装和配置存储 CLI，请与组织 IAM 管理员联系，请求授予 Org Network Policy Admin (org-network-policy-admin) 角色，以便您创建、修改和删除组织网络政策。

下载 gdcloud CLI

按照说明下载 gdcloud CLI。

安装 gdcloud CLI

如需使用存储命令树，必须安装存储依赖项组件。

按照安装 gcloud CLI 中的说明操作。
如需安装存储依赖项组件，请运行以下命令：
```
gdcloud components install storage-cli-dependencies
```
如需详细了解 components install 命令，请参阅安装 gdcloud CLI。

为对象存储配置 gdcloud CLI

必须设置以下配置才能使用 gdcloud CLI 进行对象存储。

将 ACCESS_KEY_ID 替换为从获取访问凭据中的密钥获取的访问密钥 ID：
```
gdcloud config set storage/s3_access_key_id ACCESS_KEY_ID
```
将 SECRET_ACCESS_KEY 替换为从获取访问凭据中的密钥获取的密钥：
```
gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEY
```
将 CA_BUNDLE_FILE 替换为 CA 证书的路径。这是属于证书授权机构 (CA) 的数字证书，CA 是一家可信赖的身份验证组织。您可以向基础架构运维者 (IO) 群组的成员请求 GDC CA 信任软件包。如需详细了解如何获取 GDC CA 证书，请参阅提取 GDC 信任软件包。
```
gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILE
```
注意：如果已在环境中安装 GDC 的 CA 证书，则可将此值设置为 /etc/ssl/certs/ca-certificates.crt
将 ENDPOINT 替换为您的基础设施运营商 (IO) 提供的端点：
```
gdcloud config set storage/s3_endpoint ENDPOINT
```
注意：这是以 https:// 开头的完整端点。

对于双地区存储桶，此步骤略有不同。每个双区域存储桶都提供三个端点，您可以选择其中一个来访问存储桶。在大多数情况下，为了利用自动故障切换功能，全球端点是合适的选择：
- Zone1 端点：此端点始终由 zone1 接收。如果使用此端点，则对于写入 zone1 的任何对象，您都具有写后读一致性。不过，如果 zone1 出现故障，客户端需要改为使用 zone2 或全球端点，才能继续读取/写入此存储桶。如果客户端来自用户集群，则只能从可用区 1 内访问此端点。
- Zone2 端点：此端点始终由 Zone2 接收。如果使用此端点，则对于写入到区域 2 的任何对象，您都具有写后读一致性。不过，如果 zone2 出现故障，客户端需要改为使用 zone1 或全球端点，才能继续读取/写入此存储桶。如果客户端来自用户集群，则只能从 zone2 内访问此端点。
- 全球端点：此端点会将您的请求路由到可用区 1 或可用区 2。此选项不提供会话亲和性，这意味着使用同一会话发出的请求可能会到达可用区 1 或可用区 2。这意味着，对于向全球端点发出的请求，无法保证读后写。如果某个可用区出现故障，全球端点可提供自动故障切换，因此用户无需像使用可用区端点时那样更改工作负载中的端点。此外，此端点可从所有可用区中的用户集群访问。
针对管理 API 服务器运行以下命令，以查看存储桶的全局端点和区域端点，然后选择要使用的端点：
```
kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.globalEndpoint}" --kubeconfig MANAGEMENT_API_SERVER

kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.zonalEndpoints}" --kubeconfig MANAGEMENT_API_SERVER
```