troubleshooting-s3-files
Amazon S3ファイルシステムに関するマウント失敗、権限エラー、同期問題、パフォーマンス低下などのトラブルシューティングを行います。S3ファイルシステムがマウントできない、アクセス拒否が返される、変更がS3に同期されない、ファイルがlost+foundに表示される、または動作が遅いといった問題が発生した際に使用してください。
description の原文を見る
> Diagnoses and resolves Amazon S3 Files issues including mount failures, permission errors, synchronization problems, and performance issues. Use when the user has an S3 file system that is not mounting, returning access denied, not syncing changes to S3, showing files in lost+found, or performing slower than expected.
SKILL.md 本文
S3 Files のトラブルシューティング
概要
Amazon S3 Files の問題を診断・解決します：マウント失敗、IAM パーミッション、同期、競合解決、パフォーマンス。
詳しくは S3 Files トラブルシューティング を参照してください。
一般的なタスク
0. 依存関係の確認
awsCLI がs3filesサブコマンド対応で利用可能であることを 確認する必要があります- 有効な AWS 認証情報を 確認する必要があります
- ツール の存在とバージョンのみをチェック — 検証中は 破壊的またはミューテーション操作を実行しないでください
- 必要なツールが見つからない場合はユーザーに 通知する必要があります
- ツールが利用不可の場合、ユーザーの中止決定を 尊重する必要があります
- 実行前にステップを説明し、書き込みコマンドではユーザーの確認を 待つ必要があります
1. 問題の分類
| 症状 | カテゴリ |
|---|---|
| mount.s3files: command not found | A: クライアント インストール |
| マウント中に接続タイムアウト | B: ネットワーク / セキュリティグループ |
| マウントが無限に hang（タイムアウトなし） | B: ネットワーク / セキュリティグループ |
| マウント中にアクセス拒否 | C: IAM パーミッション |
| ファイルシステムが「作成中」で stuck | C: IAM パーミッション |
| ファイル操作でパーミッション拒否 | C: IAM パーミッション |
| 書き込み後、S3 にファイルが表示されない | D: 同期 |
| .s3files-lost+found ディレクトリにファイルがある | E: 競合解決 |
| 読み取り遅い、またはレイテンシーが高い | F: パフォーマンス |
| NFS サーバーエラー | G: 暗号化 / KMS |
| DNS 名前解決失敗 | H: VPC DNS |
2. カテゴリ A — クライアント インストール
mount.s3files: command not found は amazon-efs-utils が見つからないか、バージョンが < v3.0.0 であることを意味します。
sudo yum -y install amazon-efs-utils # Amazon Linux
3. カテゴリ B — ネットワーク / セキュリティグループ
接続タイムアウトは #1 のマウント失敗原因 — ほぼ常にセキュリティグループです。
インスタンスの AZ にマウントターゲットが存在することを確認：
aws s3files list-mount-targets --file-system-id fs-ID --region REGION
AZ 間マウントは動作しますがレイテンシーが追加されます。
セキュリティグループを確認 — 最も一般的な修正：
- マウントターゲット SG は計算リソース SG からの入力 TCP 2049 を 許可する必要があります
- 計算リソース SG はマウントターゲット SG への出力 TCP 2049 を 許可する必要があります
- 修正：
aws ec2 authorize-security-group-ingress --group-id sg-MT --protocol tcp --port 2049 --source-group sg-COMPUTE
接続をテスト：
nc -zv az-ID.fs-ID.s3files.REGION.on.aws 2049
注： これらの SG トラブルシューティング手順は EFS にも適用されます — 代わりに
aws efs describe-mount-targetsを使用してください。
隔離された VPC でのマウント hang：VPC がインターネット アクセスを持たない場合、S3 Files はマウント完了のために CloudWatch Logs VPC エンドポイント（com.amazonaws.REGION.logs）が必要です。
4. カテゴリ C — IAM パーミッション
ファイルシステムが「作成中」ステータスで stuck：
S3 Files は作成時に IAM ロール パーミッションを検証しません。間違ったトラスト ポリシーまたは欠落したパーミッション → statusMessage にアクセス拒否で creating に stuck します。
ステータスを確認：
aws s3files get-file-system --file-system-id fs-ID --region REGION
statusMessage をチェック。アクセス拒否の場合は IAM ロールを修正して削除/再作成します。
マウント アクセス拒否： 計算リソース ロールは s3files:ClientMount が必要です。開発/テストのみの場合、AmazonS3FilesClientFullAccess は受け入れられます — 本番環境では避けてください。
書き込みパーミッション拒否： 計算リソース ロールは s3files:ClientWrite が必要です
ルート アクセス拒否： 計算リソース ロールは s3files:ClientRootAccess が必要です。⚠️ POSIX パーミッションをバイパス — スコープ付き POSIX ユーザーを持つアクセス ポイントを推奨します。
ファイルシステム ポリシーを確認：
aws s3files get-file-system-policy --file-system-id fs-ID --region REGION
5. カテゴリ D — 同期
ファイルが S3 に表示されない： 書き込みは約 60 秒以内に同期されます。ステータスを確認：
getfattr -n "user.s3files.status;$(date -u +%s)" filename --only-values
一般的な ExportError の値：
| エラー | 修正 |
|---|---|
| S3AccessDenied | ファイルシステム IAM ロールが S3 書き込みパーミッションを持たない |
| S3BucketNotFound | バケットが削除または名前変更された |
| RoleAssumptionFailed | トラスト ポリシーが誤設定 |
| EncryptionKeyInaccessible | KMS キーが無効またはパーミッションが取り消された |
| PathTooLong | ファイル パスが 1,024 バイト S3 キー制限を超過 |
監視：PendingExports CloudWatch メトリクス。増加中 = 800 ファイル/秒のレート超過。
6. カテゴリ E — 競合解決
.s3files-lost+found-{fs-id} 内のファイル = 同期競合（FS と S3 で同時に変更）。S3 が優先；FS バージョンは lost+found に移動。
7. カテゴリ F — パフォーマンス
初回アクセス レイテンシー： 通常 — 初回ディレクトリ アクセスはメタデータをインポート。
インテリジェント読み取りルーティングが動作しない： 計算リソース ロールはバケットの s3:GetObject が必要です。
書き込み遅い： PendingExports が増加している場合は、複数のファイルシステムに分散。
8. カテゴリ G — 暗号化 / KMS
暗号化された FS の NFS サーバーエラー = KMS 問題。キーが有効でロールが KMS パーミッションを持つことを確認。
9. カテゴリ H — VPC DNS
DNS 解決失敗 = VPC DNS 設定が無効。
aws ec2 describe-vpc-attribute --vpc-id vpc-ID --attribute enableDnsHostnames
aws ec2 describe-vpc-attribute --vpc-id vpc-ID --attribute enableDnsSupport
両方とも true である必要があります。そうでない場合：
aws ec2 modify-vpc-attribute --vpc-id vpc-ID --enable-dns-hostnames Value=true
aws ec2 modify-vpc-attribute --vpc-id vpc-ID --enable-dns-support Value=true
トラブルシューティング
AWS CLI エンドポイント URL を解決できない
CLI が S3 Files に対応していません。aws --version を実行 — v1.x の場合、AWS CLI v2 にアップグレード：AWS CLI のインストール。
ECS タスクが DNS 解決エラーで失敗
efsVolumeConfiguration を使用しました（s3filesVolumeConfiguration の代わり）。修正：S3 Files 固有のボリューム設定で fileSystemArn を使用します。
S3 Files と他のプロダクトの混同
S3 Files は Mountpoint for S3、S3 File Gateway、File Cache では ありません。aws s3files CLI、s3files: IAM アクション、mount -t s3files を使用します。
デバッグ ログを有効化
/etc/amazon/efs/s3files-utils.conf で logging_level = DEBUG を設定。ログは /var/log/amazon/efs/mount.log に出力。
AWS Support 用ログを収集
sudo tar -czf /tmp/s3files-logs.tar.gz /var/log/amazon/efs/ /etc/amazon/efs/s3files-utils.conf
セキュリティに関する考慮事項
- IAM 問題を診断する場合、最小権限を確認 — FullAccess を近道として避ける
- ファイルシステム ポリシーなしでは、すべての VPC クライアントがマウント可能
/var/log/amazon/efs/アクセスを制限 — ログは S3 キー名を含む
追加リソース
ライセンス: Apache-2.0(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- aws
- ライセンス
- Apache-2.0
- 最終更新
- 不明
Source: https://github.com/aws/agent-toolkit-for-aws / ライセンス: Apache-2.0
関連スキル
seo-maps
ローカルSEO向けのマップインテリジェンス機能です。ジオグリッドのランク追跡、APIを通じたGBPプロフィール監査、Google・Tripadvisor・Trustpilotなど複数プラットフォームのレビュー分析、Google・Bing・Apple・OSM間のNAP（名前・住所・電話番号）検証、競合他社の半径マッピング、APIデータからのLocalBusinessスキーマ生成が可能です。3段階の機能レベルで対応でき、無料版（Overpass + Geoapify）、DataForSEO（フル機能）、DataForSEO + Google（最大カバレッジ）から選択できます。「maps」「geo-grid」「rank tracking」「GBP audit」「review velocity」「competitor radius」「maps analysis」「local rank tracking」「Share of Local Voice」「SoLV」などのキーワードで利用できます。
seo-content-brief
セクションごとの文字数、競合スコアリング、キーワード密度ガイダンス、ページタイプテンプレートを含む競争力のあるSEOコンテンツブリーフを生成します。新規ページのブリーフと既存ページの改善ブリーフの両方に対応しています。ユーザーが「コンテンツブリーフ」「ブリーフを作成」「コンテンツアウトライン」「ブログブリーフ」「サービスページブリーフ」「ブリーフ〜」「ライティングブリーフ」「コンテンツプラン」「アウトライン〜」などと言った場合に使用します。
rakuten-seo
楽天市場の商品名・キャッチコピーをSEO最適化するスキル。「楽天SEO」「商品名最適化」「楽天の商品名」「キャッチコピー」「楽天のタイトル」「商品名を直して」「楽天検索対策」など、楽天市場の商品名やキャッチコピーの作成・改善・チェックに関するリクエストで必ずこのスキルを使う。既存の商品名の改善も、ゼロからの作成も対応。あらゆるジャンル（食品・ファッション・化粧品・家電・サプリ・インテリア・ベビー・ペット・業務用など）に対応。 【ALSEL独自スキル】株式会社ALSEL が、19年・5,000社超の EC 支援で得たノウハウをもとに開発したオリジナルスキルです。
amazon-seo-jp
Amazon.co.jp商品ページのSEO分析・最適化・自動採点スキル v2.0。 COSMO/Rufus/A10アルゴリズムに基づく採点。セラーセントラル出品レポート（.xlsm）を入力すると、 商品タイトル・箇条書き・検索キーワード・商品説明文を100点満点で採点し、 4項目すべての改善案を日本語で出力する。 トリガー: 「Amazon SEO」「商品ページ採点」「Amazon最適化」 「リスティング改善」「Amazon商品名」「箇条書き改善」 「COSMO対応」「Rufus最適化」「Amazon タイトル」 【ALSEL独自スキル】株式会社ALSEL が、19年・5,000社超の EC 支援で得たノウハウをもとに開発したオリジナルスキルです。
rakuten-bulk-control-csv
楽天RMSの一括登録/一括除外/一括更新用CSV（コントロールカラム,商品管理番号 の2列フォーマット）を作成するスキル。商品DL CSV・商品管理画面のコピペ・Excel・PDFなどから商品管理番号を抽出し、Shift-JIS+LF改行で出力する。「一括除外リスト作って」「楽天の除外CSV」「コントロールカラムnで」「2800円以下の商品をdで」「在庫0の商品を一括削除」「商品管理番号抜いてshift-jsで」「このフォーマットで」など、楽天RMSの商品一括処理用CSVを作るタスクで必ずこのスキルを使う。コントロールカラム値（n=新規/d=削除/u=更新）と抽出条件（全件・価格・在庫・販売状態など）をユーザー指示に応じて柔軟に切り替える。 【ALSEL独自スキル】株式会社ALSEL が、19年・5,000社超の EC 支援で得たノウハウをもとに開発したオリジナルスキルです。
amazon-a-plus-content-brief
Amazon A+コンテンツの構成・モジュール選定・画像指示・比較表・FAQを設計するスキル。「A+コンテンツ作って」「Aプラス構成」「ブランドストーリー」「比較表つきA+」「A+モジュール選定」「Amazonのページに画像入れたい」「A+のヘッダー画像」「A+コンテンツマネージャー」など、Amazon A+コンテンツの企画・設計・改善のリクエストで必ずこのスキルを使う。ベーシック17モジュール／Premium追加機能／画像サイズ規定／文字数目安／審査リジェクト要因を踏まえて、デザイナーに渡せるブリーフ形式で出力。あらゆるジャンル（家電・コスメ・食品・アパレル・日用品・ベビー・ペット等）に対応。※ブランドストア（マルチページ）の設計は別スキル `amazon-brand-store-planner`、タイトル・bullet改善は `amazon-title-bullet-rewriter-jp`、メイン画像のチェックは `amazon-main-image-checker`。 【ALSEL独自スキル】株式会社ALSEL が、19年・5,000社超の EC 支援で得たノウハウをもとに開発したオリジナルスキルです。