Container Service for Kubernetes:ossfs 1.0 の静的プロビジョニングボリュームの使用

RRSA の使用

AccessKey の使用

RRSA 方式

1. pv-oss-rrsa.yaml という名前のファイルを作成します。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     # PV 名
     name: pv-oss   
     # PV ラベル
     labels:    
       alicloud-pvname: pv-oss
   spec:
     capacity:
       # ボリューム容量を定義
       storage: 10Gi  
     # アクセスモード
     accessModes:  
       - ReadOnlyMany
     persistentVolumeReclaimPolicy: Retain
     csi:
       driver: ossplugin.csi.alibabacloud.com
       # PV 名 (metadata.name) と同じである必要があります
       volumeHandle: pv-oss  
       volumeAttributes:
         # 実際のバケット名に置き換えます
         bucket: "your-bucket-name"  
         # バケットのルートディレクトリまたは指定したサブディレクトリをマウントします
         path: /  
         # バケットが配置されているリージョンのエンドポイント
         url: "http://oss-cn-hangzhou-internal.aliyuncs.com"  
         otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
         authType: "rrsa"
         # 作成または変更した RAM ロール
         roleName: "demo-role-for-rrsa"
         # OSS リクエスト署名バージョン
         sigVersion: "v4"  

   パラメーター	説明
   storage	OSS ボリュームの容量を定義します。この値は、PV と PVC を一致させるためにのみ使用されます。
   accessModes	アクセスモードを設定します。ReadOnlyMany と ReadWriteMany をサポートします。 ReadOnlyMany を選択すると、ossfs は OSS バケットを読み取り専用モードでマウントします。
   persistentVolumeReclaimPolicy	PV のリクレームポリシー。OSS ボリュームは現在 Retain のみをサポートしており、PVC が削除された後も PV と OSS バケット内のデータは保持されます。
   driver	ドライバーのタイプを定義します。Alibaba Cloud OSS CSI プラグインを使用する場合、ossplugin.csi.alibabacloud.com である必要があります。
   volumeHandle	PV 名 (metadata.name) と同じである必要があります。
   bucket	マウントする OSS バケット。
   path	CSI コンポーネントのバージョン v1.14.8.32-c77e277b-aliyun 以降が必要です。 バケットのルートディレクトリからの相対マウントパスを指定します。デフォルトは / で、バケット全体をマウントします。 ossfs のバージョンが 1.91 より前の場合、指定された path は OSS バケットにすでに存在している必要があります。詳細については、「ossfs 1.91 以降の新機能」をご参照ください。
   url	OSS バケットへのアクセスエンドポイント。 クラスターノードとバケットが同じリージョンにある場合、または Virtual Private Cloud (VPC) 接続が確立されている場合は、内部エンドポイントを使用します。 マウントノードとバケットが異なるリージョンにある場合は、パブリックエンドポイントを使用します。 以下は、異なるアクセスエンドポイントの一般的なフォーマットです： 内部：http://oss-{{regionName}}-internal.aliyuncs.com または https://oss-{{regionName}}-internal.aliyuncs.com。 内部アクセスエンドポイントのフォーマット vpc100-oss-{{regionName}}.aliyuncs.com は非推奨です。できるだけ早く新しいフォーマットに切り替えてください。 パブリック：http://oss-{{regionName}}.aliyuncs.com または https://oss-{{regionName}}.aliyuncs.com。
   otherOpts	OSS ボリュームのカスタムパラメーターを -o *** -o *** の形式で入力します。例：-o umask=022 -o max_stat_cache_size=100000 -o allow_other。 説明の表示 umask：ossfs ファイルの読み取り権限を変更します。 例えば、umask=022 は ossfs ファイルの権限を 755 に変更します。これにより、SDK や OSS コンソールなど他の方法でアップロードされたファイルの権限問題 (デフォルトは 640) を解決します。読み書き分離や複数ユーザーアクセスの場合にこのパラメーターを設定することを推奨します。 max_stat_cache_size：メタデータキャッシュエントリの上限を設定します (例：100000)。オブジェクトのメタデータをメモリにキャッシュし、ls や stat などの操作のパフォーマンスを向上させます。 ただし、このキャッシュは OSS コンソール、SDK、または ossutil を介して行われたファイルの変更を即座に検出できません。これにより、アプリケーションが不整合なデータを読み取る可能性があります。厳密なデータ整合性が要件の場合は、このパラメーターを 0 (キャッシュを無効にする) に設定するか、stat_cache_expire パラメーターでキャッシュの有効期限を短くします。これにより、読み取りパフォーマンスは低下します。 allow_other：マウントしたユーザー以外のユーザーがマウントポイント内のファイルやディレクトリにアクセスできるようにします。これは、マウントしていないユーザーもデータにアクセスする必要がある複数ユーザー共有環境に適しています。 その他のオプションパラメーターについては、「マウントオプション」および「ossfs 1.0 設定のベストプラクティス」をご参照ください。
   authType	RRSA 認証を使用するために rrsa に設定します。
   roleName	作成または変更した RAM ロールに設定します。 異なる PV に異なる権限を設定するには、異なる RAM ロールを作成し、PV で異なる roleName 値を指定します。
   sigVersion	OSS サーバーへのリクエストの署名バージョン。 "v1" (デフォルト)：OSS 署名バージョン 1 を使用します。 "v4" (推奨)：OSS 署名バージョン 4 を使用します。

   デフォルトの RRSA 認証が要件を満たさない場合 (例えば、デフォルト以外の ServiceAccount やサードパーティの OIDC を使用する場合)、PV 設定を変更して特定の ARN または ServiceAccount を指定できます。詳細については、「RRSA 認証で指定の ARN または ServiceAccount を使用するにはどうすればよいですか？」をご参照ください。

2. PV を作成します。

   kubectl create -f pv-oss-rrsa.yaml

AccessKey 方式

apiVersion: v1
kind: Secret
metadata:
  name: oss-secret
  # アプリケーションが存在する名前空間と同じである必要があります
  namespace: default
stringData:
  # 取得した AccessKey ID に置き換えます
  akId: <your AccessKey ID>
  # 取得した AccessKey Secret に置き換えます
  akSecret: <your AccessKey Secret>

kubectl

1. pvc-oss.yaml という名前のファイルを作成します。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     # PVC 名
     name: pvc-oss
     namespace: default
   spec:
     # アクセスモードを設定します。ReadOnlyMany は、ossfs が OSS バケットを読み取り専用モードでマウントすることを示します。
     accessModes:
       - ReadOnlyMany
     resources:
       requests:
         # ストレージ容量を宣言します。これは、ボリュームの合計容量を超えることはできません。
         storage: 10Gi
     selector:
       matchLabels:
         # ラベルで PV を照合します
         alicloud-pvname: pv-oss

2. PVC を作成します。

   kubectl create -f pvc-oss.yaml

3. PVC のステータスを確認します。

   kubectl get pvc pvc-oss

   出力結果から、PVC のステータスが Bound になり、PV にバインドされたことがわかります。

   NAME      STATUS   VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS   VOLUMEATTRIBUTESCLASS   AGE
   pvc-oss   Bound    pv-oss   10Gi       ROX                           <unset>                 6s

コンソール

1. クラスター ページで、目的のクラスターを見つけ、その名前をクリックします。 左側のペインで、[ボリューム] > [永続ボリューム要求] を選択します。

2. [永続ボリューム要求] ページで、[作成] をクリックします。 [PVC タイプ] として [OSS] を選択し、指示に従ってパラメーターを設定します。

   主要なパラメーターは次のとおりです。

   パラメーター	説明
   プロビジョニングモード	[既存の PersistentVolume を使用] を選択します。 PV を作成していない場合は、[プロビジョニングモード] を [PersistentVolume の作成] に設定し、PV パラメーターを設定できます。
   合計容量	PVC の容量です。PV の容量を超えることはできません。

kubectl

1. oss-static.yaml という名前のファイルを作成します。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: oss-static
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
           ports:
           - containerPort: 80
           volumeMounts:
             # コンテナー内のマウントパス
             - name: pvc-oss
               mountPath: "/data"
           # ヘルスチェックの設定
           livenessProbe:
             exec:
               command:
               - ls
               - /data
             initialDelaySeconds: 30
             periodSeconds: 30
         volumes:
           - name: pvc-oss
             persistentVolumeClaim:
               # 作成した PVC を参照
               claimName: pvc-oss

2. アプリケーションを作成します。

   kubectl create -f oss-static.yaml

3. マウント結果を確認します。

   • Pod のステータスが Running であることを確認します。

     kubectl get pod -l app=nginx

   • Pod に入り、マウントポイントを検査します。

     kubectl exec -it <pod-name> -- ls /data

     出力には、OSS マウントパスのデータが表示されます。

コンソール