翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 自動ダウンロード
Deadline CLI は、同じコマンドが最後に実行されてから完了したキュー内のすべてのタスクの出力をダウンロードするコマンドを提供します。これは、繰り返し実行する cron ジョブまたはスケジュールされたタスクとして設定できます。この設定では、出力の自動ダウンロードが継続的に設定されます。
自動ダウンロードを設定する前に、[ジョブアタッチメントのストレージプロファイル](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/storage-profile.html)の手順に従って、アップロードとダウンロードのためのアセットデータのすべてのパスを設定します。ジョブがストレージプロファイルにない出力パスを使用する場合、自動ダウンロードはその出力のダウンロードをスキップし、警告メッセージを出力して、ダウンロードしなかったファイルを要約します。同様に、ストレージプロファイルなしでジョブが送信された場合、自動ダウンロードはそのジョブをスキップして警告メッセージを出力します。デフォルトでは、Deadline Cloud 送信者は、正しい設定を保証するために、ストレージプロファイルの外部にあるパスの警告メッセージを表示します。
## AWS 認証情報の設定
自動ダウンロードでは、Deadline CLI を使用してジョブ出力を継続的にダウンロードします。これらのダウンロードを認証するには、長期的な IAM 認証情報が必要です。Deadline Cloud モニターの認証情報の有効期限が切れるため、この目的で使用することはできません。
長期認証情報を設定するには、以下のステップに従います。
**重要**
次の警告に注意してください。
アカウントのルート認証情報を使用して AWS リソースにアクセス**しないでください**。これらの認証情報は無制限のアカウントアクセスを提供し、取り消すのが困難です。
アプリケーションファイルにリテラルアクセスキーや認証情報を**配置しないでください**。これを行うと、パブリックリポジトリにプロジェクトをアップロードするなど、誤って認証情報が公開されるリスクが発生します。
プロジェクト領域に認証情報を含むファイルを**含めないでください**。
アクセスキーを保護します。[アカウント識別子を確認する](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html)ためであっても、アクセスキーを認可されていない当事者に提供しないでください。提供すると、第三者がアカウントへの永続的なアクセスを取得する場合があります。
共有 AWS 認証情報ファイルに保存されている認証情報はすべてプレーンテキストで保存されることに注意してください。
詳細については、 [*AWS 全般のリファレンス*の AWS 「アクセスキーを管理するためのベストプラクティス」を参照してください。](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#securing_access-keys)
**IAM ユーザーの作成**
1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。
1. ナビゲーションペインで **[ユーザー]**、**[ユーザーの作成]** の順に選択します。
1. ユーザー に名前を付けます**deadline-output-downloader**。への**ユーザーアクセスを許可する AWS マネジメントコンソール**のチェックボックスをオフにし、**次へ**を選択します。
1. **[ポリシーを直接アタッチ]** を選択します。
1. **ポリシーの作成** を選択して、最低限必要なアクセス許可を持つカスタムポリシーを作成します。
1. JSON エディタで、次のアクセス許可を指定します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeadlineCloudOutputDownload",
"Effect": "Allow",
"Action": [
"deadline:AssumeQueueRoleForUser",
"deadline:ListQueueEnvironments",
"deadline:ListSessions",
"deadline:ListSessionActions",
"deadline:SearchJobs",
"deadline:GetJob",
"deadline:GetQueue",
"deadline:GetStorageProfileForQueue"
],
"Resource": "*"
}
]
}
```
------
1. ポリシーに名前を付け**DeadlineCloudOutputDownloadPolicy**、**ポリシーの作成**を選択します。
1. ユーザー作成ページに戻り、ポリシーリストを更新して、先ほど作成した **DeadlineCloudOutputDownloadPolicy** を選択し、**次へ**を選択します。
1. ユーザーの詳細を確認し、**ユーザーの作成**を選択します。
**アクセスキーの作成**
1. ユーザーの詳細ページから、**セキュリティ認証情報**タブを選択します。[**Access keys (アクセスキー)**] セクションで、[**Create access key (アクセスキーを作成)**] を選択します。
1. Other に キーを使用するように指定し、**Next** を選択し、Create **access key **を選択します。
1. **アクセスキーの取得**ページで、**表示**を選択してユーザーのシークレットアクセスキーの値を表示します。認証情報をコピーするか、csv ファイルをダウンロードできます。
**ユーザーアクセスキーを保存する**
+ ユーザーアクセスキーをシステムの AWS 認証情報ファイルに保存します。
+ ではLinux、ファイルは にあります。 `~/.aws/credentials`
+ ではWindows、ファイルは にあります。 `%USERPROFILE\.aws\credentials`
次のキーを置き換えます。
```
[deadline-downloader]
aws_access_key_id=ACCESS_KEY_ID
aws_secret_access_key=SECRET_ACCESS_KEY
region=YOUR_AWS_REGION
```
**重要**
この IAM ユーザーが不要になった場合は、[AWS セキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials)に合わせて削除することをお勧めします。にアクセスする[AWS IAM アイデンティティセンター](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)ときは、 を通じて一時的な認証情報を使用することを人間のユーザーに要求することをお勧めします AWS。
## 前提条件
自動ダウンロード用の cron ジョブまたはスケジュールされたタスクを作成する前に、次の手順を実行します。
1. まだインストールしていない場合は、[Python](https://www.python.org/) をインストールします。
1. 以下を実行して Deadline CLI をインストールします。
```
python -m pip install deadline
```
1. 次のコマンドを使用して、Deadline CLI のバージョンが 0.52.1 以降であることを確認します。
```
$ deadline --version
deadline, version 0.52.1
```
## 出力ダウンロードコマンドをテストする
**環境でコマンドが動作することを確認するには**
1. Deadline へのパスを取得する
------
#### [ Linux and macOS ]
```
$ which deadline
```
------
#### [ Server ]
```
C:\> where deadline
```
------
#### [ PowerShell ]
```
PS C:\> Get-Command deadline
```
------
1. sync-output コマンドを実行してブートストラップします。
```
/path/to/deadline queue sync-output \
--profile deadline-downloader \
--farm-id YOUR_FARM_ID \
--queue-id YOUR_QUEUE_ID \
--storage-profile-id YOUR_PROFILE_ID \
--checkpoint-dir /path/to/checkpoint/directory \
```
1. ダウンロードマシンが送信マシンと同じ場合にのみ、このステップを実行する必要があります。`--storage-profile-id YOUR_PROFILE_ID \` 上記の を に置き換えます`--ignore-storage-profiles`。
1. テストジョブを送信します。
1. GitHub から .zip ファイルをダウンロードします。
1. [deadline-cloud-samples GitHub リポジトリ](https://github.com/aws-deadline/deadline-cloud-samples/tree/mainline)を開きます。
1. Code ****を選択し、ドロップダウンメニューから **Download ZIP **を選択します。
1. ダウンロードしたアーカイブをローカルディレクトリに解凍します。
1. 実行
```
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output
```
1. 実行
```
deadline bundle submit .
```
1. デフォルトの期限設定がない場合は、コマンドラインで以下を指定する必要があります。
```
--farm-id YOUR-FARM-ID --queue-id YOUR-QUEUE-ID
```
1. ジョブが完了するまで待ってから、次のステップに進みます。
1. sync-output コマンドを再度実行します。
```
/path/to/deadline queue sync-output \
--profile deadline-downloader \
--farm-id YOUR_FARM_ID \
--queue-id YOUR_QUEUE_ID \
--storage-profile-id YOUR_PROFILE_ID \
--checkpoint-dir /path/to/checkpoint/directory
```
1. 以下について確認します。
+ テストジョブの出力が送信先ディレクトリに表示されます。
+ チェックポイントファイルは、指定されたチェックポイントディレクトリに作成されます。
## スケジュールされたダウンロードをセットアップする
オペレーティングシステムのタブを選択すると、5 分ごとに自動ダウンロードを設定する方法がわかります。
------
#### [ Linux ]
1. **Deadline CLI のインストールを確認する**
期限の実行可能ファイルへの正確なパスを取得します。
```
$ which deadline
```
このパス (例: `/opt/homebrew/bin/deadline`) を plist ファイルで使用することに注意してください。
1. **チェックポイントディレクトリの作成**
チェックポイントファイルを保存するディレクトリを作成します。ユーザーが コマンドを実行するための適切なアクセス許可があることを確認します。
```
$ mkdir -p /path/to/checkpoint/directory
```
1. **ログディレクトリの作成**
cron ジョブログのディレクトリを作成します。
```
$ mkdir -p /path/to/logs
```
https://www.redhat.com/en/blog/setting-logrotate を使用してログファイルのログローテーションを設定することを検討してください。
1. **現在の Crontab を確認する**
現在の crontab を表示して、既存のジョブを表示します。
```
$ crontab -l
```
1. **Crontab の編集**
編集する crontab ファイルを開きます。
```
$ crontab -e
```
初めての場合は、エディタ (nano、vim など) を選択するように求められる場合があります。
1. **Cron ジョブエントリの追加**
次の行を追加して 5 分ごとにジョブを実行します (パスをステップ 1 と 2 の実際の値に置き換えます）。
```
*/5 * * * * /path/to/deadline queue sync-output --profile deadline-downloader --farm-id YOUR_FARM_ID --queue-id YOUR_QUEUE_ID --storage-profile-id YOUR_PROFILE_ID --checkpoint-dir /path/to/checkpoint/directory >> /path/to/logs/deadline_sync.log 2>&1
```
1. **Cron ジョブのインストールを確認する**
エディタを保存して終了したら、cron ジョブが追加されていることを確認します。
```
$ crontab -l
```
新しいジョブが一覧表示されます。
1. **Cron サービスのステータスを確認する**
cron サービスが実行されていることを確認します。
```
# For systemd systems (most modern Linux distributions)
$ sudo systemctl status cron
# or
$ sudo systemctl status crond
# For older systems
$ sudo service cron status
```
実行されていない場合は、起動します。
```
$ sudo systemctl start cron
$ sudo systemctl enable cron # Enable auto-start on boot
```
------
#### [ macOS ]
1. **Deadline CLI のインストールを確認する**
期限の実行可能ファイルへの正確なパスを取得します。
```
$ which deadline
```
このパス (例: `/opt/homebrew/bin/deadline`) を plist ファイルで使用することに注意してください。
1. **チェックポイントディレクトリとログディレクトリの作成**
チェックポイントファイルを保存するディレクトリを作成します。
```
$ mkdir -p /path/to/checkpoint/directory
$ mkdir -p /path/to/logs
```
https://formulae.brew.sh/formula/logrotate を使用してログファイルのログローテーションを設定することを検討してください。
1. **リストファイルを作成する**
次の内容`~/Library/LaunchAgents/com.user.deadlinesync.plist`で に設定ファイルを作成します ( をステップ 1 の実際のパス`/path/to/deadline`に置き換えます）。
```
Label
com.user.deadlinesync
ProgramArguments
/path/to/deadline
queue
sync-output
--profile
deadline-downloader
--farm-id
YOUR_FARM_ID
--queue-id
YOUR_QUEUE_ID
--storage-profile-id
YOUR STORAGE PROFILE ID
--checkpoint-dir
/path/to/checkpoint/dir
RunAtLoad
UserName
YOUR_USER_NAME
StandardOutPath
/path/to/logs/deadline_sync.log
StartInterval
300
```
ダウンロードするマシンが送信マシンと同じ`--ignore-storage-profiles`場合は、`--storage-profile-id YOUR_PROFILE_ID`上記の を に置き換えます。
1. **リストファイルを検証する**
plist ファイルの XML 構文を検証します。
```
$ plutil -lint ~/Library/LaunchAgents/com.user.deadlinesync.plist
```
これにより、ファイルが有効であれば「OK」が返されます。
1. **既存の起動エージェントまたは起動デーモンを確認する**
起動エージェントが既にロードされているかどうかを確認します。
```
$ launchctl list | grep deadlinesync
OR
$ sudo launchctl list | grep deadlinesync
```
存在する場合は、まずアンロードします。
```
$ launchctl bootout gui/$(id -u)/com.user.deadlinesync
OR
$ sudo launchctl bootout system/com.user.deadlinesync
```
1. **作成とブートストラップ**
ユーザーがログインしている間にこのタスクを実行するには、**LaunchAgent** として実行します。マシンが実行されるたびにユーザーがログインせずにこのタスクを実行するには、**LaunchDaemon** として実行します。
1. **LaunchAgent として実行するには:**
1. で作成された設定を使用する `~/Library/LaunchAgents/com.user.deadlinesync.plist`
1. 次に、ブートストラップコマンドを使用して設定をロードします。
```
$ launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.user.deadlinesync.plist
```
1. **LaunchDaemon** として実行するには:
1. 以下を実行して、Pilst ファイルを移動し、アクセス許可を変更します。
```
$ sudo mv ~/Library/LaunchAgents/com.user.deadlinesync.plist /Library/LaunchDaemons/
$ sudo chown root:wheel /Library/LaunchDaemons/com.user.deadlinesync.plist
$ sudo chmod 644 /Library/LaunchDaemons/com.user.deadlinesync.plist
```
1. 最新のブートストラップコマンドを使用して起動エージェントをロードします。
```
$ sudo launchctl bootstrap system /Library/LaunchDaemons/com.user.deadlinesync.plist
```
1. **ステータスの確認**
LaunchAgent をブートストラップした場合は、以下を実行してロードされていることを確認します。
```
$ launchctl list | grep deadlinesync
```
LaunchDaemon をブートストラップした場合は、以下を実行してロードされていることを確認します。
```
$ sudo launchctl list | grep deadlinesync
```
出力は次のようになります。
```
SOME_PID_NUMBER 0 com.user.deadlinesync
```
詳細なステータス情報については、以下を参照してください。
```
$ launchctl print gui/$(id -u)/com.user.deadlinesync
```
現在の状態、プログラム引数、環境変数、実行間隔、実行履歴が表示されます。
------
#### [ Server ]
**注記**
これらの手順を使用して作成されたスケジュールされたタスクは、ユーザーがログインしている場合にのみ機能します。
ユーザーログインを必要とせずにシステム起動時にセットアップするには、公式[Windowsドキュメント](https://learn.microsoft.com/en-us/windows/win32/taskschd/using-the-task-scheduler)を参照してください。
以下のすべてのステップで、コマンドプロンプトを使用します。管理者として実行します。
1. **Deadline CLI のインストールを確認する**
期限の実行可能ファイルを見つけます。
```
C:\> where deadline
```
タスクで使用するフルパス ( など`C:\Program Files\Amazon\DeadlineCloud\deadline.exe`) を書き留めます。
1. **チェックポイントディレクトリの作成**
チェックポイントファイルを保存するディレクトリを作成します。
```
C:\> mkdir "path\to\checkpoint\directory"
```
1. **ログディレクトリの作成**
タスクログのディレクトリを作成します。
```
C:\> mkdir "path\to\logs"
```
1. **バッチファイルラッパーの作成**
次の内容のバッチファイルを作成します。
```
C:\> notepad C:\path\to\deadline_sync.bat
```
```
YOUR_PATH_TO_DEADLINE.EXE queue sync-output --profile deadline-downloader --farm-id YOUR_FARM_ID --queue-id YOUR_QUEUE_ID --storage-profile-id YOUR_PROFILE_ID --checkpoint-dir path\to\checkpoint\checkpoints > path\to\logs\deadline.log 2>&1
```
1. **バッチファイルのテスト**
バッチファイルを手動でテストします。
```
C:\> .\path\to\deadline_sync.bat
```
ログファイルが作成されたことを確認します。
```
C:\> notepad path\to\logs\deadline_sync.log
```
1. **タスクスケジューラサービスの確認**
Task Scheduler サービスが実行されていることを確認します。
```
C:\> sc query "Schedule"
```
サービスが存在しない場合は、代替名を試してください。
```
C:\> sc query "TaskScheduler"
C:\> sc query "Task Scheduler"
```
実行されていない場合は、起動します。
```
C:\> sc start "Schedule"
```
1. **スケジュールされたタスクの作成**
5 分ごとに実行するタスクを作成します。
```
C:\> schtasks /create /tn "DeadlineOutputSync" /tr "C:\path\to\deadline_sync.bat" /sc minute /mo 5
```
コマンドの内訳:
+ `/tn` - タスク名
+ `/tr` - 実行するタスク (バッチファイル)
+ `/sc minute /mo 5` - スケジュール: 5 分ごと
1. **タスク作成の検証**
タスクが正常に作成されたことを確認します。
```
schtasks /query /tn "DeadlineOutputSync" /v /fo LIST
```
以下を探します。
+ **実行するタスク**: バッチファイルパスを表示します
+ **次の実行時間**: 5 分以内に時間を表示する必要があります
1. **テストタスクの実行**
タスクを手動で実行してテストします。
```
schtasks /run /tn "DeadlineOutputSync"
```
タスクのステータスを確認します。
```
schtasks /query /tn "DeadlineOutputSync"
```
------
**セットアップを確認します。**
自動ダウンロードの設定が成功したことを確認するには、次の手順を実行します。
1. 新しいテストジョブを送信します。
1. 1 つのスケジューラ間隔が完了するまで待ちます。この場合は 5 分です。
1. 新しい出力が自動的にダウンロードされることを確認します。
出力がダウンロードされない場合は、プロセスログのトラブルシューティングセクションを確認してください。
## 自動ダウンロードのトラブルシューティング
自動ダウンロードで問題が発生した場合は、以下を確認してください。
### ストレージプロファイルの問題
+ ログファイル`[Errno 13] Permission denied`の `[Errno 2] No such file or directory`や などのエラーは、ストレージプロファイルの欠落や設定ミスに関連している可能性があります。
+ ダウンロードマシンが送信マシンと異なる場合に[ストレージプロファイル](https://docs.aws.amazon.com/deadline-cloud/latest/userguide/storage-profile-job-attachments.html)を設定する方法については、「ストレージプロファイル」を参照してください。
+ 同じマシンのダウンロードの場合は、 `--ignore-storage-profiles`フラグを試してください。
### ディレクトリのアクセス許可
+ スケジューラサービスユーザーに以下があることを確認します。
+ チェックポイントディレクトリへの読み取り/書き込みアクセス
+ 出力先ディレクトリへの書き込みアクセス
+ Linux および の場合macOS、 `ls -la` を使用してアクセス許可を確認します。
+ についてはWindows、「プロパティ」フォルダのセキュリティ設定を確認してください。
### スケジューラログの確認
------
#### [ Linux ]
1. cron サービスが実行されているかどうかを確認します。
```
# For systemd systems
$ sudo systemctl status cron
# or
$ sudo systemctl status crond
# Check if your user has cron job correctly configured
$ crontab -l
```
1. cron 実行ログを表示します。
```
# Check system logs for cron activity (most common locations)
$ sudo tail -f /var/log/syslog | grep CRON
$ sudo tail -f /var/log/cron.log | grep deadline
# View recent cron logs
$ sudo journalctl -u cron -f
$ sudo journalctl -u crond -f # On some systems
```
1. 特定の cron ジョブログを確認します。
```
# View the log file specified in your cron job
$ tail -100f /path/to/logs/deadline_sync.log
```
1. システムログで cron ジョブ実行を検索します。
```
# Look for your specific cron job executions
$ sudo grep "deadline.*incremental-output-download" /var/log/syslog
# Check for cron job starts and completions
$ sudo grep "$(whoami).*CMD.*deadline" /var/log/syslog
```
1. チェックポイントファイルの更新を確認します。
```
# List checkpoint files with timestamps
$ ls -la /path/to/checkpoint/directory/
# Check when checkpoint was last modified
$ stat /path/to/checkpoint/directory/queue-*_download_checkpoint.json
```
1. ログファイルを確認します。
```
$ ls -la /path/to/log/deadline_sync.log
```
------
#### [ macOS ]
起動エージェント実行ログの表示:
1. 起動エージェントが実行中かどうかを確認します。
```
$ sudo launchctl list | grep deadlinesync
```
出力には以下が表示されます `PID Status Label` (PID は、現在実行中で`-`ない場合になります。これは間隔ジョブでは正常です)
1. 詳細な起動エージェントのステータスを表示します。
```
$ sudo launchctl print system/com.user.deadlinesync
```
実行履歴、最後の終了コード、実行数、現在の状態が表示されます。
1. 起動エージェント実行ログを表示します。
```
# View recent logs (last hour)
log show --predicate 'subsystem contains "com.user.deadlinesync"' --last 1h
# View logs from a specific time period
log show --predicate 'subsystem contains "com.user.deadlinesync"' --start '2024-08-27 09:00:00'
```
1. 即時テストのために起動エージェントを強制実行します。
```
$ sudo launchctl kickstart gui/$(id -u)/com.user.deadlinesync
```
これにより、スケジュールに関係なくジョブがすぐにトリガーされ、テストに役立ちます。
1. チェックポイントファイルの更新を確認します。
```
# List checkpoint files with timestamps
$ ls -la /path/to/checkpoint/directory/
```
1. ログファイルを確認します。
```
$ ls -la /path/to/log/deadline_sync.log
```
------
#### [ Server ]
1. Task Scheduler サービスが実行されているかどうかを確認します。
```
C:\> sc query "Schedule"
```
サービスが存在しない場合は、代替名を試してください。
```
C:\> sc query "TaskScheduler"
C:\> sc query "Task Scheduler"
```
1. スケジュールされたタスクを表示します。
```
C:> schtasks /query /tn "DeadlineOutputSync"
```
1. タスクのログファイルを確認します。
```
# View the log file created by your batch script
C:> notepad C:\path\to\logs\deadline_sync.log
```
1. チェックポイントファイルの更新を確認します。
```
# List checkpoint files with timestamps
C:> dir "C:\path\to\checkpoint\directory" /od
```
------