LVの使用 - Container Service for Kubernetes - Alibaba Cloud ドキュメントセンター

ボリュームグループ (VGs) を使用してディスクを仮想化した後、Logical volume Manager (LVM) を使用してVGsを論理ボリューム (LV) に分割し、LVをポッドにマウントできます。このトピックでは、LVの使用方法について説明します。

背景情報

ポッドがノードのストレージを使用できるようにするには、hostPathボリュームまたはローカルボリュームを使用できます。ただし、hostPathボリュームとローカルボリュームには次の制限があります。

Kubernetesは、hostPathボリュームとローカルボリュームのライフサイクルを管理しません。ボリュームを手動で管理および維持する必要があります。
複数のポッドが同じローカルストレージを使用する場合、これらのポッドは同じディレクトリを共有するか、各ポッドはサブディレクトリを使用します。その結果、これらのポッド間でストレージ分離を実装することはできません。
複数のポッドが同じローカルストレージを使用する場合、各ポッドの1秒あたりの入力 /出力操作 (IOPS) とスループットはストレージ全体のものと等しくなります。各ポッドのIOPSとスループットを制限することはできません。
ローカルストレージを使用するポッドを作成する場合、各ノードで使用可能なストレージは不明です。その結果、ノードにマウントされたボリュームを適切にスケジューリングすることができない。

Container Service for Kubernetes (ACK) は、LVを使用して上記の問題を解決します。

概要

LVのライフサイクル管理: 自動作成、削除、マウント、およびマウント解除。
LVの拡張。
LVのモニタリング。
LVsのIOPS制限。
VGsの自動操作とメンテナンス。これにより、ノードのローカルストレージを管理できます。
LVを使用するクラスターのストレージ使用状況のモニタリング。

使用上の注意

LVは移行できません。したがって、LVは高可用性シナリオには適していません。
LVを使用するクラスターのストレージ使用量モニタリングは、現在のバージョンではサポートされていません。 VGを初期化するには、ローカルストレージリソースを手動で初期化するか、ローカルストレージリソースの自動初期化を設定する必要があります。どちらの方法でも、ローカルストレージリソースの知識が必要です。それ以外の場合は、Container Network file System (CNFS) によって管理されるディスクやファイルシステムなどのクラウドストレージリソースを使用することを推奨します。

アーキテクチャ

ライフサイクル管理、拡張、マウント、フォーマットなどのLVの基本機能は、CSI-ProvisionerとCSI-Pluginによって実装されます。

項目	説明
ストレージマネージャ	このコンポーネントは、VGの運用および保守を管理し、LVのストレージ使用を監視するために使用されます。ワーカーノードを設定して、VGを管理および維持することもできます。
カスタムリソース定義	このコンポーネントは、ストレージ容量やVGなど、ワーカーノードのローカルストレージ情報を保存するために使用されます。
LVスケジューラ	このコンポーネントは、永続ボリュームクレーム (PVC) を作成し、LVを使用するクラスターのストレージ使用量を監視するために使用されます。

ステップ1: CSI-PluginとCSI-ProvisionerにRBAC権限を付与して秘密を管理する

Kubernetes 1.20以前を実行するクラスター

同じServiceAccountをCSIプラグインと共有します。シークレットを管理するには、clusterrole/alicloud-csi-pluginにロールベースのアクセス制御 (RBAC) 権限を付与する必要があります。

次のコマンドを実行して、clusterrole/alicloud-csi-pluginにcreate Secretsの権限があるかどうかを確認します。

echo `JSONPATH='{range .rules[*]}{@.resources}:{@.verbs} \r\n
{end}' \
 && kubectl get clusterrole  alicloud-csi-plugin -o jsonpath="$JSONPATH";` | grep secrets

期待される出力:

["secrets"]:["get","list"]

clusterrole/alicloud-csi-pluginにcreate Secretsの権限がない場合は、次のコマンドを実行して権限を付与します。

kubectl patch clusterrole alicloud-csi-plugin -- type='json' -p='[{"op": "add", "path": "/rules/0", "value":{ "apiGroups": [""], "resources": ["secrets"], "verbs": ["create"]}}]'

期待される出力:

clusterrole.rbac.authorization.k8s.io/alicloud-csi-plugin patched

次のコマンドを実行して、clusterrole/alicloud-csi-pluginにcreate Secretsの権限があるかどうかを確認します。
```
echo `JSONPATH='{range .rules[*]}{@.resources}:{@.verbs} \r\n
{end}' \
 && kubectl get clusterrole  alicloud-csi-plugin -o jsonpath="$JSONPATH";` | grep secrets
```
期待される出力:
```
["secrets"]:["create"] 
["secrets"]:["get","list"]
```
出力は、clusterrole/alicloud-csi-pluginに作成する権限があることを示しています。

Kubernetes 1.22以降を実行するクラスター

次のYAMLコンテンツを使用して、ServiceAccountを作成し、権限を付与します。

---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: alibaba-cloud-csi-local
  namespace: kube-system
---
kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: alibaba-cloud-csi-local
rules:
  - apiGroups: [""]
    resources: ["persistentvolumes"]
    verbs: ["get", "list", "watch", "update", "create", "delete", "patch"]
  - apiGroups: [""]
    resources: ["persistentvolumeclaims"]
    verbs: ["get", "list", "watch", "update"]
  - apiGroups: [""]
    resources: ["persistentvolumeclaims/status"]
    verbs: ["get", "list", "watch", "update", "patch"]
  - apiGroups: ["storage.k8s.io"]
    resources: ["storageclasses"]
    verbs: ["get", "list", "watch"]
  - apiGroups: ["storage.k8s.io"]
    resources: ["csinodes"]
    verbs: ["get", "list", "watch"]
  - apiGroups: [""]
    resources: ["events"]
    verbs: ["get", "list", "watch", "create", "update", "patch"]
  - apiGroups: [""]
    resources: ["nodes"]
    verbs: ["get", "update", "patch", "list", "watch"]
  - apiGroups: ["storage.k8s.io"]
    resources: ["volumeattachments"]
    verbs: ["get", "list", "watch", "update", "patch"]
  - apiGroups: ["coordination.k8s.io"]
    resources: ["leases"]
    verbs: ["get", "create", "list", "watch", "delete", "update"]
  - apiGroups: ["storage.k8s.io"]
    resources: ["volumeattachments/status"]
    verbs: ["patch"]
  - apiGroups: ["storage.k8s.io"]
    resources: ["storageclasses"]
    verbs: ["get", "list", "watch"]
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: alibaba-cloud-csi-local
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: alibaba-cloud-csi-local
subjects:
- kind: ServiceAccount
  name: alibaba-cloud-csi-local
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  name: alibaba-cloud-csi-local
  namespace: kube-system
rules:
- apiGroups: [""]
  resources: ["secrets"]
  resourceNames: ["csi-local-plugin-cert"]
  verbs: ["get"]
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["create"]
- apiGroups: [""]
  resources: ["configmaps"]
  resourceNames: ["csi-plugin", "ack-cluster-profile"]
  verbs: ["get"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: alibaba-cloud-csi-local
  namespace: kube-system
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: alibaba-cloud-csi-local
subjects:
- kind: ServiceAccount
  name: alibaba-cloud-csi-local
  namespace: kube-system

ステップ2: CSI-PluginとCSI-Provisionerのデプロイ

LVのためのCSIコンポーネントは、CSI − PluginおよびCSI − Provisionerからなる。 CSI-Pluginは、LVのマウントとマウント解除に使用されます。 CSI − Provisionerは、LVおよび永続的ボリューム (PV) を作成するために使用される。

説明

次のYAMLコンテンツの {{ regionId }} をクラスターのリージョンIDに置き換えます。

Kubernetes 1.20以前を実行するクラスターにLVM CSIプラグインをデプロイする

apiVersion: storage.k8s.io/v1beta1
kind: CSIDriver
metadata:
  name: localplugin.csi.alibabacloud.com
spec:
  attachRequired: false
  podInfoOnMount: true
---
apiVersion: apps/v1
kind: DaemonSet
metadata:
  labels:
    app: csi-local-plugin
  name: csi-local-plugin
  namespace: kube-system
spec:
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: csi-local-plugin
  template:
    metadata:
      labels:
        app: csi-local-plugin
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
              - matchExpressions:
                  - key: type
                    operator: NotIn
                    values:
                      - virtual-kubelet
      containers:
        - args:
            - '--v=5'
            - '--csi-address=/csi/csi.sock'
            - >-
              --kubelet-registration-path=/var/lib/kubelet/csi-plugins/localplugin.csi.alibabacloud.com/csi.sock
          env:
            - name: KUBE_NODE_NAME
              valueFrom:
                fieldRef:
                  apiVersion: v1
                  fieldPath: spec.nodeName
          image: >-
            registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-node-driver-registrar:v1.3.0-6e9fff3-aliyun
          imagePullPolicy: Always
          name: driver-registrar
          resources: {}
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
          volumeMounts:
            - mountPath: /csi
              name: plugin-dir
            - mountPath: /registration
              name: registration-dir
        - args:
            - '--endpoint=$(CSI_ENDPOINT)'
            - '--v=5'
            - '--nodeid=$(KUBE_NODE_NAME)'
            - '--driver=localplugin.csi.alibabacloud.com'
          env:
            - name: KUBE_NODE_NAME
              valueFrom:
                fieldRef:
                  apiVersion: v1
                  fieldPath: spec.nodeName
            - name: SERVICE_PORT
              value: '11293'
            - name: CSI_ENDPOINT
              value: >-
                unix://var/lib/kubelet/csi-plugins/localplugin.csi.alibabacloud.com/csi.sock
          image: >-
            registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-plugin:v1.20.7-aafce42-aliyun
          imagePullPolicy: Always
          name: csi-localplugin
          resources: {}
          securityContext:
            allowPrivilegeEscalation: true
            capabilities:
              add:
                - SYS_ADMIN
            privileged: true
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
          volumeMounts:
            - mountPath: /var/lib/kubelet
              mountPropagation: Bidirectional
              name: pods-mount-dir
            - mountPath: /dev
              mountPropagation: HostToContainer
              name: host-dev
            - mountPath: /var/log/
              name: host-log
            - mountPath: /mnt
              mountPropagation: Bidirectional
              name: quota-path-dir
            - mountPath: /tls/local/grpc
              name: tls-token-dir
              readOnly: true
      dnsPolicy: ClusterFirst
      hostNetwork: true
      hostPID: true
      priorityClassName: system-node-critical
      restartPolicy: Always
      schedulerName: default-scheduler
      securityContext: {}
      serviceAccount: csi-admin
      serviceAccountName: csi-admin
      terminationGracePeriodSeconds: 30
      tolerations:
        - operator: Exists
      volumes:
        - name: tls-token-dir
          secret:
            defaultMode: 420
            secretName: csi-local-plugin-cert
        - hostPath:
            path: /var/lib/kubelet/csi-plugins/localplugin.csi.alibabacloud.com
            type: DirectoryOrCreate
          name: plugin-dir
        - hostPath:
            path: /var/lib/kubelet/plugins_registry
            type: DirectoryOrCreate
          name: registration-dir
        - hostPath:
            path: /var/lib/kubelet
            type: Directory
          name: pods-mount-dir
        - hostPath:
            path: /dev
            type: ''
          name: host-dev
        - hostPath:
            path: /var/log/
            type: ''
          name: host-log
        - hostPath:
            path: /mnt
            type: Directory
          name: quota-path-dir
  updateStrategy:
    rollingUpdate:
      maxUnavailable: 10%
    type: RollingUpdate

Kubernetes 1.20以前を実行するクラスターにLVM CSI-Provisionerをデプロイ

apiVersion: apps/v1
kind: Deployment
metadata:
 labels:
   app: csi-local-provisioner
 name: csi-local-provisioner
 namespace: kube-system
spec:
 selector:
   matchLabels:
     app: csi-local-provisioner
 strategy:
   rollingUpdate:
     maxSurge: 25%
     maxUnavailable: 25%
   type: RollingUpdate
 template:
   metadata:
     labels:
       app: csi-local-provisioner
   spec:
     affinity:
       nodeAffinity:
         preferredDuringSchedulingIgnoredDuringExecution:
         - preference:
             matchExpressions:
             - key: node-role.kubernetes.io/master
               operator: Exists
           weight: 1
     containers:
     - args:
       - --csi-address=$(ADDRESS)
       - --feature-gates=Topology=True
       - --volume-name-prefix=local
       - --strict-topology=true
       - --timeout=150s
       - --extra-create-metadata=true
       - --enable-leader-election=true
       - --leader-election-type=leases
       - --retry-interval-start=500ms
       - --v=5
       env:
       - name: ADDRESS
         value: /socketDir/csi.sock
       image: registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-provisioner:v1.6.0-71838bd-aliyun
       imagePullPolicy: Always
       name: external-local-provisioner
       volumeMounts:
       - mountPath: /socketDir
         name: socket-dir
     - name: csi-localprovisioner
       securityContext:
         privileged: true
       image: registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-plugin:v1.20.7-aafce42-aliyun
       imagePullPolicy: "Always"
       args:
         - "--endpoint=$(CSI_ENDPOINT)"
         - "--v=2"
         - "--driver=localplugin.csi.alibabacloud.com"
       env:
       - name: CSI_ENDPOINT
         value: unix://var/lib/kubelet/csi-provisioner/localplugin.csi.alibabacloud.com/csi.sock
       - name: SERVICE_TYPE
         value: "provisioner"
       - name: SERVICE_PORT
         value: "11290"
       volumeMounts:
       - name: socket-dir
         mountPath: /var/lib/kubelet/csi-provisioner/localplugin.csi.alibabacloud.com
       - mountPath: /var/log/
         name: host-log
       - mountPath: /tls/local/grpc/
         name: tls-token-dir
     - args:
       - --v=5
       - --csi-address=$(ADDRESS)
       - --leader-election
       env:
       - name: ADDRESS
         value: /socketDir/csi.sock
       image: registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-resizer:v1.1.0-7b30758-aliyun
       imagePullPolicy: Always
       name: external-local-resizer
       volumeMounts:
       - mountPath: /socketDir/
         name: socket-dir
     hostNetwork: true
     serviceAccount: csi-admin
     tolerations:
     - effect: NoSchedule
       operator: Exists
       key: node-role.kubernetes.io/master
     - effect: NoSchedule
       operator: Exists
       key: node.cloudprovider.kubernetes.io/uninitialized
     volumes:
     - name: socket-dir
       emptyDir: {}
     - name: tls-token-dir
       emptyDir: {}
     - hostPath:
         path: /dev
         type: ""
       name: host-dev
     - hostPath:
         path: /var/log/
         type: ""
       name: host-log
     - hostPath:
         path: /mnt
         type: Directory
       name: quota-path-dir
     - hostPath:
         path: /var/lib/kubelet
         type: Directory
       name: pods-mount-dir

Kubernetes 1.22以降を実行するクラスターにLVM CSIプラグインをデプロイする

apiVersion: storage.k8s.io/v1
kind: CSIDriver
metadata:
  name: localplugin.csi.alibabacloud.com
spec:
  attachRequired: false
  podInfoOnMount: true
---
apiVersion: apps/v1
kind: DaemonSet
metadata:
  labels:
    app: csi-local-plugin
  name: csi-local-plugin
  namespace: kube-system
spec:
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: csi-local-plugin
  template:
    metadata:
      labels:
        app: csi-local-plugin
    spec:
      affinity:
        nodeAffinity:
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
              - matchExpressions:
                  - key: type
                    operator: NotIn
                    values:
                      - virtual-kubelet
      containers:
        - args:
            - '--v=5'
            - '--csi-address=/csi/csi.sock'
            - >-
              --kubelet-registration-path=/var/lib/kubelet/csi-plugins/localplugin.csi.alibabacloud.com/csi.sock
          env:
            - name: KUBE_NODE_NAME
              valueFrom:
                fieldRef:
                  apiVersion: v1
                  fieldPath: spec.nodeName
          image: >-
            registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-node-driver-registrar:v2.3.1-038aeb6-aliyun
          imagePullPolicy: Always
          name: driver-registrar
          resources: {}
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
          volumeMounts:
            - mountPath: /csi
              name: plugin-dir
            - mountPath: /registration
              name: registration-dir
        - args:
            - '--endpoint=$(CSI_ENDPOINT)'
            - '--v=5'
            - '--nodeid=$(KUBE_NODE_NAME)'
            - '--driver=localplugin.csi.alibabacloud.com'
          env:
            - name: KUBE_NODE_NAME
              valueFrom:
                fieldRef:
                  apiVersion: v1
                  fieldPath: spec.nodeName
            - name: SERVICE_PORT
              value: '11293'
            - name: CSI_ENDPOINT
              value: >-
                unix://var/lib/kubelet/csi-plugins/localplugin.csi.alibabacloud.com/csi.sock
          image: >-
             registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-plugin:v1.24.3-55228c1-aliyun
          imagePullPolicy: Always
          name: csi-localplugin
          resources: {}
          securityContext:
            allowPrivilegeEscalation: true
            capabilities:
              add:
                - SYS_ADMIN
            privileged: true
          terminationMessagePath: /dev/termination-log
          terminationMessagePolicy: File
          volumeMounts:
            - mountPath: /var/lib/kubelet
              mountPropagation: Bidirectional
              name: pods-mount-dir
            - mountPath: /dev
              mountPropagation: HostToContainer
              name: host-dev
            - mountPath: /var/log/
              name: host-log
            - mountPath: /mnt
              mountPropagation: Bidirectional
              name: quota-path-dir
            - mountPath: /tls/local/grpc
              name: tls-token-dir
              readOnly: true
      dnsPolicy: ClusterFirst
      hostNetwork: true
      hostPID: true
      priorityClassName: system-node-critical
      restartPolicy: Always
      securityContext: {}
      serviceAccountName: alibaba-cloud-csi-local
      terminationGracePeriodSeconds: 30
      tolerations:
        - operator: Exists
      volumes:
        - name: tls-token-dir
          secret:
            defaultMode: 420
            secretName: csi-local-plugin-cert
        - hostPath:
            path: /var/lib/kubelet/csi-plugins/localplugin.csi.alibabacloud.com
            type: DirectoryOrCreate
          name: plugin-dir
        - hostPath:
            path: /var/lib/kubelet/plugins_registry
            type: DirectoryOrCreate
          name: registration-dir
        - hostPath:
            path: /var/lib/kubelet
            type: Directory
          name: pods-mount-dir
        - hostPath:
            path: /dev
            type: ''
          name: host-dev
        - hostPath:
            path: /var/log/
            type: ''
          name: host-log
        - hostPath:
            path: /mnt
            type: Directory
          name: quota-path-dir
  updateStrategy:
    rollingUpdate:
      maxUnavailable: 10%
    type: RollingUpdate

Kubernetes 1.22以降を実行するクラスターにLVM CSI-Provisionerをデプロイ

apiVersion: apps/v1
kind: Deployment
metadata:
  labels:
    app: csi-local-provisioner
  name: csi-local-provisioner
  namespace: kube-system
spec:
  progressDeadlineSeconds: 600
  replicas: 1
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: csi-local-provisioner
  strategy:
    rollingUpdate:
      maxSurge: 25%
      maxUnavailable: 25%
    type: RollingUpdate
  template:
    metadata:
      labels:
        app: csi-local-provisioner
    spec:
      affinity:
        nodeAffinity:
          preferredDuringSchedulingIgnoredDuringExecution:
          - preference:
              matchExpressions:
              - key: node-role.kubernetes.io/master
                operator: Exists
            weight: 1
          requiredDuringSchedulingIgnoredDuringExecution:
            nodeSelectorTerms:
            - matchExpressions:
              - key: type
                operator: NotIn
                values:
                - virtual-kubelet
      containers:
      - args:
        - --csi-address=$(ADDRESS)
        - --feature-gates=Topology=True
        - --volume-name-prefix=local
        - --strict-topology=true
        - --timeout=150s
        - --extra-create-metadata=true
        - --enable-leader-election=true
        - --leader-election-type=leases
        - --retry-interval-start=500ms
        - --default-fstype=ext4
        - --v=5
        env:
        - name: ADDRESS
          value: /socketDir/csi.sock
        image: registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-provisioner:v3.0.0-080f01e64-aliyun
        imagePullPolicy: Always
        name: external-local-provisioner
        resources: {}
        volumeMounts:
        - mountPath: /socketDir
          name: socket-dir
      - args:
        - --endpoint=$(CSI_ENDPOINT)
        - --v=2
        - --driver=localplugin.csi.alibabacloud.com
        env:
        - name: CSI_ENDPOINT
          value: unix://var/lib/kubelet/csi-provisioner/localplugin.csi.alibabacloud.com/csi.sock
        - name: SERVICE_TYPE
          value: provisioner
        - name: SERVICE_PORT
          value: "11290"
        image: registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-plugin:v1.24.3-55228c1-aliyun
        imagePullPolicy: Always
        name: csi-localprovisioner
        resources: {}
        securityContext:
          privileged: true
        volumeMounts:
        - mountPath: /var/lib/kubelet/csi-provisioner/localplugin.csi.alibabacloud.com
          name: socket-dir
        - mountPath: /var/log/
          name: host-log
        - mountPath: /tls/local/grpc/
          name: tls-token-dir
      - args:
        - --v=5
        - --csi-address=$(ADDRESS)
        - --leader-election
        env:
        - name: ADDRESS
          value: /socketDir/csi.sock
        image: registry-vpc.{{ regionId }}.aliyuncs.com/acs/csi-resizer:v1.3-ca84e84-aliyun
        imagePullPolicy: Always
        name: external-local-resizer
        resources: {}
        volumeMounts:
        - mountPath: /socketDir/
          name: socket-dir
      dnsPolicy: ClusterFirst
      hostNetwork: true
      restartPolicy: Always
      securityContext: {}
      serviceAccountName: alibaba-cloud-csi-local
      terminationGracePeriodSeconds: 30
      tolerations:
      - operator: Exists
      volumes:
      - emptyDir: {}
        name: socket-dir
      - emptyDir: {}
        name: tls-token-dir
      - hostPath:
          path: /dev
          type: ""
        name: host-dev
      - hostPath:
          path: /var/log/
          type: ""
        name: host-log
      - hostPath:
          path: /mnt
          type: Directory
        name: quota-path-dir
      - hostPath:
          path: /var/lib/kubelet
          type: Directory
        name: pods-mount-dir

ステップ3: LVを使用する

CSI-Provisionerを使用してPVを作成する場合、次の制限に注意してください。

StorageClassでVGの名前を指定する必要があります。
指定したノードにPVを作成する場合は、volume.kubernetes.io/selected-node: nodeNameアノテーションを関連するPVCに追加する必要があります。

次のテンプレートを使用してStorageClassを作成します。

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
    name: csi-local
provisioner: localplugin.csi.alibabacloud.com
parameters:
    volumeType: LVM
    vgName: volumegroup1
    fsType: ext4
    lvmType: "striping"
    writeIOPS: "10000"
    writeBPS: "1M"
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer
allowVolumeExpansion: true

パラメーター	説明
volumeType	ボリュームのタイプ。ボリュームタイプはLVでなければなりません。他のタイプのボリュームはまもなくサポートされます。
vgName	VGの名前。 This parameter is required.
fsType	ファイルシステムのタイプ。
lvmType	LVのタイプ。有効な値: linearとstriping。
writeIOPS	StorageClassを使用して作成されたLVの書き込みIOPS。
writeBPS	StorageClassを使用して作成されたLVに1秒あたりに書き込むことができるデータのサイズ。単位はバイトです。

次のテンプレートを使用してPVCを作成します。

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: lvm-pvc
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 2Gi
  storageClassName: csi-local

次のテンプレートを使用してアプリケーションを作成します。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-lvm
  labels:
    app: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.7.9
        volumeMounts:
          - name: lvm-pvc
            mountPath: "/data"
      volumes:
        - name: lvm-pvc
          persistentVolumeClaim:
            claimName: lvm-pvc

アプリケーションのステータスを照会します。

次のコマンドを実行して、アプリケーション用に作成されたポッドを照会します。

kubectl get pod

期待される出力:

NAME                             READY   STATUS    RESTARTS   AGE
deployment-lvm-9f798687c-m****   1/1     Running   0          9s

次のコマンドを実行して、PVCに関する情報を照会します。

kubectl get pvc

期待される出力:

NAME      STATUS   VOLUME                                      CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-pvc   Bound    disk-afacf7a9-3d1a-45da-b443-24f8fb35****   2Gi        RWO            csi-local      16s

次のコマンドを実行して、PVに関する情報を照会します。

kubectl get pv

期待される出力:

NAME                                        CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS   CLAIM             STORAGECLASS   REASON   AGE
disk-afacf7a9-3d1a-45da-b443-24f8fb35****   2Gi        RWO            Delete           Bound    default/lvm-pvc   csi-local               12s

次のコマンドを実行して、ポッドにマウントされているボリュームを照会します。

kubectl exec -ti deployment-lvm-9f798687c-m**** sh -- df /data

期待される出力:

Filesystem                                                                1K-blocks  Used   Available Use% Mounted on
/dev/mapper/volumegroup1-disk--afacf7a9--3d1a--45da--b443--24f8fb35****   1998672    6144   1976144   1%   /data

次のコマンドを実行して、/dataディレクトリ内のすべてのディレクトリを照会します。
```
ls /data
```
期待される出力:
```
lost+found
```
次のコマンドを実行して、/dataディレクトリにtestという名前のディレクトリを作成します。
```
touch /data/test
ls /data
```
期待される出力:
```
lost+found  test
```
次のコマンドを実行して終了します。
```
exit
```

次のコマンドを実行してポッドを削除します。

kubectl delete pod deployment-lvm-9f798687c-m****

期待される出力:

pod "deployment-lvm-9f798687c-m****" deleted

次のコマンドを実行して、アプリケーション用に作成されたポッドを照会します。

kubectl get pod

期待される出力:

NAME                             READY   STATUS    RESTARTS   AGE
deployment-lvm-9f798687c-j****   1/1     Running   0          2m19s

次のコマンドを実行して、ポッドにマウントされているボリュームを照会します。
```
kubectl exec deployment-lvm-9f798687c-j**** -- ls /data
```
期待される出力:
```
lost+found  
test
```

LVを拡張します。

次のコマンドを実行して、PVCに関する情報を照会します。

kubectl get pvc

期待される出力:

NAME      STATUS   VOLUME                                      CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-pvc   Bound    disk-afacf7a9-3d1a-45da-b443-24f8fb35****   2Gi        RWO            csi-local      6m50s

次のコマンドを実行して、PVCを4 GiBに展開します。

kubectl patch pvc lvm-pvc -p '{"spec":{"resources":{"requests":{"storage":"4Gi"}}}}'

期待される出力:

persistentvolumeclaim/lvm-pvc patched

次のコマンドを実行して、PVCに関する情報を照会します。

kubectl get pvc

期待される出力:

NAME      STATUS   VOLUME                                      CAPACITY   ACCESS MODES   STORAGECLASS   AGE
lvm-pvc   Bound    disk-afacf7a9-3d1a-45da-b443-24f8fb35****   4Gi        RWO            csi-local      7m26s

次のコマンドを実行して、LVが4 GiBに拡張されているかどうかを確認します。

kubectl exec deployment-lvm-9f798687c-j**** -- df /data

期待される出力:

Filesystem                                                                1K-blocks  Used   Available Use% Mounted on
/dev/mapper/volumegroup1-disk--afacf7a9--3d1a--45da--b443--24f8fb35****   4062912    8184   4038344   1%   /data

次のコマンドを実行して、LVを監視します。

curl -s localhost:10255/metrics | grep lvm-pvc

期待される出力:

kubelet_volume_stats_available_bytes{namespace="default",persistentvolumeclaim="lvm-pvc"} 1.917165568e+09
kubelet_volume_stats_capacity_bytes{namespace="default",persistentvolumeclaim="lvm-pvc"} 1.939816448e+09
kubelet_volume_stats_inodes{namespace="default",persistentvolumeclaim="lvm-pvc"} 122400
kubelet_volume_stats_inodes_free{namespace="default",persistentvolumeclaim="lvm-pvc"} 122389
kubelet_volume_stats_inodes_used{namespace="default",persistentvolumeclaim="lvm-pvc"} 11
kubelet_volume_stats_used_bytes{namespace="default",persistentvolumeclaim="lvm-pvc"} 5.873664e+06

上記のモニタリングデータをPrometheusにインポートし、コンソールに表示できます。詳細については、「オープンソースのPrometheusを使用したACKクラスターのモニタリング」をご参照ください。