LightFile Nextコマンドの変更点
旧LightFileからLightFile Batchへのコマンドラインオプションの対応表
旧LightFile（v6.0.0未満）から新しいLightFile Batchへのコマンドラインオプションの主な変更点をまとめています。
基本構文の変更
旧LightFile
lightfile --file-system <type> --dir <path> [options]LightFile Batch
lightfile-batch <サブコマンド> [options]旧版の--file-systemオプションがサブコマンドに変更されました。
サブコマンド
旧版の--file-systemオプションがサブコマンドに変更されました：
| 旧LightFile | LightFile Batch | 説明 |
|---|---|---|
--file-system local | local | ローカルファイルシステム（デフォルト） |
--file-system ftp | ftp | FTPサーバー |
--file-system sftp | sftp | SFTPサーバー |
--file-system webdav | webdav | WebDAVサーバー |
--file-system s3 | s3 | S3/S3互換ストレージ |
| - | test-notify | 通知設定のテスト（新機能） |
使用例
# ローカルファイルシステム
lightfile-batch local --dir /path/to/images
# FTPサーバー
lightfile-batch ftp --ftp-host ftp.example.com --ftp-dir /images
# S3バケット
lightfile-batch s3 --s3-bucket my-bucket --s3-prefix images/主なオプションの変更
| 機能 | 旧LightFile | LightFile Batch | 備考 |
|---|---|---|---|
| ライセンス | |||
| ライセンス認証 | --serial <code> | --license-token <token> | 環境変数LF_TOKENも使用可能 |
| ファイルシステム | |||
| FS種類指定 | --file-system <type> | サブコマンド | local, ftp, sftp, webdav, s3 |
| ディレクトリ指定 | --dir <path> | --dir <path> | 変更なし |
| ファイルフィルタ | |||
| ファイルサイズ | --file-size min-max | --min-size, --max-size | 個別のオプションに分離 |
| 対象パターン | --only <pattern> | --include <pattern> | 名称変更 |
| 除外パターン | --ignore <pattern> | --exclude <pattern> | 名称変更 |
| 更新日時フィルタ | --recent <duration> | --after, --before | より詳細な指定が可能 |
| 処理件数制限 | ❌ なし | --limit <N> | 新機能 |
| バックアップ | |||
| バックアップ無効 | --no-backup | --backup-mode none | より詳細な制御が可能 |
| バックアップモード | ❌ なし | --backup-mode <mode> | 新機能: strict/loose/none |
| ログ | |||
| ログレベル | --logging <level> | --log-level <level> | 名称変更 |
| 静音モード | --logging quiet | --quiet, -q | 短縮形追加 |
| 進捗表示間隔 | ❌ なし | --log-progress-interval <N> | 新機能 |
| 並列処理 | |||
| 順次処理 | --serial | デフォルト | - |
| 並列処理 | デフォルト | --concurrency N, -j N | 並列数を明示的に指定 |
| 排他制御 | |||
| PIDファイル | --pid <file> | 自動（--non-exclusiveで無効化） | 自動化 |
| 排他制御無効 | ❌ なし | --non-exclusive | 新機能 |
| 通知 | |||
| Email通知 | --fatal-notify-email | --notify-smtp-*, --notify-email-* | Lambda経由に変更 |
| Slack通知 | --fatal-notify-slack-* | --notify-slack-* | Webhook URLで指定 |
| Lambda通知 | ❌ なし | --notify-lambda-* | 新機能 |
| 設定管理 | |||
| 設定ファイル | ❌ なし | --config <file>, -c <file> | 新機能: YAML設定 |
リモートファイルシステムのオプション変更
FTP
| 機能 | 旧LightFile | LightFile Batch | 備考 |
|---|---|---|---|
| ホスト指定 | --host | --ftp-host | プレフィックス追加 |
| ユーザー名 | --user | --ftp-user | プレフィックス追加 |
| パスワード | --password | --ftp-password | プレフィックス追加 |
| TLS使用 | --secure | --ftp-use-tls | プレフィックス追加 |
| ポート番号 | --port | --ftp-port | プレフィックス追加 |
| ディレクトリ | --dir | --ftp-dir | 新規: 専用オプション |
例:
# 旧LightFile
lightfile --file-system ftp --host ftp.example.com --user myuser \
--password mypass --dir /images
# LightFile Batch
lightfile-batch ftp --ftp-host ftp.example.com --ftp-user myuser \
--ftp-password mypass --ftp-dir /imagesSFTP
| 機能 | 旧LightFile | LightFile Batch | 備考 |
|---|---|---|---|
| ホスト指定 | --host | --sftp-host | プレフィックス追加 |
| ユーザー名 | --user | --sftp-user | プレフィックス追加 |
| パスワード | --password | --sftp-password | プレフィックス追加 |
| 秘密鍵 | --private-key-file | --sftp-private-key | 名称変更 |
| 秘密鍵パスフレーズ | ❌ なし | --sftp-passphrase | 新機能 |
| ポート番号 | --port | --sftp-port | プレフィックス追加 |
| ディレクトリ | --dir | --sftp-dir | 新規: 専用オプション |
例:
# 旧LightFile
lightfile --file-system sftp --host sftp.example.com --user myuser \
--private-key-file ~/.ssh/id_rsa --dir /images
# LightFile Batch
lightfile-batch sftp --sftp-host sftp.example.com --sftp-user myuser \
--sftp-private-key ~/.ssh/id_rsa --sftp-dir /imagesWebDAV
| 機能 | 旧LightFile | LightFile Batch | 備考 |
|---|---|---|---|
| エンドポイント | --webdav-url | --webdav-endpoint | 名称変更 |
| ユーザー名 | --user | --webdav-user | プレフィックス追加 |
| パスワード | --password | --webdav-password | プレフィックス追加 |
| ディレクトリ | --dir | --webdav-dir | 新規: 専用オプション |
例:
# 旧LightFile
lightfile --file-system webdav --webdav-url https://dav.example.com \
--user myuser --password mypass --dir /images
# LightFile Batch
lightfile-batch webdav --webdav-endpoint https://dav.example.com \
--webdav-user myuser --webdav-password mypass --webdav-dir /imagesS3
| 機能 | 旧LightFile | LightFile Batch | 備考 |
|---|---|---|---|
| バケット名 | --s3-bucket | --s3-bucket | 変更なし |
| プレフィックス | --dir | --s3-prefix | 新規: 専用オプション |
| リージョン | --s3-region | --s3-region | 変更なし |
| ACL | --s3-acl | --s3-acl | 変更なし |
| エンドポイント | --s3-endpoint | --s3-endpoint | 変更なし |
| アクセスキー | --aws-access-key-id | --s3-access-key | 名称変更 |
| シークレットキー | --aws-secret-access-key | --s3-secret-key | 名称変更 |
例:
# 旧LightFile
lightfile --file-system s3 --s3-bucket my-bucket --s3-region ap-northeast-1 \
--dir images/
# LightFile Batch
lightfile-batch s3 --s3-bucket my-bucket --s3-region ap-northeast-1 \
--s3-prefix images/廃止されたオプション
以下のオプションは新バージョンで廃止されました：
| 旧オプション | 理由 | 代替手段 |
|---|---|---|
--serial | ライセンス形式変更 | --license-tokenを使用 |
--analyze | 機能統合 | 自動的に分析実行 |
--http-verify | 使用頻度が低い | 廃止 |
--file-error-retry | 自動化 | リトライは自動実行 |
--pid | 自動化 | 排他制御は自動、--non-exclusiveで無効化 |
--proxy | 環境変数に統合 | HTTP_PROXY/HTTPS_PROXY環境変数を使用 |
--verify-size | 機能統合 | 自動的に検証 |
--logs-file-size | ログ出力方式変更 | ログはstdoutへ |
--logs-file-backups | ログ出力方式変更 | ログはstdoutへ |
--slack-log | 通知機能に統合 | --notify-slack-*を使用 |
--fast-scan | デフォルト動作に統合 | 不要 |
--format | 使用頻度が低い | 廃止 |
新しく追加されたオプション
設定管理
--config,-c→ YAML設定ファイルの指定
lightfile-batch --config settings.yml詳細はYAML設定ファイルを参照してください。
バックアップ
--backup-mode→ バックアップモード（strict/loose/none）--backup-fs→ バックアップ先FS（local/s3）--backup-s3-*→ S3バックアップ設定
# 厳密モードでローカルにバックアップ
lightfile-batch local --dir /images --backup-mode strict \
--backup-fs local --backup-dir /backups
# S3にバックアップ
lightfile-batch local --dir /images --backup-mode strict \
--backup-fs s3 --backup-s3-bucket my-backup-bucket詳細はバックアップ機能を参照してください。
通知
--notify-email-*→ Lambda経由Email通知--notify-smtp-*→ SMTP経由Email通知--notify-slack-*→ Slack Webhook通知--notify-lambda-*→ カスタムLambda通知
# Slack通知
lightfile-batch local --dir /images \
--notify-slack-webhook-url https://hooks.slack.com/services/XXX
# SMTP通知
lightfile-batch local --dir /images \
--notify-smtp-host smtp.example.com \
--notify-smtp-from noreply@example.com \
--notify-email-to admin@example.com詳細は通知機能を参照してください。
インデックスファイル
--index-remote-file→ リモートインデックスファイル
lightfile-batch ftp --ftp-host ftp.example.com \
--index-remote-file /index/ftp-index.json詳細はインデックスファイルを参照してください。
その他
--log-progress-interval→ 進捗表示間隔--non-exclusive→ 排他制御無効化--session-retention-days→ セッション保持期間--limit→ 処理件数上限--no-report→ 使用状況レポート無効化
ライセンストークンの指定方法
優先順位
- コマンドラインオプション:
--license-token <token> - 環境変数:
LF_TOKEN - ファイル:
~/.lightfile-next/token
旧版との違い
旧LightFile:
lightfile --serial ABC123-XYZ789 --file-system local --dir /path/to/imagesLightFile Batch:
# オプションで指定
lightfile-batch --license-token 'username!base64_signature' local --dir /path/to/images
# 環境変数で指定（推奨）
export LF_TOKEN='username!base64_signature'
lightfile-batch local --dir /path/to/images
# ファイルで指定
echo 'username!base64_signature' > ~/.lightfile-next/token
lightfile-batch local --dir /path/to/images環境変数やファイルでの指定により、コマンドラインにライセンス情報を含める必要がなくなり、セキュリティが向上します。
YAML設定ファイル（新機能）
LightFile Batchでは、すべてのオプションをYAML設定ファイルで指定できます。
# settings.yml
license:
token: username!base64_signature
local:
dir: /path/to/images
quality: high
filtering:
minSize: 10kb
maxSize: 5mb
backup:
mode: strict
fs: s3
s3:
bucket: my-backup-bucket
prefix: backups/lightfile-batch --config settings.yml詳細はYAML設定ファイルを参照してください。
ログレベルの変更
旧LightFile
lightfile --logging normal --dir /path/to/images # 通常ログ
lightfile --logging debug --dir /path/to/images # デバッグログ
lightfile --logging quiet --dir /path/to/images # 静音モードLightFile Batch
lightfile-batch --log-level info local --dir /path/to/images # 通常ログ
lightfile-batch --log-level debug local --dir /path/to/images # デバッグログ
lightfile-batch --quiet local --dir /path/to/images # 静音モード詳細はログ設定を参照してください。
並列処理の変更
旧LightFile
# デフォルトで並列処理（CPUコア数に応じて自動）
lightfile --dir /path/to/images
# 順次処理
lightfile --serial --dir /path/to/imagesLightFile Batch
# デフォルトは順次処理
lightfile-batch local --dir /path/to/images
# 並列処理（4並列）
lightfile-batch local --dir /path/to/images --concurrency 4
lightfile-batch local --dir /path/to/images -j 4
# CPUコア数に応じて自動設定
lightfile-batch local --dir /path/to/images -j 0新バージョンでは並列数を明示的に指定します。-j 0を指定すると、システムのCPUコア数に応じて自動的に並列数が設定されます。
次のステップ
- 旧LightFileからの移行 - 移行手順の詳細
- 機能比較表 - 機能の詳細比較
- クイックスタート - LightFile Batchの基本的な使い方