既存のファイル・システムを使用した永続ファイル・システム・ストレージの作成

Compute Cloud@Customerでは、既存のファイル・システムにPVCをプロビジョニングできます。

この手順では、マウント・ターゲット、ファイル・システムおよびファイル・システムのエクスポートを作成します。次に、kubectlコマンドを使用して、ストレージ・クラス、永続ボリュームおよび永続ボリューム要求を作成します。

1. マウント・ターゲットを作成します。

   手順については、マウント・ターゲットの作成を参照してください。

   重要
   
   

   ワーカー・ノードからマウント・ターゲットに到達できるようにするには、「OKEネットワーク・リソースの作成」で説明されているワーカー・サブネットを持つサブネットにマウント・ターゲットを作成します。NFSサーバーへのTCPポート2049がそのサブネットで開いていることを確認します。

   エクスポート・セットOCIDおよびマウント・ターゲットOCIDに注意してください。ファイル・システムのエクスポートを作成するにはエクスポート・セットOCIDが必要で、後のステップでストレージ・クラスを作成するにはマウント・ターゲットOCIDが必要です。

   VCN当たり1つのマウント・ターゲットのみを持つことができます。

2. ファイル・システムを作成します。

   手順については、Creating a File Systemを参照してください。

   VCNごとに作成できるファイル・システムは1つのみです。クラスタごとに複数のストレージ・クラス、永続ボリュームおよび永続ボリューム要求を持つことができ、それらはすべて1つのNFSを共有します。

3. ファイル・システム・エクスポートを作成して、マウント・ターゲットをファイル・システムに関連付けます。

   手順は、ファイル・システムのエクスポートの作成を参照してください。

   • マウント・ターゲットの作成からの出力からエクスポート・セットOCIDを指定します。

   • ワーカー・サブネットの作成(Flannelオーバーレイ)またはワーカー・サブネットの作成(VCNネイティブ・ポッド)の説明に従って、ワーカー・サブネットの作成時に指定したCIDR範囲内の最長CIDR (最小ネットワーク)を指定します。

   エクスポート・パスとマウント・ターゲットのIPアドレスを書き留めます。

4. マウント・ターゲットの作成ステップの出力からマウント・ターゲットOCIDを指定して、ストレージ・クラスを作成します。

   $ kubectl create -f sc.yaml

   sc.yamlファイルの内容は次のとおりです。

   kind: StorageClass
   apiVersion: storage.k8s.io/v1
   metadata:
     name: pca-fss
   provisioner: fss.csi.oraclecloud.com
   parameters:
     mntTargetId: ocid1.mounttarget.unique_ID
               

   apiVersionおよびprovisionerプロパティの値は標準です。メタデータ・セクションのストレージ・クラス名の値は、ユーザー指定です。マウント・ターゲットごとに複数のストレージ・クラスを作成でき、そのストレージ・クラス名を次のステップで使用して、永続ボリュームおよび永続ボリューム要求を作成します。

   get scサブコマンドを使用して、新しいストレージ・クラスの情報を表示します。

   $ kubectl get sc

5. ストレージ・クラス名、エクスポート・パスおよびマウント・ターゲットのIPアドレスを指定して、永続ボリュームを作成します。

   ストレージ・クラス名は、前のステップのsc.yamlファイルのメタデータにあります。エクスポート・パスおよびマウント・ターゲットのIPアドレスは、ファイル・システムの作成エクスポート・ステップから出力されます。ステップ3を参照してください。

   $ kubectl create -f pv.yaml

   pv.yamlファイルの内容は次のとおりです。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: fss-pv
   spec:
     storageClassName: pca-fss
     capacity:
       storage: 200Gi
     accessModes:
       - ReadWriteMany
     mountOptions:
       - nosuid
     nfs:
       server: mount_target_IP_address
       path: "/export/unique_ID"
       readOnly: false

   metadataセクションの永続ボリューム名はユーザー指定です。1つのストレージ・クラスに複数の永続ボリュームを設定できます。

   nfsセクションのserver値はマウント・ターゲットのIPアドレスで、path値はエクスポート・パスです。

   get pvサブコマンドを使用して、新しい永続ボリュームに関する情報を表示します。

   $ kubectl get pv
   NAME    CAPACITY  ACCESS MODES  RECLAIM POLICY  STATUS  CLAIM            STORAGECLASS  REASON  AGE
   fss-pv  200Gi     RWX           Retain          Bound   default/fss-pvc  pca-fss               20h

6. 永続ボリューム名とストレージクラス名を指定して、永続ボリューム要求を作成します。

   永続ボリューム名およびストレージ・クラス名は、get pvコマンドの出力に含まれています。

   このストレージを使用する前に、PVCステータスが「Bound」になるまで待ちます。

   kubectl create -f pvc.yaml

   pvc.yamlファイルの内容は次のとおりです。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: fss-pvc
   spec:
     storageClassName: pca-fss
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 200Gi
     volumeName: fss-pv

   metadataセクションの永続ボリューム要求名はユーザー指定です。1つの永続ボリュームに複数の永続ボリューム要求を設定できます。

   accessModesプロパティの値は、ReadWriteManyである必要があります。

   storageプロパティの値は、50GB以上である必要があります。

   次のコマンドを実行して、新しい永続ボリューム要求に関する情報を表示します。

   $ kubectl get pvc
   NAME      STATUS   VOLUME   CAPACITY   ACCESSMODES   STORAGECLASS   AGE
   fss-pvc   Bound    fss-pv   200Gi      RWX           pca-fss        2h

7. ポッドなどの他のオブジェクトを作成するときに、PVCを使用します。

   たとえば、次のポッドの定義から新しいポッドを作成できます。このポッド定義は、/persistent-storageでポッドによってマウントされるfss-pvc PVCをnginxボリュームとして使用するようにシステムに指示します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: fss-dynamic-app
   spec:
     containers:
       - name: nginx
         image: nginx:latest
         ports:
           - name: http
             containerPort: 80
         volumeMounts:
           - name: persistent-storage
             mountPath: /usr/share/nginx/html
     volumes:
     - name: persistent-storage
       persistentVolumeClaim:
         claimName: fss-pvc

   次のコマンドを実行して、ポッドが新しいPVCを使用していることを確認します:

   $ kubectl describe pod fss-dynamic-app