tencent cloud

文档反馈

PV 和 PVC 管理云硬盘

最后更新时间:2023-05-06 19:41:07

    操作场景

    腾讯云容器服务 TKE 支持通过创建 PV/PVC,并在创建工作负载添加数据卷时使用已有 PVC,实现通过 PV 和 PVC 管理云硬盘。本文介绍如何通过控制台、Kubectl 两种方式实现 PV 和 PVC 管理云硬盘。
    注意
    云硬盘不支持跨可用区挂载。若挂载云硬盘类型 PV 的 Pod 迁移至其他可用区,将会导致挂载失败。
    容器服务控制台不支持云硬盘扩容,可前往 云硬盘控制台 进行扩容操作。详情请参见 扩容云硬盘

    操作步骤

    控制台操作指引

    通过控制台创建 StorageClass

    由于静态创建云硬盘类型的 PV 时,需要绑定同类型可用 StorageClass,请参考 创建 StorageClass 完成创建。

    静态创建 PV

    说明
    静态创建 PV 适用于已有存量云盘,并在集群内使用的场景。
    1. 登录容器服务控制台,选择左侧导航栏中的 集群
    2. 选择需创建 PV 的集群 ID,进入该集群详情页面。
    3. 选择左侧菜单栏中的存储 > PersistentVolume,进入 “PersistentVolume” 页面。如下图所示:
    
    4. 选择新建进入“新建PersistentVolume” 页面,参考以下信息进行创建。如下图所示:
    
    主要参数信息如下:
    来源设置:选择静态创建
    名称:自定义,本文以 cbs-pv 为例。
    Provisioner:选择云硬盘CBS
    读写权限:云硬盘仅支持单机读写。
    StorageClass:按需选择合适的 StorageClass。本文以选择在 通过控制台创建 StorageClass 步骤中创建的 cbs-test 为例。
    说明
    PVC 和 PV 会绑定在同一个 StorageClass 下。
    不指定意味着该 PV 对应的 StorageClass 取值为空,对应 YAML 文件中的 storageClassName 字段取值为空字符串。
    云盘:选择已经创建好的云硬盘。
    文件系统:默认为 ext4。
    5. 单击创建PersistentVolume即可完成创建。

    创建 PVC

    1. 在集群详情页,选择左侧菜单栏中的存储 > PersistentVolumeClaim,进入 “PersistentVolumeClaim” 页面。如下图所示:
    
    2. 选择新建进入 “新建PersistentVolumeClaim” 页面,参考以下信息进行创建。如下图所示:
    
    主要参数信息如下:
    名称:自定义,本文以 cbs-pvc 为例。
    命名空间:选择 “default”。
    Provisioner:选择云硬盘CBS
    读写权限:云硬盘只支持单机读写。
    StorageClass:按需选择合适的 StorageClass。本文以选择在 通过控制台创建 StorageClass 步骤中创建的 cbs-test 为例。
    说明
    PVC 和 PV 会绑定在同一个 StorageClass 下。
    不指定意味着该 PVC 对应的 StorageClass 取值为空,对应 YAML 文件中的 storageClassName 字段取值为空字符串。
    PersistVolume:按需指定 PersistentVolume,本文选择以在 静态创建PV 步骤中创建的 cbs-pv 为例。
    说明
    只有与指定的 StorageClass 相同并且状态为 Available 和 Released 的 PV 为可选状态,如果当前集群内没有满足条件的 PV 可选,请选择“不指定”PersistVolume。
    如果选择的 PV 状态为 Released,还需手动删除该 PV 对应 YAML 配置文件中的 claimRef 字段,该 PV 才能顺利与 PVC 绑定。详情请参见 查看 PV 和 PVC 的绑定规则
    3. 单击创建PersistentVolumeClaim,即可完成创建。

    创建 Workload 使用 PVC 数据卷

    说明
    该步骤以创建工作负载 Deployment 为例。
    1. 在“集群管理”页面,选择目标集群 ID,进入待部署 Workload 的集群的 “Deployment” 页面。
    2. 单击新建,进入“新建Workload” 页面,参考 创建 Deployment 进行创建,并参考以下信息进行数据卷挂载。如下图所示:
    
    数据卷(选填)
    挂载方式:选择“使用已有PVC”。
    数据卷名称:自定义,本文以 cbs-vol 为例。
    选择 PVC:选择在步骤 创建 PVC 中已创建的 “cbs-pvc”。
    实例内容器:单击添加挂载点,进行挂载点设置。
    数据卷:选择该步骤中已添加的数据卷 “cbs-vol”。
    目标路径:填写目标路径,本文以 /cache 为例。
    挂载子路径:仅挂载选中数据卷中的子路径或单一文件。例如,/data/test.txt
    3. 单击创建Workload即可完成创建。
    注意
    如使用 CBS 的 PVC 挂载模式,则数据卷只能挂载到一台 Node 主机上。

    Kubectl 操作指引

    您可通过以下 YAML 示例文件,使用 Kubectl 进行创建操作。

    (可选)创建 PV

    可以通过已有云硬盘创建 PV,也可以直接 创建 PVC ,系统将自动创建对应的 PV。YAML 文件示例如下:
    apiVersion: v1
    kind: PersistentVolume
    metadata:
    name: cbs-test
    spec:
    accessModes:
    - ReadWriteOnce
    capacity:
    storage: 10Gi
    csi:
    driver: com.tencent.cloud.csi.cbs
    fsType: ext4
    readOnly: false
    volumeHandle: disk-xxx # 指定已有的CBS id
    storageClassName: cbs

    创建 PVC

    若未 创建 PV,则在创建 PVC 时,系统将自动创建对应的 PV。YAML 文件示例如下:
    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
    name: nginx-pv-claim
    spec:
    storageClassName: cbs
    accessModes:
    - ReadWriteOnce
    resources:
    requests:
    storage: 10Gi
    云硬盘大小必须为10的倍数。
    高性能云硬盘最小为10GB,SSD 和增强型 SSD 云硬盘最小为20GB,详情见 创建云硬盘

    使用 PVC

    可通过创建 Workload 使用 PVC 数据卷。YAML 示例如下:
    apiVersion: extensions/v1beta1
    kind: Deployment
    metadata:
    name: nginx-deployment
    spec:
    replicas: 1
    selector:
    matchLabels:
    qcloud-app: nginx-deployment
    template:
    metadata:
    labels:
    qcloud-app: nginx-deployment
    spec:
    containers:
    - image: nginx
    imagePullPolicy: Always
    name: nginx
    volumeMounts:
    - mountPath: "/opt/"
    name: pvc-test
    volumes:
    - name: pvc-test
    persistentVolumeClaim:
    claimName: nginx-pv-claim # 已经创建好的 PVC
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持