すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:ossfs 1.0 リリースノート

    ドキュメントセンター

    Container Service for Kubernetes:ossfs 1.0 リリースノート

    最終更新日:May 29, 2025

    ossfs 1.0 のバージョンは、Container Storage Interface（CSI）コンポーネントと共に反復されます。このトピックでは、ossfs 1.0 のリリースノートと、ossfs 1.0 のバージョンを表示および変更する方法について説明します。

    機能

    CSI を使用して Object Storage Service（OSS）ボリュームをマウントする場合、csi-plugin コンポーネントは ossfs プロセスを起動して、OSS サーバー上のオブジェクトをコンテナー内の指定されたパスにマウントします。 POSIX を使用して、通常のファイルの読み書きと同じ方法で、OSS サーバー上のオブジェクトを読み書きできます。これにより、クラウド内のリソースへのアクセスと管理が容易になります。

    ossfs 1.0 は、Linux のローカルファイルシステムに OSS バケットをマウントするために使用されるユーザースペースファイルシステムです。 ossfs 1.0 を使用すると、ローカルファイルの管理と同じ方法で OSS オブジェクトにアクセスして管理できます。 OSS オブジェクトをシームレスに管理および共有できます。 ossfs は次の機能を提供します。

    • ファイルとディレクトリのアップロードとダウンロード、ユーザー 権限 管理など、POSIX 標準で説明されているほとんどの機能をサポートします。

    • デフォルトでは、マルチパートアップロードと再開可能なアップロードを使用して OSS オブジェクトをアップロードします。

    • データ整合性を確保するために MD5 検証をサポートします。

    • ossfs は S3FS に基づいて開発されているため、すべての S3FS 機能をサポートします。

    バージョンの説明

    ossfs 1.0 のバージョンは、x.yy.z 形式で表示されます。

    • x.yy は、オープンソース s3fs に基づいて開発されたバージョンを示します。 CSI 環境変数を設定して、過去の x.yy バージョンにロールバックできます。

    • z は、ossfs の反復バージョンを示します。このバージョンには、OSS 環境と ACK 環境の最適化が含まれている場合があります。たとえば、このバージョンでは、新しい監視、認証、および暗号化機能が導入される場合があります。詳細については、「csi-plugin」をご参照ください。

    • オープンソース ossfs バージョンと ACK ossfs バージョンを区別するために、.ack.1 プレフィックスが ACK ossfs バージョンに追加されます（例：1.80.6.ack.1）。

    Ossfs メジャーバージョンのリリースノート

    重要

    ファイルシステムに高い要件がある場合は、ossfs 1.0 のバージョンを 1.91 以降に更新することをお勧めします。バージョン 1.91 以降の適用可能なシナリオの詳細については、「ossfs 1.0 をバージョン 1.91 以降に変更するためのベストプラクティス」をご参照ください。 ossfs 1.0 のバージョンを変更する方法については、「ossfs 1.0 のバージョンを 1.91 以降に変更する」をご参照ください。

    アーキテクチャ

    ossfs 1.0 バージョン

    CSI バージョン

    Arm64

    1.91 以降

    • v1.30.1-98960d8-aliyun（フィーチャーゲートを介して使用）

    • v1.30.4-fe12624-aliyun（デフォルトで使用）

    1.80.x

    v1.20.5-ff6490f-aliyun（ARM64 をサポートする最初の CSI バージョン）

    AMD64

    1.91 以降

    • v1.30.1-98960d8-aliyun（フィーチャーゲートを介して使用）

    • v1.30.4-fe12624-aliyun（デフォルトで使用）

    1.88.x

    v1.22.14-820d8870-aliyun

    1.86.x

    v1.16.9.43-f36bb540-aliyun

    1.80.x

    初期バージョン

    ossfs v1.91.0 以降の詳細なリリースノートについては、「バージョンの更新と新機能」をご参照ください。

    ossfs バージョンの表示

    • CSI バージョンが 1.28 より前で、1.26.6 を含まない場合、ossfs 1.0 はノード上で実行されます。任意のノードにログインし、次のコマンドを実行して ossfs 1.0 のバージョンを確認できます。

      /usr/local/bin/ossfs --version

    • CSI バージョンが 1.26.6、または 1.28.1 以降の場合、ossfs 1.0 はクラスター内のポッドのコンテナーとして実行されます。次の方法を使用して、ossfs 1.0 のバージョンをクエリできます。

      CSI 1.30.4 以降

      説明

      CSI バージョンが 1.30.4 以降の場合、OSS ボリュームがマウントされると、CSI コンポーネントは ack-csi-fuse 名前空間に関連するポッドを自動的に作成します。

      1. 実行中のポッドをクエリします。

        kubectl -n ack-csi-fuse get pod | grep csi-fuse-ossfs

      2. ossfs 1.0 のバージョンを確認します。

        kubectl -n ack-csi-fuse exec -it <csi-fuse-ossfs-xxxx> -- ossfs --version

      CSI 1.30.4 より前

      説明

      CSI バージョンが 1.30.4 より前の場合、OSS ボリュームがマウントされると、CSI コンポーネントは kube-system 名前空間に関連するポッドを自動的に作成します。

      1. 実行中のポッドをクエリします。

        kubectl -n kube-system get pod | grep csi-fuse-ossfs

      2. ossfs バージョンを確認します。

        kubectl -n kube-system exec -it <csi-fuse-ossfs-xxxx> -- ossfs --version

    ossfs 1.0 のバージョンを 1.91 以降に変更する

    方法 1：CSI バージョンを更新する

    CSI バージョン 1.30.4 以降では、ossfs 1.0 はデフォルトでバージョン 1.91 以降を使用します。 CSI をアップグレードすることで、ossfs 1.0 のバージョンを変更できます。

    方法 2：フィーチャーゲートを有効にする

    ossfs 1.0 のバージョンを 1.91 以降に変更するには、UpdatedOssfsVersion フィーチャーゲートを有効にする必要があります。これを行うには、次の手順を実行します。

    説明

    デフォルトでは、同じノード上の同じ OSS ボリュームをマウントするポッドは、1 つの ossfs プロセスを共有します。つまり、csi-fuse-ossfs-*** という名前のポッドがクラスター内で 1 つだけ起動されます。 UpdatedOssfsVersion フィーチャーゲートが有効になると、新しく起動された ossfs コンテナーは自動的に 1.91 以降のバージョンのイメージを使用します。 OSS ボリュームを使用しているサービスは影響を受けません。現在のサービスで使用されている ossfs バージョンのアップグレードを手動でトリガーするには、「共有マウントモードで ossfs プロセスを再起動する方法」をご参照ください。

    1. csi-plugin のバージョンが 1.30.1 以降であることを確認します。

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

      2. [クラスター] ページで、管理するクラスターを見つけて名前をクリックします。左側のナビゲーションウィンドウで、[操作] > [アドオン] を選択します。

      3. [アドオン] ページで、csi-plugin を見つけてバージョンを表示します。

        csi-plugin のバージョンが 1.30.1 より前の場合は、コンポーネントの右下隅にある [アップグレード] をクリックして、コンポーネントを最新バージョンにアップグレードします。

    2. UpdatedOssfsVersion フィーチャーゲートを有効にします。

      説明

      コンソールを使用してフィーチャーゲートを有効にすると、FeatureGate パラメーターは既存の設定を上書きします。 kubectl がすでに他のフィーチャーゲートを有効にするために使用されているかどうかを確認できない場合は、kubectl を使用して上記のフィーチャーゲートを有効にすることをお勧めします。

      kubectl の使用

      1. csi-plugin の DaemonSet ファイルを変更します。

        kubectl -n kube-system edit ds csi-plugin

      2. csi-plugin コンテナー（Init Container ではない）の args に、パラメーター --feature-gates=UpdatedOssfsVersion=true を追加します。

        説明

        他のフィーチャーゲートがすでに有効になっている場合は、次の形式を使用します：--feature-gates=xxxxxx=true,yyyyyy=false,UpdatedOssfsVersion=true。

        変更された args フィールド：

        - args:
  - --endpoint=$(CSI_ENDPOINT)
  - --v=2
  - --driver=oss,nas,disk
  - --feature-gates=UpdatedOssfsVersion=true

      コンソールを使用する

      1. csi-plugin コンポーネントをアップグレードした後、csi-plugin コンポーネントカードの [設定] をクリックします。

      2. [csi-plugin パラメーター] ページで、FeatureGate パラメーターを [UpdatedOssfsVersion=true] に設定し、[OK] をクリックします。

        他のフィーチャーゲートがすでに有効になっている場合は、xxxxxx=true,yyyyyy=false,UpdatedOssfsVersion=true の形式を使用します。

    関連情報

    ossfs 1.91 以降の新機能とパフォーマンステスト結果については、「ossfs 1.0 の新機能と ossfs パフォーマンスベンチマーク」をご参照ください。