安全なrcloneジョブログを記録する

dosyaのリリース済みrcloneページでは、APIキー、ワークスペースID、https://api.dosya.devを使ってネイティブのdosya:リモートを設定します。ジョブログには発生した内容を記録し、認証情報や設定ファイル全体をチケット、チャット、CI出力にコピーしないようにします。

始める前に

この自動化専用のAPIキーを使い、権限、ワークスペース、フォルダー、プロトコル、IP範囲、有効時間、有効期限を用途に合わせてください。Webのキー作成フォームには秘密情報が一度だけ表示され、リリース済みのrclone設定ではapi_keyとして保存されます。キーと設定ファイルの両方を秘密情報として扱ってください。

リポジトリの本番スモークテストランナーでは、接続タイムアウト15s、操作タイムアウト60s、高レベルの再試行1回、低レベルの再試行2回、プロセスの強制上限120sという検証済みの制限を設けています。これらの値により、無人実行での失敗が有限時間で終了し、終了ステータスを記録できます。

手順

1. **プロフィール → API（APIキー）**を開き、このジョブ用の制限付きキーを作成または特定して、rcloneを実行する前にアクセス可能なワークスペースとフォルダーの範囲を確認してください。
2. 認証情報はrclone config fileが返す保護されたrclone設定ファイルに保持してください。dos_…、S3シークレット、設定内容をコマンドラインやログのヘッダーに置かないでください。
3. ジョブの設定と早期終了用のタイムアウトを使って安全なrclone lsf dosya:チェックを実行し、UTC開始時刻、rcloneのバージョン、コマンドの動詞、終了コードを記録してください。
4. ファイルの引数の前に--を置き、-x.binのような有効な名前がフラグとして解釈されないようにしてください。機密のフルパスではなく、伏せたコピー元と保存先のラベルを記録してください。
5. 診断に必要な標準出力または標準エラー出力を取得し、制限された保存場所からログを持ち出す前にAPIキー、Bearer文字列、署名付きURL、パスワード、トークン、機密名を置き換えてください。
6. 経過時間、転送または確認した件数、最終的な終了ステータス、最初に対処可能なエラーが記録されていることと、dos_、secret_access_key、Authorizationを検索しても何も見つからないことを確認してください。

期待される結果

ログからrcloneジョブの実行時刻、使用した安全なコマンドモード、試みた内容、成功または失敗の理由を確認できます。問題を再現するための十分な時間と件数の情報が含まれ、認証情報や保護対象の名前はログに含まれません。

rcloneが終了しない場合は、次の実行結果を収集する前に有限の再試行回数とタイムアウトを設定してください。設定ファイルがないとログに表示された場合は、rclone config fileを使って権限を確認してください。厳格に制限されたSnapビルドでは、隠しパスや一時パスを必ずしも読み取れません。

関連ガイド

• dosyaでrcloneを使う
• rclone同期のドライランを実行する