tencent cloud

Cloud Object Storage

GooseFS-Lite・ツール

PDF
フォーカスモード
フォントサイズ
最終更新日: 2026-04-24 15:17:22

機能説明

GooseFS-Liteツールは、オブジェクトストレージ(Cloud Object Storage、COS)のバケットをローカルにマウントすることをサポートします。これにより、ローカルファイルシステムを使用するように、Tencent Cloudのオブジェクトストレージ内のオブジェクトを直接操作できます。COSFSツールと比較して、GooseFS-Liteはより高い大ファイルの読み書き速度を提供し、ローカルディスクの性能制限を受けません。GooseFS-Liteは、ファイルの順次読み取り、ランダム読み取り、順次書き込み、ディレクトリ操作などのPOSIXファイルシステムの主要機能をサポートします。

使用上の制限

GooseFS-Liteは、マウント後のファイルに対する簡易的な管理にのみ適しており、ローカルファイルシステムの一部の機能や使用方法をサポートしていません。以下の使用制限にご注意ください:
ランダム書き込みおよびtruncate操作をサポートしていません。
複数のクライアントが同一のCOSバケットをマウントする場合、複数のクライアント間の動作調整はユーザー自身で行う必要があります。例えば、複数のクライアントが同一ファイルに書き込むことを避けるなどです。
ファイル/フォルダのrename操作はアトミック操作ではありません。
現在マウントポイントで書き込み中のファイルの読み取りおよびrenameをサポートしていません。
メタデータ操作、例えばlist directoryなどは、リモートでCOSサーバーにアクセスする必要があるため、パフォーマンスが低下します。
ソフトリンクおよびハードリンクをサポートしていません。
追記書き込みのパフォーマンスが低下します、サーバー側でのデータコピーと追記対象ファイルのダウンロードが伴うためです。
小メモリ環境での使用はお勧めしません、例えばコンテナメモリまたはCVMメモリが2G未満の場合などです。
コンテナ環境では現在、Tencent Cloudコンテナサービス(Tencent Kubernetes Engine、TKE)内での使用のみをサポートしており、非TKEコンテナは現時点ではサポートしていません。
大量のランダム読み取りが発生し、かつ高いパフォーマンスが求められるシナリオでの使用はお勧めしません。
注意:
パブリックネットワークでのマウントおよび非低頻度ストレージでの追記書き込み操作には、ダウンロードトラフィック料金が発生します。

使用環境

Linux X86_64

使用方法。

ステップ1:依存関係をインストールします。

CentOS/TencentOS Server

yum install -y fuse-devel

Ubuntu

apt install -y libfuse-dev

その他のLinuxディストリビューション

libfuse2.9.7のコンパイルとインストールを行います。
wget "https://github.com/libfuse/libfuse/releases/download/fuse-2.9.7/fuse-2.9.7.tar.gz"
tar xvf fuse-2.9.7.tar.gz
cd fuse-2.9.7
./configure
make -j8
make install

ステップ2:GooseFS-Liteをインストール

GooseFS-Liteをカレントディレクトリにインストールし、goosefs-liteのシンボリックリンクを/usr/bin/goosefs-liteに作成します。これにより、後でgoosefs-liteコマンドを直接使用できるようになります。
curl -fssL https://downloads.tencentgoosefs.cn/goosefs-lite/install.sh | sh -x
cd goosefs-lite-*
sudo bash bin/install.sh

手順3:KonaJDK11をインストールします。

goosefs-lite-<具体バージョン>ディレクトリ(例:1.0.6バージョンの場合、goosefs-lite-1.0.6ディレクトリ)で以下のコマンドを使用し、KonaJDKを/usr/local/konajdk11にインストールします:
sudo bash bin/install-jdk.sh https://github.com/Tencent/TencentKona-11/releases/download/kona11.0.22/TencentKona-11.0.22.b1-jdk_linux-x86_64.tar.gz
以下の通り、2つの方法から選択できます:
1. KonaJDKのダウンロードリンクを使用する 2. KonaJDKインストールパッケージを指定ディレクトリにダウンロードする 以下のコマンドを使用してインストールします。これにより、goosefs-liteは自動的にそのJavaランタイムを使用します。
Usage:
Command: install-jdk.sh http[s]://host/path
Example: install-jdk.sh https://github.com/Tencent/TencentKona-11/releases/download/kona11.0.22/TencentKona-11.0.22.b1-jdk_linux-x86_64.tar.gz
or
Command: install-jdk.sh /path/to/jdk.tar.gz
Example: install-jdk.sh /Downloads/TencentKona-11.0.22.b1-jdk_linux-x86_64.tar.gz
Java環境をより柔軟にインストールしたい場合、手動JDKインストールを参考にすることができます。また、conf/goosefs-env.sh で環境変数を変更して有効にします。

ステップ4:設定ファイルを変更します。

goosefs-lite-<具体バージョン>ディレクトリ(例:1.0.6バージョンの場合、goosefs-lite-1.0.6ディレクトリ)で設定ファイルを修正するには、以下の2つの方法があります:
sedを使用して以下の3つのパラメータを変更します。SECRET_ID、SECRET_KEY、REGIONは実際の値に置き換えてください。
fs.cosn.userinfo.secretKeyをTencent CloudのキーKeyに設定します。
fs.cosn.userinfo.secretIdをTencent CloudのキーIDに設定します。
fs.cosn.bucket.regionをバケットリージョンに設定します。
sed -i '/<name>fs.cosn.userinfo.secretId<\\/name>/{N;s/<value>[^<]*<\\/value>/<value>$SECRET_ID<\\/value>/}' conf/core-site.xml
sed -i '/<name>fs.cosn.userinfo.secretKey<\\/name>/{N;s/<value>[^<]*<\\/value>/<value>$SECRET_KEY<\\/value>/}' conf/core-site.xml
sed -i '/<name>fs.cosn.bucket.region<\\/name>/{N;s/<value>[^<]*<\\/value>/<value>$REGION<\\/value>/}' conf/core-site.xml
また、vimを使用してconf/core-site.xmlファイルを編集し、パラメータを変更することもできます。
fs.cosn.userinfo.secretKeyをTencent CloudのキーKeyに設定します。
fs.cosn.userinfo.secretIdをTencent CloudのキーIDに設定します。
fs.cosn.bucket.regionをバケットリージョンに設定します。

設定ファイルの説明

goosefs-lite-<具体バージョン>/confディレクトリ(例:1.0.6バージョンの場合、goosefs-lite-1.0.6/confディレクトリ)で、以下のファイルを確認できます。
acl-site.properties:ディレクトリの権限、ユーザー名、グループ名、Linux POSIXセマンティクスに類似する0755、uid、gidなどを指定します。
説明:
acl-siteの設定フォーマットはパス=モード:ユーザー名:グループ名です。例えば、/mnt/goosefs-lite/test_dirパスに755モード、rootユーザー、rootユーザーグループを設定する場合、設定ファイルで/mnt/goosefs-lite/test_dir=755:root:rootと設定します。
ACL設定を使用する場合、マウント時に-o default_permissionsパラメータを指定する必要があります。カーネル(VFS)がファイルメタデータのmode/uid/gidに基づいて標準のUnix権限チェックを行います。同時に、マウント前にgoosefs-lite.properties設定ファイルで設定項目goosefs.lite.posix.acl.manager.enabledtrueに変更または追加する必要があります。例えば、testbucket-1250000000を/mnt/datadisk0/goosefs-lite-mntにマウントするコマンドは以下の通りです:./bin/goosefs-lite mount -o "allow_other,default_permissions" /mnt/datadisk0/goosefs-lite-mnt cosn://testbucket-1250000000/
core-site.xml:Hadoop-COSの設定ファイル(goosefs-liteのデータフローはHadoop-COSをベースとしているため、パラメータと設定ファイルはほぼ共通です)。
goosefs-env.sh:各種環境変数(JVMパラメータなど)を設定します。
goosefs-lite.properties:goosefs-lite関連の設定。
log4j.properties:ログ設定。デバッグログを有効化する必要がある場合、当該ファイルの最終行のコメントアウトを解除し、再マウントします。
注意:
ユーザーは設定で永続キーを使用することを避けるよう努めることをお勧めします。サブアカウントキーまたは一時キーを設定する方式を採用することは、ビジネスセキュリティの向上に役立ちます。サブアカウントに権限を付与する際は、必要に応じてサブアカウントが実行可能な操作とリソースを権限付与することをお勧めします。これにより、予期しないデータ漏洩を防止できます。
永続キーをどうしても使用する必要がある場合は、永続キーの権限範囲を制限することをお勧めします。永続キーの実行可能な操作、リソース範囲、および条件(アクセスIPなど)を制限することで、使用時のセキュリティを向上させてください。

ステップ5:バケットをローカルディレクトリにマウントします

goosefs-lite-<具体バージョン>ディレクトリ(例:1.0.6バージョンの場合、goosefs-lite-1.0.6ディレクトリ)で以下のコマンドを実行し、キーファイルに設定されたバケットを指定ディレクトリにマウントします:
./bin/goosefs-lite mount <MountPoint> cosn://<BucketName>/
ここで:
<MountPoint>はローカルのマウントディレクトリです(例:/mnt/goosefs-lite-mnt-dir)。このディレクトリは空でなければならず、そうしないとマウントできません。
<BucketName>はバケット名です(例:examplebucket-1250000000)。
例:
mkdir -p /mnt/goosefs-lite-mnt
./bin/goosefs-lite mount /mnt/goosefs-lite-mnt/ cosn://examplebucket-1250000000/
ローカルのマウントポイントと対応するCOSバケットを表示します。出力情報は順にプロセスID、ローカルマウントポイント、COSパスです。
$ ./bin/goosefs-lite stat
pid mount_point cos_path
13815 /mnt/goosefs-lite-mnt/ cosn://examplebucket-1250000000/
コマンドラインで複数のマウントパラメータを同時に指定する必要がある場合、カンマで複数のパラメータを区切って指定できます。以下のコマンドはマウントポイントを読み取り専用に設定し、かつ他のユーザーがマウントポイントにアクセスすることを許可します:
./bin/goosefs-lite mount -o "ro,allow_other" mnt/ cosn://examplebucket-1250000000/
ここで:
-o allow_other:他のユーザーがマウントフォルダにアクセスできるようにする場合、GooseFS-Liteを実行する際にこのパラメータを指定できます。
-o ro:マウントポイントを読み取り専用に設定します。書き込みと削除操作は許可されません。
説明:
単一のパラメータは-oで指定できます。例えば-o roです。複数のパラメータはカンマで区切って指定できます。例えば-o "ro,allow_other"です。

ステップ6:マウントポイントのアンマウント

説明:
GooseFS-Liteのマウントポイントをアンマウントすると、このパスを介したCOSへのすべての読み書き操作が即座に中断されます。操作前に、現在ビジネスプロセスが当該マウントディレクトリを使用していないことを確認してください。
goosefs-lite-<具体バージョン>ディレクトリ(1.0.6バージョンを例として、goosefs-lite-1.0.6ディレクトリ)で、以下のコマンドを実行することでマウントポイントをアンマウントします。
$ ./bin/goosefs-lite umount /mnt/goosefs-lite-mnt
Unmount fuse at /mnt/goosefs-lite-mnt/ (PID: 17206).

# アンマウントに異常がある場合、以下のコマンドを使用して強制的にアンマウントできます。
$ sudo umount -l /mnt/goosefs-lite-mnt

ステップ7:パラメータチューニング

GooseFS-Liteは2つの設定ファイルを含みます。それぞれconf/core-site.xmlとconf/goosefs-lite.propertiesです。
conf/core-site.xmlを変更することで、アップロードおよびダウンロードの帯域幅をチューニングできます。よく使われるパラメータは以下の通りです。その他のパラメータについてはHadoop-COSドキュメントを参照してください。
属性キー
説明
デフォルト値
必須項目
fs.cosn.useHttps
HTTPSをCOSバックエンドとの通信プロトコルとして使用するかどうかを設定します。
true
いいえ
fs.cosn.upload.part.size
マルチパートアップロードにおける各パートサイズ。COSのマルチパートアップロードは最大10000ブロックまでしかサポートしていないため、想定される最大単一ファイルサイズを予測する必要があります。例えば、パートサイズが8MBの場合、最大78GBの単一ファイルアップロードをサポートできます。パートサイズは最大2GBまでサポート可能であり、つまり単一ファイルの最大サイズは19TBまでサポートできます。
8388608(8MB)
いいえ
fs.cosn.upload_thread_pool
ファイルをストリーミングでCOSにアップロードする際の、同時アップロードスレッド数です。
32
いいえ
fs.cosn.read.ahead.block.size
これはプリフェッチブロックのサイズです。
1048576(1MB)
いいえ
fs.cosn.read.ahead.queue.size
プリフェッチキューの長さ。
6
いいえ
conf/goosefs-lite.propertiesを変更することで、GooseFS-Liteの動作を調整できます。よく使われるパラメータは以下の通りです。
プロパティ。
説明
デフォルト値
必須項目
goosefs.fuse.list.entries.cache.enabled
クライアントのListキャッシュを有効化するかどうかです。
true
いいえ
goosefs.fuse.list.entries.cache.max.size
クライアントのListにおける最大キャッシュエントリ数です。単位:件
100000
いいえ
goosefs.fuse.list.entries.cache.max.expiration.time
クライアントのListキャッシュの有効時間です。単位:ms
15000
いいえ
goosefs.fuse.async.release.max.wait.time
openおよびrename操作のファイルが書き込み中の場合、書き込み操作の完了を待機する時間です。単位:ms
5000
いいえ
goosefs.fuse.umount.timeout
ファイルシステムをアンマウントする際の未完了操作の終了待機時間です。単位:ms
120000
いいえ
お客様の読み取りと書き込みの同時実行度が高い場合、以下の方法でGooseFS-Liteの最大JVM実行メモリを調整でき、Full GCとOutOfMemoryErrorを回避できます。JVMのデフォルト値は -Xmx512m -XX:MaxDirectMemorySize=512m -XX:+UseG1GC -XX:G1HeapRegionSize=32m であり、調整方法は以下の通りです:
export JAVA_OPTS="-Xms2G -Xmx2G"
./bin/goosefs-lite mount /mnt/goosefs-lite-mnt/ cosn://examplebucket-1250000000/
ps -ef|grep goosefs-lite|grep -v grep

よくあるご質問

libfuseライブラリファイルが不足している場合の対処方法です。


img


libfuseのインストールが必要です。以下の方法を参照してください。
方法1
1. 以下のコマンドを実行して、fuse-develをインストールします。
CentOSまたはTencentOSシステムの場合、以下のコマンドを実行します:
yum install fuse-devel
Ubuntuシステムの場合、以下のコマンドを実行します:
apt install libfuse-dev
2. インストールが完了した後、以下のコマンドを実行し、インストールが成功したかどうかを確認します。
find / -name libfuse.so*
方法2
古いバージョンのlibfuse.so.2.9.2をアップデートするインストール手順は以下の通りです:
説明:
CentOS 7はデフォルトでlibfuse.so.2.9.2をインストールします。
1. libfuse ソースコードをダウンロードし、ビルドして libfuse.so.2.9.7 を生成します。
tar -zxvf fuse-2.9.7.tar.gz
cd fuse-2.9.7/ && ./configure && make && make install
echo -e '\\n/usr/local/lib' >> /etc/ld.so.conf
ldconfig
2. libfuse.so.2.9.7をビルドおよび生成した後、以下の手順に従って置換します:
2.1 以下のコマンドを実行し、古いバージョンのlibfuse.so.2.9.2ライブラリリンクを検索します。
find / -name libfuse.so*
2.2 以下のコマンドを実行し、libfuse.so.2.9.7を古いバージョンのライブラリlibfuse.so.2.9.2の場所にコピーします。
cp /usr/local/lib/libfuse.so.2.9.7 /usr/lib64/
2.3 以下のコマンドを実行し、古いバージョンのlibfuse.soライブラリのすべてのリンクを削除します。
rm -f /usr/lib64/libfuse.so
rm -f /usr/lib64/libfuse.so.2
2.4 以下のコマンドを実行し、削除された古いバージョンのリンクと同様のlibfuse.so.2.9.7ライブラリリンクを作成します。
ln -s /usr/lib64/libfuse.so.2.9.7 /usr/lib64/libfuse.so
ln -s /usr/lib64/libfuse.so.2.9.7 /usr/lib64/libfuse.so.2

起動時にマウントを設定する方法

1. /usr/lib/systemd/system/goosefs-lite.service ファイルを編集し、以下の内容を追加します。examplebucket-1250000000 はお客様のバケットに置き換えてください。 注意:以下のJAVA_OPTSにおける-Xmsと-Xmxの設定メモリ値は、所在ノードの物理メモリ上限の50%を超えてはいけません。例えばノードの物理メモリが16GBの場合、-Xms8G -Xmx8Gまで設定することを推奨します。
以下では goosefs-lite-1.0.6 バージョンを例とします。
[Unit]
Description=The Tencent Cloud GooseFS Lite for COS
Requires=network-online.target
After=network-online.target

[Service]
Type=forking
User=root
Environment="JAVA_OPTS=-Xms2G -Xmx4G -XX:MaxDirectMemorySize=1G -XX:+UseG1GC -XX:G1HeapRegionSize=32m"
ExecStart=/usr/local/goosefs-lite-1.0.6/bin/goosefs-lite mount /mnt/goosefs-mnt cosn://examplebucket-1250000000/
ExecStop=/usr/local/goosefs-lite-1.0.6/bin/goosefs-lite umount /mnt/goosefs-mnt
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
2. 以下のコマンドを実行し、マウントコマンドを実行してバックグラウンドのデーモンプロセスのステータスを確認します。
# goosefs-liteのsystemd設定を有効にする
systemctl daemon-reload
# バックグラウンドのFuseプロセスを起動します
systemctl start goosefs-lite
# バックグラウンドのデーモンプロセスのステータスを確認します
systemctl status goosefs-lite
# マウントポイントリストを確認します。
/usr/local/goosefs-lite-1.0.6/bin/goosefs-lite stat
# systemd設定を変更した場合、変更後にreloadおよびrestartを実行します。
起動時にマウントを試行するように設定:
systemctl enable goosefs-lite
3. マウントポイントをアンマウントし、マシンを再起動して、Fuseプロセスのステータスを確認します。
# アンマウントを実行します。注意:データ書き込み中にアンマウントしないでください。そうしないと、データが不完全になります。
systemctl stop goosefs-lite
# OSの再起動は、業務に影響を与えないよう慎重に行ってください。
reboot -h now
# バックグラウンドのデーモンプロセスのステータスを確認します。
systemctl status goosefs-lite
# マウントポイントリストを確認します。
/usr/local/goosefs-lite-1.0.6/bin/goosefs-lite stat

GooseFS-Liteでは特定の時間帯にCPU使用率が高くなり、COSに対して大量のHeadおよびListリクエストを発行し、多量のリクエスト回数料金が発生する場合があります。どう対処すればよいでしょうか。

これは通常、マシン上にスキャンタスクが存在することが原因です。Linuxシステムで一般的なスキャンプログラムはupdatedbです。GooseFS-Liteのマウントポイントディレクトリを、updatedbの設定ファイルである/etc/updatedb.confのPRUNEPATHS設定項目に追加することで、このプログラムのスキャン動作を避けられます。さらに、Linuxツールのauditdを使用して、GooseFS-Liteマウントポイントにアクセスするプログラムを確認できます。
説明:
1. auditdをインストールします。
Ubuntuシステムの場合、以下のコマンドを実行します:
apt-get install auditd -y
CentOSシステムの場合、以下のコマンドを実行します:
yum install audit audit-libs
2. auditdサービスを起動します。
systemctl start auditd
systemctl enable auditd
3. マウントディレクトリを監視します。
説明:
-w はGooseFS-Liteのマウントディレクトリを指定します、-k はauditログに出力するキーです。
auditctl -w /usr/local/service/mnt/ -k goosefs_lite_mnt
4. ログに基づいてアクセスプログラムを特定します。
auditのログディレクトリ: /var/log/audit、検索コマンドは以下の通りです。
ausearch -i|grep 'goosefs_lite_mnt'
5. auditdサービスを停止します。
auditdサービスを停止する必要がある場合は、以下のコマンドを使用できます:
/sbin/service auditd stop
注意:
もしマウントポイントにアクセスしているプログラムがずっと実行中である場合、新しく起動したauditdは、そのプログラムのアクセス動作を監視しません。プログラム内でのマウントディレクトリに対する複数の呼び出しは、最初の呼び出しのみ記録されます。

GooseFS-Liteのインストール時に「cannot allocate memory」エラーが発生した場合の対処方法です。




このエラーは主にGooseFS-Liteの実行中にメモリ割り当て異常が発生したためです。一般的には、要求メモリが実際に利用可能なメモリを超えている場合に発生します。
./bin/goosefs-lite ファイル内のJAVA_OPTSパラメータ設定を適切なメモリ数値に変更できます。少なくとも、要求するメモリ量がインスタンスの利用可能メモリ量を下回ることを保証する必要があります。

最新パッケージバージョンの確認方法は?

以下のコマンドを実行します。戻り値が最新バージョン番号となります。

ログの確認方法を教えてください。

問題の調査にはログに依存する必要があり、関連ログの場所は以下にあります。
goosefs-lite 1.0.3バージョンおよびそれ以降では、デフォルトのログディレクトリは/data/goosefs/logs/fuseの下にあります。
例えば、goosefs-liteをマウントしたユーザーがrootで、マウントポイントのパスが/data1/data2である場合、ログパスは/data/goosefs/logs/fuse/root/data1/data2となります。
goosefs-lite 1.0.0-1.0.2バージョンについては、デフォルトのログディレクトリは/data/goosefs/logsの下にあります。

マウントポイントのログパスを確認する別の方法として、まず再マウントを行い、次にps aux | grep ${MOUNT_POINT}を実行します。出力からError_Fileまたはgoosefs.logs.dirを確認でき、このパスの親ディレクトリがそのマウントポイントのすべてのログの保存場所となります。
システムログ:CentOSまたはtlinuxシステムの場合は/var/log/message*、Ubuntuの場合は/var/log/syslogとなります。
デバッグログを有効化する必要がある場合、conf/log4j.propertiesに入り、最下行の内容をコメントアウトし、再マウントします。
注意:
デバッグログを有効化するとパフォーマンスに影響を与える可能性があります。通常時は有効化する必要はありません。

マウント失敗のエラー「Name or service not known」の対処方法を説明します。




通常、ドメイン名を解決できないことが原因です。対応するドメイン名に対してpingを実行して確認できます。上記の図に示されているエラーについては、以下のコマンドを実行します:
ping VM-36-104-centos
同様に失敗した場合、/etc/hostsを変更することで、対応するIPを設定できます。一般的には127.0.0.1を設定します。
操作の手順は次のとおり:
1. /etc/hostsファイルに1行追加します。ここの「VM-36-104-centos」はご自身のホスト名に置き換えてください。
127.0.0.1 VM-36-104-centos
2. その後、再度pingテストを実行し、正常に解決されることを確認した後、再度マウントしてください。

デフォルト環境のJDKがKonaJDK11ではない場合、GooseFS-Liteをどのように使用しますか。

1. KonaJDK11のパッケージをダウンロードして解凍します。
2. konajdk内のjavaバイナリプログラムの絶対パスをコピーします。例として、解凍されたjdkは/root/konajdk11にあります。
# javaバージョンの確認
/root/konajdk11/bin/java -version
# 現在のシェルのJAVA環境変数を変更(他のシェルやプロセスに影響なし)
export JAVA=/root/konajdk11/bin/java
# マウント
goosefs-lite mount /mnt cosn://bucket-appid
3. ps aux | grep goosefs-liteを使用すると、プロセスの先頭が/root/konajdk11/bin/javaであることが確認できます。これにより、指定したjavaバージョンが使用されていることが説明されています。操作が完了しました。

マウントポイントは本来正常に動作していましたが、使用中に突然正常に使用できなくなりました。対応方法はありますか。

現在の問題のマウントポイントは/tmp/mount_pointであるとします。
1. まず ps aux | grep /tmp/mount_point を実行し、このマウントポイント(goosefs-liteを含む)を使用しているプロセスが現在あるかどうかを確認します。もしある場合は、killコマンドを使用して対応するプロセスを終了します。
2. lsコマンドでマウントポイントへのアクセスを試み、結果が空の場合はマウントポイントのアンマウントが成功したことを示します。その後、再マウントしてください。
ls /mount_point
3. transport is not connected のようなエラーがスローされた場合は、umount -l /mount_pointを実行して強制アンマウントする必要があります。(このコマンドの実行にはroot権限が必要です)
通常このような状況は、プロセスが kill -9 またはシステムのoom-killerによって終了された場合に発生します。システムログまたはgoosefs-liteログで確認できます。
4. /data/goosefs/logs/fuse/$USER/$MOUNT_POINTディレクトリにhs_errorで始まるログがあるかどうかを確認します(ファイルにはプログラム終了前のスタックと原因が記述されています)。

サポートされていない、または認識できないSSLメッセージの例外がスローされた場合の対処方法。

現在の環境ではhttpsモードを無効化することはサポートされていません。設定を変更する必要があります。解決策としては、core-site.xml設定ファイルに以下の内容を追加します:
<property>
<name>fs.cosn.useHttps</name>
<value>false</value>
</property>

GooseFS-Liteを使用してプライベートネットワークドメイン名でCOSにアクセスする方法。

core-site.xml設定ファイルで、fs.cosn.bucket.regionプロパティを削除し、fs.cosn.bucket.endpoint_suffixパラメータを追加します(goosefs-lite 1.0.12以降のバージョンを使用している場合は、fs.cosn.custom.endpoint_suffixパラメータを追加します)。
詳細なパラメータについては、以下のドキュメントをご参照ください。

マウント時または使用中に403 Forbiddenエラーが発生した場合の対処方法について説明します。

通常、ログではERRORタイプのログにはどの権限が不足しているかが記述されています。必要に応じて追加してください。
注意:head bucket権限については、バケットレベルに設定する必要があり、パスレベルだけでは不十分です。例えば、cosn://bucket-appid/path は有効になりません。cosn://bucket-appid でなければなりません。この権限はバケット内のオブジェクトを公開しません。

エラー「fuse: failed to open /dev/fuse Operation not permitted」の対処方法です。

1. root権限を持っているかどうかを確認します。
2. コンテナ内の場合、コンテナ起動時に--privilegedが付いているかどうかを確認します。付いていない場合は追加してください。
3. fuseカーネルモジュールがインストールされているかどうかを確認します:コマンドlsmod | grep fuseを実行し、結果が返ってくるかどうかを確認します。何も返ってこない場合、fuseカーネルモジュールが不足していることを意味します。

ファイルの書き込みに失敗しました。エラー「 part num: 10001, the parameter partNumber is not valid.」が発生しました。対処方法を教えてください。

この状況は、マルチパートアップロードのパート数が制限を超えていることを示しています。COSは最大1万パートのアップロードのみサポートします。そのため、goosefs-liteはデフォルトで8MB*10000(約78GB)のファイルをサポートします。より大きなファイルをサポートする必要がある場合は、パラメータfs.cosn.upload.part.sizeを調整する必要があります。例えば、fs.cosn.upload.part.sizeを16777216(16MB)に変更すると、16MB*10000の大きなファイルをサポートできます。

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック