#为 Ceph RGW 创建 BucketClass

通过 Container Object Storage Interface (COSI)，可以向 Kubernetes 工作负载提供 Ceph 对象存储，以支持大数据分析、备份与恢复以及机器学习等场景。用户必须先创建 BucketClass，才能预配存储桶。

BucketClass 是一种模板资源，用于指定存储驱动程序、身份验证 Secret，以及应用于通过该模板创建的每个存储桶的删除策略。

#前提条件

#步骤 1 – 准备 Ceph 集群

选择以下一项：

#步骤 2 – 安装 COSI 插件

安装以下集群插件：

1. COSI
2. COSI Driver

有关具体命令，请参阅 安装。

#步骤 3 – 准备凭证 Secret

COSI 会从 Kubernetes Secret 中获取 RGW 凭证。请根据 Ceph 部署方式选择一种方法。

#方法 A – 自动生成（Rook 管理的 Ceph）

1. 在 rook‑ceph 命名空间中创建一个 CephObjectStoreUser：

   # ceph-object-store-user.yaml
   apiVersion: ceph.rook.io/v1
   kind: CephObjectStoreUser
   metadata:
     name: user-for-cosi
     namespace: rook-ceph
   spec:
     store: object-store               # name of your CephObjectStore
     capabilities:
       bucket: ["read", "write"]
       user:   ["read", "write"]

2. 应用清单：

   kubectl apply -f ceph-object-store-user.yaml

3. 获取自动生成的 Secret 名称（后续步骤会用到）：

   kubectl get cephobjectstoreuser user-for-cosi -n rook-ceph \
     -o jsonpath='{.status.info.secretName}'

#方法 B – 手动（外部 Ceph）

1. 获取 AccessKey、SecretKey 和 RGW Endpoint。

2. 在目标项目/命名空间中创建一个 Secret，并为其添加标签，以便 UI 能够发现它：

   kubectl create secret generic ceph-external-creds -n <YOUR_NAMESPACE> \
     --from-literal=AccessKey=<YOUR_ACCESS_KEY> \
     --from-literal=SecretKey=<YOUR_SECRET_KEY> \
     --from-literal=Endpoint=http://<YOUR_RGW_ENDPOINT>
   
   kubectl label secret ceph-external-creds -n <YOUR_NAMESPACE> app=rook-ceph-rgw

   重要：平台 UI 必须使用标签 app=rook-ceph-rgw 才能列出该 Secret。

#步骤 4 – 创建 BucketClass

#选项 1 – UI 工作流

1. 前往 Storage → Object StorageClass，然后单击 Create Object StorageClass。

2. 选择 Ceph Object Storage 作为驱动程序。

3. 配置以下字段：

   • Deletion Policy – 删除 BucketClaim 时如何处理底层存储桶（默认值：Delete）。
   • Secret – 选择在步骤 3 中准备的 Secret（仅显示具有 app=rook-ceph-rgw 的 Secret）。
   • Allocate Projects – *（可选）*限制可使用该资源的项目。

4. 单击 Create。

#选项 2 – YAML（适用于 GitOps）

创建 ceph-bucketclass.yaml，并配置正确的 Secret 引用：

apiVersion: objectstorage.k8s.io/v1alpha1
kind: BucketClass
metadata:
  name: ceph-cosi-driver
  labels:
    project.cpaas.io/ALL_ALL: "true"
driverName: ceph.objectstorage.k8s.io
deletionPolicy: Delete
parameters:
  objectStoreUserSecretName: <your-secret-name>
  objectStoreUserSecretNamespace: <your-secret-namespace>

应用清单：

kubectl apply -f ceph-bucketclass.yaml

#验证与后续步骤

验证 BucketClass：

kubectl get bucketclass

BucketClass 就绪后，即可创建引用该资源的 Bucket 或 BucketClaim 资源，为应用预配兼容 S3 的对象存储。