对象存储容器挂载 CSI

摘要

在云原生架构中,容器化应用需要持久化存储来保存数据。腾讯云 COS-CSI 插件让 Kubernetes 集群可以像使用本地存储一样挂载对象存储 COS,实现弹性、高可用的容器持久化存储。本文介绍 COS-CSI 的安装配置、使用方法和最佳实践。

一、COS-CSI 简介

COS-CSI 是腾讯云容器服务 TKE 提供的 CSI(Container Storage Interface)插件,用于在 Kubernetes 集群中挂载对象存储 COS 作为持久化存储。

COS-CSI 支持两种挂载方式:

• COSFS 挂载:通过 COSFS 工具将 COS 存储桶挂载为文件系统,支持 POSIX 文件语义。
• GooseFS-Lite 挂载:通过 GooseFS 轻量客户端实现热挂载,适合大数据和 AI 场景。

COS-CSI 组件当前最新版本为 v1.0.12(2026 年 3 月发布),支持 Kubernetes 1.18 及以上版本。

二、安装 COS-CSI 组件

2.1 在 TKE 控制台安装

在 TKE 集群的组件管理页面,找到 COS-CSI 组件并单击安装。系统会自动完成 DaemonSet 和 CSI Driver 的部署。

2.2 通过 Helm 安装

helm repo add tencentcloud https://charts.tencentcloud.com
helm install cos-csi tencentcloud/cos-csi

三、创建 StorageClass 和 PVC

安装完成后,需要创建 StorageClass 和 PersistentVolumeClaim(PVC)来使用 COS 存储。

3.1 创建 StorageClass

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: cos-sc
provisioner: com.tencent.cloud.csi.cos
parameters:
  bucket: examplebucket-1250000000
  region: ap-guangzhou
  # 其他参数

3.2 创建 PVC

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: cos-pvc
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: cos-sc
  resources:
    requests:
      storage: 100Gi

3.3 在 Pod 中使用 PVC

apiVersion: v1
kind: Pod
metadata:
  name: cos-app
spec:
  containers:
  - name: app
    image: nginx
    volumeMounts:
    - name: cos-storage
      mountPath: /data
  volumes:
  - name: cos-storage
    persistentVolumeClaim:
      claimName: cos-pvc

四、挂载选项说明

COS-CSI 支持丰富的挂载选项,可以根据业务需求进行调优:

五、使用场景

5.1 静态网站托管

将 COS 挂载到容器中,作为静态网站的存储后端,实现多副本共享同一存储。

5.2 日志收集

多个 Pod 同时写入同一 COS 存储桶,统一收集应用日志,配合日志分析工具进行集中处理。

5.3 AI 训练数据

在分布式训练场景中,多个 Worker 节点通过 COS-CSI 挂载同一数据集,实现数据共享。

六、注意事项

• COS-CSI 升级时,如果 cosfs 托管方式为 Pod,需要先将 DaemonSet 更新策略设为 OnDelete,逐个节点迁移。
• 托管方式为 CVM 或使用 GooseFS-Lite 时,升级不会影响已有业务。
• 建议在业务低峰期进行组件升级操作。

腾讯云对象存储 COS 通过 COS-CSI 组件,为容器化应用提供了灵活、可扩展的持久化存储方案,是云原生架构下存储基础设施建设的重要组件。

了解更多关于腾讯云对象存储 COS 的产品信息,请访问 腾讯云对象存储 COS 产品页。