File Storage NAS:CNFS を使用した NAS ファイルシステムの管理

kubectl

以下のマニフェストを適用して、CNFS リソース、StorageClass、PVC、Deployment、StatefulSet を作成します。

# 1. CNFS リソース — NAS ファイルシステムを自動的に作成
apiVersion: storage.alibabacloud.com/v1beta1
kind: ContainerNetworkFileSystem
metadata:
  name: cnfs-nas-filesystem
spec:
  description: "cnfs"
  type: nas
  reclaimPolicy: Retain
  parameters:
    # encryptType: SSE-KMS   # オプション。KMS 暗号化を有効化する場合はコメントを解除。
    # enableTrashCan: "true"  # オプション。ゴミ箱を有効化する場合はコメントを解除。
---
# 2. StorageClass — CNFS ファイルシステムにバインド
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: alibabacloud-cnfs-nas
mountOptions:
  - nolock,tcp,noresvport
  - vers=3
parameters:
  volumeAs: subpath
  containerNetworkFileSystem: cnfs-nas-filesystem
  path: "/"
provisioner: nasplugin.csi.alibabacloud.com
reclaimPolicy: Retain
allowVolumeExpansion: true  # オプション。ボリュームの拡張を有効化する場合は true に設定。
---
# 3. PVC
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: cnfs-nas-pvc
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: alibabacloud-cnfs-nas
  resources:
    requests:
      storage: 70Gi  # ディレクトリクォータが有効な場合、書き込み可能サイズは 70 GiB に制限されます。
---
# 4. Deployment
apiVersion: apps/v1
kind: Deployment
metadata:
  name: cnfs-nas-deployment
  labels:
    app: nginx
spec:
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        volumeMounts:
        - mountPath: "/data"
          name: cnfs-nas-pvc
      volumes:
      - name: cnfs-nas-pvc
        persistentVolumeClaim:
          claimName: cnfs-nas-pvc
---
# 5. StatefulSet
apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: cnfs-nas-sts
  labels:
    app: nginx
spec:
  serviceName: "nginx"
  replicas: 2
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        volumeMounts:
        - mountPath: "/data"
          name: www
  volumeClaimTemplates:
  - metadata:
      name: www
    spec:
      accessModes: [ "ReadWriteOnce" ]
      storageClassName: "alibabacloud-cnfs-nas"
      resources:
        requests:
          storage: 50Gi  # ディレクトリクォータが有効な場合、書き込み可能サイズは 50 GiB に制限されます。

コンソール

1. CNFS ファイルシステムの作成

   1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスター をクリックします。

   2. クラスター ページで、管理対象のクラスター名をクリックします。左側のナビゲーションウィンドウで、ボリューム > CNFS を選択します。

   3. Container Network File System（CNFS） ページで、CNFS ファイルシステムの作成 をクリックします。

   4. CNFS ファイルシステムの作成 パネルで、以下のパラメーターを設定し、OK をクリックします。

      パラメーター	説明	例
      名前	CNFS ファイルシステムの名前。	cnfs-nas-filesystem
      ファイルシステムタイプの選択	ファイルシステムタイプ。NAS を選択します。	NAS
      必須	デフォルト NAS ファイルシステムの作成を選択します。このフィールドは、ファイルシステムタイプが NAS に設定されている場合にのみ表示されます。	デフォルト NAS ファイルシステムの作成
      説明	CNFS ファイルシステムの説明。	デフォルト NAS ファイルシステム
      エンドツーエンドデータアクセラレーション	マウントのエラスティックアクセラレーションを有効にするかどうか。デフォルトで無効になっています。詳細については、「CNFS クライアントの分散キャッシュ機能を有効化する」をご参照ください。	無効

   5. Container Network File System（CNFS） ページで、CNFS ファイルシステム名をクリックして詳細を表示します。NAS ID の横にあるリンクをクリックし、「ファイルシステム一覧」ページに移動します。

   6. [ファイルシステム一覧] ページで、[マウントポイント] タブをクリックします。[マウントポイント] リストで、[マウントポイント] 列の アイコンの上にマウスを合わせて、マウントポイントを表示します。

2. StorageClass の作成

   1. クラスター ページで、対象のクラスターを見つけ、その名前をクリックします。左側のペインで、ボリューム > StorageClasses を選択します。

   2. StorageClasses ページの右上隅で、作成 をクリックします。

   3. 作成 パネルで、以下のパラメーターを設定し、作成 をクリックします。

      パラメーター	説明	例
      名前	StorageClass の名前。小文字で始める必要があります。小文字、数字、ピリオド（.）、ハイフン（-）を含めることができます。	alibabacloud-cnfs-nas
      PV タイプ	ボリュームタイプ。NAS を選択します。	NAS
      マウントポイントの選択	手順 1 で作成した NAS ファイルシステムのマウントポイントです。詳細については、「マウントポイントの表示」をご参照ください。	64888****-e*.cn-qingdao.nas.aliyuncs.com
      再利用ポリシー	再利用ポリシー。Retain のみがサポートされています。	Retain
      マウントオプション	NFS マウントオプション。NFS v3 を使用します。詳細については、「NFS」をご参照ください。	nolock,tcp,noresvport vers=3
      マウントパス	NAS ファイルシステムのマウントパス。	/

3. PVC の作成

   1. 左側のナビゲーションウィンドウで、ボリューム > Persistent Volume Claims を選択します。

   2. 右上隅で、作成 をクリックします。

   3. PVC の作成 パネルで、以下のパラメーターを設定し、作成 をクリックします。

      パラメーター	説明	例
      PVC タイプ	ボリュームタイプ。NAS を選択します。	NAS
      名前	PVC の名前。クラスター内で一意である必要があります。	cnfs-nas-pvc
      割り当てモード	Use StorageClass を選択します。	Use StorageClass
      既存の StorageClass	選択をクリックし、StorageClass を検索して、アクション列の選択をクリックします。	alibabacloud-cnfs-nas
      容量	PVC が要求する容量。PV の容量を超えることはできません。	70 Gi
      アクセスモード	アクセスモード。デフォルトは ReadWriteMany です。ReadWriteOnce および ReadOnlyMany もサポートされます。	ReadWriteMany

4. PVC をアプリケーションにマウント。CNFS によって作成された NAS ファイルシステムを、コンテナ内の /data パスにマウントします。

   

kubectl

1. カスタム NAS ファイルシステムの作成 #### CNFS パラメーター

   パラメーター	説明	必須	デフォルト
   description	ファイルシステムの説明。	いいえ	なし
   type	ボリュームタイプ。値は nas に設定します。	はい	なし
   reclaimPolicy	再利用ポリシー。サポートされるのは Retain のみです。	はい	なし
   parameters.filesystemType	ファイルシステムタイプ。standard は汎用 NAS を示します。	いいえ	standard
   parameters.storageType	ストレージタイプ。有効な値： Performance、Capacity。	いいえ	なし
   parameters.protocolType	ファイル転送プロトコル。サポートされるのは NFS（NFSv3）のみです。	いいえ	NFS
   parameters.encryptType	暗号化方式。有効な値： None、SSE-KMS。	いいえ	None
   parameters.enableTrashCan	ゴミ箱の有効化の有無。有効な値： true、false。	いいえ	false
   parameters.trashCanReservedDays	ゴミ箱にファイルを保持する最大日数。	いいえ	7
   parameters.vSwitchId	NAS ファイルシステムの vSwitch ID。	いいえ	なし

      cat <<EOF | kubectl apply -f -
      apiVersion: storage.alibabacloud.com/v1beta1
      kind: ContainerNetworkFileSystem
      metadata:
        name: cnfs-nas-filesystem
      spec:
        description: "cnfs"
        type: nas
        reclaimPolicy: Retain
        parameters:
          filesystemType: standard
          storageType: Capacity
          protocolType: NFS
          encryptType: SSE-KMS
          enableTrashCan: "true"
          trashCanReservedDays: "5"
          vSwitchId: vsw-2ze9l3ppwzg6bl02j****
      EOF

2. ファイルシステムの確認。CNFS リソースを照会します：期待される出力：ファイルシステムの詳細を表示します：

   期待される出力 #### ステータスフィールド

   フィールド	説明
   status.status	CNFS のステータス。有効な値： Pending、Creating、Initialization、Available、Unavailable、Fatal、Terminating。
   conditions.lastProbeTime	最終プローブ時刻。
   conditions.reason	現在の状態の理由。
   conditions.status	ファイルシステムが準備完了かどうか。有効な値： Ready、NotReady。
   fsAttributes.accessGroupName	マウントポイントの権限グループ。値： DEFAULT_VPC_GROUP_NAME（デフォルト VPC 権限グループ）。
   fsAttributes.encryptType	暗号化方式。有効な値： None、SSE-KMS。
   fsAttributes.enableTrashCan	ゴミ箱が有効化されているかどうか。有効な値： true、false。
   fsAttributes.filesystemId	ファイルシステム ID。
   fsAttributes.filesystemType	ファイルシステムタイプ。standard は汎用 NAS を示します。
   fsAttributes.protocolType	ファイル転送プロトコル。
   fsAttributes.regionId	CNFS ファイルシステムのリージョン。
   fsAttributes.server	マウントポイントのドメイン名。
   fsAttributes.storageType	ストレージタイプ。有効な値： Performance、Capacity。
   fsAttributes.vSwitchId	CNFS ファイルシステムで使用される vSwitch。
   fsAttributes.vpcId	CNFS ファイルシステムの VPC。
   fsAttributes.zoneId	CNFS ファイルシステムのゾーン。

      kubectl get cnfs

      NAME                  AGE
      cnfs-nas-filesystem   6d

      kubectl get cnfs/cnfs-nas-filesystem -o yaml

      apiVersion: storage.alibabacloud.com/v1beta1
      kind: ContainerNetworkFileSystem
      metadata:
        name: cnfs-nas-filesystem
      spec:
        description: "cnfs"
        type: nas
        reclaimPolicy: Retain
        parameters:
          filesystemType: standard
          storageType: Capacity
          protocolType: NFS
          encryptType: SSE-KMS
          vSwitchId: vsw-XXX
          enableTrashCan: "true"
      status:
        conditions:
        - lastProbeTime: "2021-05-14 16:20:15"
          reason: The nas filesystem and mount target complete initialization.
          status: Ready
        fsAttributes:
          accessGroupName: DEFAULT_VPC_GROUP_NAME
          encryptType: SSE-KMS
          enableTrashCan: "true"
          filesystemId: 17f7e48ece
          filesystemType: standard
          protocolType: NFS
          regionId: cn-beijing
          server: 17f7e48ece-h****.cn-beijing.nas.aliyuncs.com
          storageType: Capacity
          vSwitchId: vsw-2ze9l3ppwzg6bl02j****
          vpcId: vpc-2ze9sgmehjvwv5x74****
          zoneId: cn-beijing-h
        status: Available

3. NAS ファイルシステムに関連付ける PV または StorageClass の作成。以下のいずれかのオプションを選択します。#### オプション A：静的 PV の作成 PV の確認：期待される出力：#### オプション B：動的 StorageClass の作成

   allowVolumeExpansion により、ディレクトリクォータ機能およびボリューム拡張が有効化されます。有効な値： true、false。

   パラメーター	説明
   containerNetworkFileSystem	CNFS ファイルシステムの名前。
   path	PV で使用される NAS ファイルシステムのマウントパス。

      cat <<EOF | kubectl apply -f -
      apiVersion: v1
      kind: PersistentVolume
      metadata:
        name: cnfs-nas-pv
        labels:
          alicloud-pvname: cnfs-nas-pv
      spec:
        capacity:
          storage: 5Gi
        accessModes:
          - ReadWriteMany
        csi:
          driver: nasplugin.csi.alibabacloud.com
          volumeHandle: cnfs-nas-pv   # PV 名と一致させる必要があります。
          volumeAttributes:
            containerNetworkFileSystem: cnfs-nas-filesystem
            path: "/"
        mountOptions:
          - nolock,tcp,noresvport
          - vers=3
      EOF

      kubectl get pv

      NAME          CAPACITY   ACCESS MODES   RECLAIM POLICY   STATUS      CLAIM   STORAGECLASS   REASON   AGE
      cnfs-nas-pv   5Gi        RWX            Retain           Available                                   4s

      cat <<EOF | kubectl apply -f -
      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: alibabacloud-nas-cnfs
      mountOptions:
        - nolock,tcp,noresvport
        - vers=3
      parameters:
        volumeAs: subpath
        containerNetworkFileSystem: cnfs-nas-filesystem
        path: "/"
      provisioner: nasplugin.csi.alibabacloud.com
      reclaimPolicy: Retain
      allowVolumeExpansion: true  # ディレクトリクォータ機能およびボリューム拡張を有効化するには true に設定します。
      EOF

4. PVC の作成

      cat <<EOF | kubectl apply -f -
      apiVersion: v1
      kind: PersistentVolumeClaim
      metadata:
        name: cnfs-nas-pvc
      spec:
        accessModes:
          - ReadWriteMany
        storageClassName: alibabacloud-nas-cnfs
        resources:
          requests:
            storage: 70Gi
      EOF

5. アプリケーションの作成。アプリケーションの確認：期待される出力： Running ステータスは、CNFS ファイルシステムが Deployment にマウントされたことを確認します。

      cat <<EOF | kubectl apply -f -
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: cnfs-nas-deployment
        labels:
          app: nginx
      spec:
        selector:
          matchLabels:
            app: nginx
        template:
          metadata:
            labels:
              app: nginx
          spec:
            containers:
              - name: nginx
                image: nginx:1.14.2
                ports:
                  - containerPort: 80
                volumeMounts:
                  - name: cnfs-nas-pvc
                    mountPath: "/data"
            volumes:
              - name: cnfs-nas-pvc
                persistentVolumeClaim:
                  claimName: cnfs-nas-pvc
      EOF

      kubectl get pod

      NAME                             READY   STATUS    RESTARTS   AGE
      cnfs-nas-deployment-86959b****   1/1     Running   0          2s

コンソール

1. CNFS ファイルシステムの作成

   1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスター をクリックします。

   2. クラスター ページで、管理対象のクラスター名をクリックします。左側のナビゲーションウィンドウで、ボリューム > CNFS を選択します。

   3. Container Network File System（CNFS） ページで、CNFS ファイルシステムの作成 をクリックします。

   4. CNFS ファイルシステムの作成 パネルで、以下のパラメーターを設定し、OK をクリックします。

      パラメーター	説明	例
      名前	CNFS ファイルシステムの名前。	cnfs-nas-filesystem
      ファイルシステムタイプの選択	ファイルシステムタイプ。NAS を選択します。	NAS
      必須	既存の NAS ファイルシステムの選択を選択します。このフィールドは、ファイルシステムタイプが NAS に設定されている場合にのみ表示されます。	既存の NAS ファイルシステムの選択
      NAS ファイルシステムの選択	既存の NAS マウントポイントを選択するか、[NAS ファイルシステムの作成] をクリックしてカスタムの汎用型 NAS ファイルシステムを作成します。 「必須」が「既存の NAS ファイルシステムを選択」に設定されている場合にのみ表示されます。 詳細については、「汎用型 NAS ファイルシステムの作成」をご参照ください。	NAS ファイルシステムの作成をクリック
      説明	CNFS ファイルシステムの説明。	カスタム NAS ファイルシステム
      エンドツーエンドデータアクセラレーション	マウントにエラスティックアクセラレーションを有効にするかどうかを指定します。デフォルトでは無効です。詳細については、「CNFS クライアントの分散キャッシュ機能を有効にする」をご参照ください。	無効

2. NAS ファイルシステムに関連付ける PV または StorageClass の作成

   • 静的 PV の作成手順：

     1. クラスター ページで、対象のクラスターを見つけ、その名前をクリックします。左側のペインで、ボリューム > Persistent Volumes を選択します。

     2. 右上隅で、作成 をクリックします。

     3. PV の作成 パネルで、以下のパラメーターを設定し、OK をクリックします。

        パラメーター	説明	例
        PV タイプ	ボリュームタイプ。NAS を選択します。	NAS
        ボリューム名	PV の名前。クラスター内で一意である必要があります。	cnfs-nas-pv
        容量	PV の容量。NAS ストレージ使用量には制限されません。	5 Gi
        アクセスモード	アクセスモード。デフォルトは ReadWriteMany です。ReadWriteOnce もサポートされます。	ReadWriteMany
        CNFS の有効化	CNFS を有効にし、ステップ 1 で作成した CNFS ファイルシステムを選択します。オプションで CNFS アクセラレーションを有効にします。詳細については、「CNFS クライアントの分散キャッシング機能を有効にする」をご参照ください。	cnfs-nas-filesystem
        詳細オプションの表示	マウントパス：前方スラッシュ（/）で始める必要があります。サブディレクトリが存在しない場合、システムが自動的に作成します。デフォルトはルート（/）です。 再利用ポリシー：Retain のみがサポートされています。	/、Retain
        ラベル	PV のラベル。	cnfs-nas-pv

   • 動的 StorageClass の作成手順：

     1. クラスター ページで、対象のクラスターを見つけ、その名前をクリックします。左側のペインで、ボリューム > StorageClasses を選択します。

     2. 右上隅で、作成 をクリックします。

     3. 作成 パネルで、以下のパラメーターを設定し、作成 をクリックします。

        パラメーター	説明	例
        名前	StorageClass の名前。小文字で始める必要があります。小文字、数字、ピリオド（.）、ハイフン（-）を含めることができます。	alibabacloud-cnfs-nas
        PV タイプ	ボリュームタイプ。NAS を選択します。	NAS
        マウントポイントの選択	手順 1 で作成した NAS ファイルシステムのマウントポイント。詳細については、「マウントポイントの表示」をご参照ください。	64888****-e*.cn-qingdao.nas.aliyuncs.com
        再利用ポリシー	再利用ポリシー。Retain のみがサポートされています。	Retain
        マウントオプション	NFS マウントオプション。NFS v3 を使用します。「NFS」をご参照ください。	nolock,tcp,noresvport vers=3
        マウントパス	NAS ファイルシステムのマウントパス。	/

3. PVC の作成

   1. 左側のナビゲーションウィンドウで、ボリューム > Persistent Volume Claims を選択します。

   2. 右上隅で、作成 をクリックします。

   3. PVC の作成 パネルで、以下のパラメーターを設定し、作成 をクリックします。

      パラメーター	説明	例
      PVC タイプ	ボリュームタイプ。NAS を選択します。	NAS
      名前	PVC の名前。クラスター内で一意である必要があります。	cnfs-nas-pvc
      割り当てモード	Use StorageClass を選択します。	Use StorageClass
      既存の StorageClass	選択をクリックし、StorageClass を検索して、アクション列の選択をクリックします。	alibabacloud-cnfs-nas
      容量	PVC が要求する容量。PV の容量を超えることはできません。	70 Gi
      アクセスモード	アクセスモード。デフォルトは ReadWriteMany です。ReadWriteOnce および ReadOnlyMany もサポートされます。	ReadWriteMany

4. PVC をアプリケーションにマウント。CNFS によって作成された NAS ファイルシステムを、コンテナ内の /data パスにマウントします。

   

kubectl

1. 既存 NAS ファイルシステムから CNFS リソースを作成

   パラメーター	説明	必須
   description	ファイルシステムの説明。	いいえ
   type	ボリュームタイプ。値は nas に設定します。	はい
   reclaimPolicy	再利用ポリシー。サポートされるのは Retain のみです。	はい
   parameters.server	既存 NAS ファイルシステムのマウントポイント URL。	はい

      cat <<EOF | kubectl apply -f -
      apiVersion: storage.alibabacloud.com/v1beta1
      kind: ContainerNetworkFileSystem
      metadata:
        name: cnfs-nas-filesystem
      spec:
        description: "cnfs"
        type: nas
        reclaimPolicy: Retain
        parameters:
          server: 17f7e4****-h****.cn-beijing.nas.aliyuncs.com
      EOF

2. ファイルシステムの確認。期待される出力：ファイルシステムの詳細を表示します：

   期待される出力

      kubectl get cnfs

      NAME                  AGE
      cnfs-nas-filesystem   6d

      kubectl get cnfs/cnfs-nas-filesystem -o yaml

      apiVersion: storage.alibabacloud.com/v1beta1
      kind: ContainerNetworkFileSystem
      metadata:
        name: cnfs-nas-filesystem
      spec:
        description: cnfs
        parameters:
          server: 17f7e48ece-h****.cn-beijing.nas.aliyuncs.com
        reclaimPolicy: Retain
        type: nas
      status:
        conditions:
        - lastProbeTime: "2021-05-14 16:20:15"
          reason: The nas filesystem and mount target complete initialization.
          status: Ready
        fsAttributes:
          accessGroupName: DEFAULT_VPC_GROUP_NAME
          encryptType: None
          enableTrashCan: "true"
          filesystemId: 17f7e4****
          filesystemType: standard
          protocolType: NFS
          regionId: cn-beijing
          server: 17f7e48ece-h****.cn-beijing.nas.aliyuncs.com
          storageType: Capacity
          vSwitchId: vsw-2ze9l3ppwzg6bl02j****
          vpcId: vpc-2ze9sgmehjvwv5x74****
          zoneId: cn-beijing-h
        status: Available

3. NAS ボリュームの作成およびワークロードへのマウント。方法 2 のステップ 3 ～ 5 を実行して、PV または StorageClass、PVC、アプリケーションを作成します。

コンソール

1. CNFS ファイルシステムの作成

   1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスター をクリックします。

   2. クラスター ページで、管理対象のクラスター名をクリックします。左側のナビゲーションウィンドウで、ボリューム > CNFS を選択します。

   3. Container Network File System（CNFS） ページで、CNFS ファイルシステムの作成 をクリックします。

   4. CNFS ファイルシステムの作成 パネルで、以下のパラメーターを設定し、OK をクリックします。

      パラメーター	説明	例
      名前	CNFS ファイルシステムの名前。	cnfs-nas-filesystem
      ファイルシステムタイプの選択	ファイルシステムタイプ。NAS を選択します。	NAS
      必須	既存の NAS ファイルシステムの選択を選択します。このフィールドは、ファイルシステムタイプが NAS に設定されている場合にのみ表示されます。	既存の NAS ファイルシステムの選択
      NAS ファイルシステムの選択	既存の NAS マウントポイントを選択します。詳細については、「マウントポイントの表示」をご参照ください。	既存の NAS マウントポイントを選択
      説明	CNFS ファイルシステムの説明。	既存の NAS ファイルシステム
      エンドツーエンドデータアクセラレーション	マウント用のエラスティックアクセラレーションを有効にするかどうか。デフォルトで無効になっています。詳細については、「CNFS クライアントの分散キャッシュ機能を有効化する」をご参照ください。	無効

2. NAS ボリュームの作成およびワークロードへのマウント。方法 2 のコンソール操作手順のステップ 2 ～ 4 を実行して、PV または StorageClass、PVC、および PVC をアプリケーションにマウントします。