rcloneの自動処理の終了ステータスを確認する

rcloneのステータスはコマンドの直後、別のシェルコマンドで上書きされる前に取得してください。終了コード0は、その実行で未解決のエラーがないことを示します。転送が不要だった場合も含まれるため、内容が一致している証拠にはなりません。

手順

1. 転送元と転送先を明示し、保存されるログと統計情報を指定して、スケジュールされたコピーまたは手動コピーを実行してください。
2. POSIXシェルでは次の行でstatus=$?を代入してください。PowerShellでは一覧表示やほかの確認をする前に$status = $LASTEXITCODEを代入してください。
3. 最終的な転送概要と、それまでのすべてのエラーを保持してください。複数ファイルの処理が失敗しても、先に処理したファイルは正常に保存されている場合があります。
4. statusがゼロ以外の場合はジョブを失敗として記録し、再試行前に転送先を確認してください。ログを消去したり、バッチ全体を自動で再実行したりしないでください。
5. コピーのステータスがゼロの場合は、rclone check SOURCE DESTINATION --downloadなどで別途読み取り専用の比較を実行してください。そのコマンドのステータスは独立して取得します。
6. 両方のステータスがゼロで、転送先の代表的なバイトデータが一致する場合にのみ成功を報告してください。実行時刻、パス、rcloneのバージョン、件数を受領情報とともに保存してください。

dosyaのWebDAVでは、同名のファイルに対するPUTが成功すると新しいファイルバージョンが作成されます。後でエラーが発生しても、そのバージョンはロールバックされません。同様にcopyでは転送先だけにあるファイルが残ります。その存在は、この実行で転送元を処理した証拠にはなりません。

確認できる結果

自動処理は、転送プロセスと独立した比較が両方とも正常終了した後にのみ成功を記録し、どの実行か特定できるログを残します。ステータスがゼロ以外の場合は証拠を保持し、後続の成功時の処理を実行しません。

シェルのパイプラインでは、ステータスを正しく取得しないと、別のプロセスの終了コードに隠れてrcloneのコードが分からなくなる場合があります。通知を信頼する前に、意図的に存在しない転送元を指定してラッパーをテストし、その後テスト用のパスを削除してください。

関連ガイド

• dosyaでrcloneを使う
• rcloneのsyncをドライランで確認する