Container Service for Kubernetes:Mount an OSS Bucket by using an ossfs 1.0 dynamically provisioned volume

1. ストレージクラスの作成

1. Secret を作成します。Secret の名前空間は、アプリケーションの名前空間と同じである必要があります。

   <yourAccessKey ID> と <yourAccessKey Secret> を、取得した AccessKey ID と AccessKey Secret に置き換えてください。

   kubectl create secret generic oss-secret --from-literal='akId=<yourAccessKey ID>' --from-literal='akSecret=<yourAccessKey Secret>'

2. StorageClass を作成します。

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

      apiVersion: storage.k8s.io/v1
      kind: StorageClass
      metadata:
        name: sc-oss
      parameters:
        # 実際のバケット名に置き換えてください。
        bucket: bucket
        # マウントするバケットのルートディレクトリまたは指定されたサブディレクトリ。
        path: /
        # バケットが配置されているリージョンのエンドポイント。
        url: "http://oss-cn-hangzhou-internal.aliyuncs.com" 
        # AccessKey 情報を保存する Secret の名前。
        csi.storage.k8s.io/node-publish-secret-name: oss-secret
        # AccessKey 情報を保存する Secret が存在する名前空間。
        csi.storage.k8s.io/node-publish-secret-namespace: default
        # カスタムパラメーター。
        otherOpts: "-o umask=022 -o max_stat_cache_size=100000 -o allow_other"
      # Alibaba Cloud OSS CSI プラグインを使用する場合、この値は固定です。
      provisioner: ossplugin.csi.alibabacloud.com
      # 動的にプロビジョニングされた PV のリクレームポリシー。
      reclaimPolicy: Retain
      # バインディングモード。
      volumeBindingMode: Immediate
      

      パラメーター	説明
      name	StorageClass の名前。
      bucket	マウントする OSS バケット。
      path	CSI コンポーネントのバージョン v1.14.8.32-c77e277b-aliyun 以降が必要です。 バケットのルートディレクトリからの相対的なマウントパスを指定します。デフォルトは / で、バケット全体をマウントします。 ossfs のバージョンが 1.91 より前の場合、指定された path は OSS バケットに既に存在している必要があります。詳細については、「ossfs 1.91 以降の新機能」をご参照ください。
      url	OSS バケットへのアクセスエンドポイント。 クラスターノードとバケットが同じリージョンにある場合、または 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。
      csi.storage.k8s.io/node-publish-secret-name	AccessKey 情報を保存する Secret の名前。
      csi.storage.k8s.io/node-publish-secret-namespace	AccessKey 情報を保存する Secret が存在する名前空間。
      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 設定のベストプラクティス」をご参照ください。
      provisioner	ドライバータイプ。Alibaba Cloud OSS CSI プラグインを使用する場合、この値は ossplugin.csi.alibabacloud.com に固定されます。
      reclaimPolicy	動的にプロビジョニングされた PV のリクレームポリシー。OSS 永続ボリュームは現在 Retain のみをサポートしています。これは、PVC を削除しても、PV と OSS バケット内のデータは削除されないことを意味します。
      volumeBindingMode	関連付けモード。 OSS 永続ボリュームはゾーンベースのノードアフィニティを必要としません。デフォルト値の Immediate を使用できます。
      volumeAs	ボリュームのアクセスモード。デフォルト値は sharepath です。有効な値： subpath は、CSI コンポーネントのバージョンが 1.31.3 以降の場合にのみ有効です。それ以外の場合は、sharepath が使用されます。 sharepath：共有モードでマウントします。すべてのボリュームがマウントパスを共有します。データは <bucket>:<path>/ に保存されます。 subpath：サブディレクトリモードでマウントします。ボリュームが作成されると、マウントパスの下にサブディレクトリが自動的に作成されます。データは <bucket>:<path>/<pv-name>/ に保存されます。
      sigVersion	OSS サーバーへのリクエストの署名バージョン。 "v1" (デフォルト)：OSS 署名バージョン 1 を使用します。 "v4" (推奨)：OSS 署名バージョン 4 を使用します。

   2. StorageClass を作成します。

      kubectl apply -f sc-oss.yaml

1. ステップ 1 で取得した AccessKey を、PV が使用する Secret として保存します。

   1. クラスター ページで、変更したいクラスターの名前をクリックします。左側のナビゲーションウィンドウで、[設定] > シークレット を選択します。

   2. [YAML から作成] をクリックし、画面の指示に従って Secret を作成します。

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

2. クラスター ページで、対象のクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、[ボリューム] > [StorageClass] を選択します。

3. [StorageClass] ページで、[作成] をクリックします。[PV タイプ] を OSS に設定し、プロンプトに従って StorageClass パラメーターを構成します。

   設定項目	説明
   アクセス証明書	OSS へのアクセスに必要な Secret を設定します。これは、取得した AccessKey ID と AccessKey Secret です。
   バケット ID	使用する OSS バケット。 設定した AccessKey でアクセスできるバケットのみがここに表示されます。
   OSS パス	CSI コンポーネントのバージョン v1.14.8.32-c77e277b-aliyun 以降が必要です。 バケットのルートディレクトリからの相対的なマウントパスを指定します。デフォルトは / で、バケット全体をマウントします。 ossfs のバージョンが 1.91 より前の場合、指定された path は OSS バケットに既に存在している必要があります。詳細については、「ossfs 1.91 以降の新機能」をご参照ください。
   ボリュームモード	ボリュームのアクセスモード。デフォルトモードは [共有ディレクトリ] です。有効な値： [サブディレクトリ] モードは、CSI コンポーネントのバージョンが 1.31.3 以降の場合にのみ有効です。それ以外の場合は、[共有ディレクトリ] モードが使用されます。 [共有ディレクトリ] (sharepath)：すべてのボリュームがマウントパスを共有します。データは <bucket>:<path>/ に保存されます。 [サブディレクトリ] (subpath)：ボリュームが作成されると、マウントパスの下にサブディレクトリが自動的に作成されます。データは <bucket>:<path>/<pv-name>/ に保存されます。
   エンドポイント	OSS バケットへのアクセスエンドポイント。 クラスターノードとバケットが同じリージョンにある場合、または 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。 内部ネットワーク経由でアクセスする場合、デフォルトで HTTP プロトコルが使用されます。HTTPS を使用するには、kubectl 方式を使用します。
   回収ポリシー	動的にプロビジョニングされた PV のリクレームポリシー。OSS 永続ボリュームは現在 Retain のみをサポートしています。これは、PVC を削除しても、PV と OSS バケット内のデータは削除されないことを意味します。
   オプションパラメーター	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 設定のベストプラクティス」をご参照ください。