#为 Ceph RGW 创建 BucketClass

Ceph Object Storage 可通过 Container Object Storage Interface (COSI) 向 Kubernetes 工作负载提供服务，为大数据分析、备份与还原以及机器学习场景提供高度可扩展且弹性的存储。在用户能够配置存储桶之前，必须先创建 BucketClass。

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

#前提条件

#步骤 1 – 准备 Ceph 集群

选择以下一项：

#步骤 2 – 安装 COSI 插件

安装以下集群插件：

1. Alauda Container Platform COSI
2. Alauda Container Platform COSI Driver（之前称为 Alauda Container Platform COSI for Ceph）

有关准确的命令，请参阅 安装。

#步骤 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 能够发现该 Secret：

   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. 转到 存储 → 对象 StorageClass，然后单击创建对象 StorageClass。

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

3. 配置以下字段：

   • 删除策略 – 删除 BucketClaim 时如何处理底层存储桶（默认值：Delete）。
   • Secret – 选择在步骤 3中准备的 Secret（仅显示带有 app=rook-ceph-rgw 的 Secret）。
   • 分配项目 – *（可选）*将使用范围限制为特定项目。

4. 单击创建。

#选项 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 的对象存储。