Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Unduhan otomatis
Deadline CLI menyediakan perintah untuk mengunduh output dari semua tugas dalam antrian yang selesai sejak terakhir kali perintah yang sama dijalankan. Anda dapat mengonfigurasi ini sebagai tugas cron atau tugas terjadwal untuk dijalankan berulang kali. Konfigurasi ini mengatur pengunduhan otomatis output secara terus menerus.
Sebelum menyiapkan unduhan otomatis, ikuti langkah-langkah di Profil penyimpanan untuk lampiran pekerjaan untuk mengonfigurasi semua jalur data aset untuk diunggah dan diunduh. Jika pekerjaan menggunakan jalur keluaran yang tidak ada dalam profil penyimpanannya, maka unduhan otomatis akan melewatkan pengunduhan output tersebut dan mencetak pesan peringatan untuk meringkas file yang tidak diunduh. Demikian pula, jika pekerjaan dikirimkan tanpa profil penyimpanan, unduhan otomatis akan melewatkan pekerjaan itu dan mencetak pesan peringatan. Secara default, pengirim Deadline Cloud menampilkan pesan peringatan untuk jalur yang berada di luar profil penyimpanan untuk membantu memastikan konfigurasi yang benar.
Melakukan konfigurasi AWS credentials
Unduhan otomatis menggunakan Deadline CLI untuk terus mengunduh output pekerjaan. Untuk mengotentikasi unduhan ini, Anda memerlukan kredentif IAM jangka panjang. Kredentif monitor Deadline Cloud kedaluwarsa, jadi Anda tidak dapat menggunakannya untuk tujuan ini.
Ikuti langkah-langkah di bawah ini untuk mengatur kredenSIAL jangka panjang.
penting
Perhatikan peringatan berikut:
-
JANGAN gunakan kredentif root akun Anda untuk mengakses AWS sumber daya. KredenSIAL ini menyediakan akses akun tidak terbatas dan sulit untuk dicabut.
-
JANGAN menaruh kunci akses literal atau informasi kredensi dalam file aplikasi Anda. Jika Anda melakukannya, Anda membuat risiko mengekspos kredenSIAL Anda secara tidak sengaja jika, misalnya, Anda mengunggah proyek ke repositori publik.
-
JANGAN ser takan file yang berisi kredenSIAL di area proyek Anda.
-
Amankan kunci akses Anda. Jangan berikan kunci akses Anda kepada pihak yang tidak berwenang, bahkan untuk membantu menemukan pengidentifikasi akun Anda. Dengan melakukan tindakan ini, Anda mungkin memberi seseorang akses permanen ke akun Anda.
-
Ketahuilah bahwa kredenSIAL apa pun yang disimpan dalam file AWS kredenSIAL bersama disimpan dalam teks biasa.
Untuk detail selengkapnya, lihat Praktik terbaik untuk mengelola kunci AWS akses di Refer AWS ensi Umum.
Mmebuat pengguna IAM
Buka konsol IAM di https://console.aws.amazon.com/iam/
. -
Di panel navigasi, pilih Pengguna dan kemudian pilih Buat pengguna.
-
Beri nama pengguna
deadline-output-downloader. Kosongkan kotak centang untuk Berikan akses pengguna ke Konsol Manajemen AWS, lalu pilih Ber ikutnya. -
Pilih Lamp irkan kebijakan secara langsung.
-
Pilih Buat kebijakan untuk membuat kebijakan kustom dengan izin minimum yang diperlukan.
-
Di editor JSON, tentukan izin berikut:
-
Beri nama kebijakan
DeadlineCloudOutputDownloadPolicydan pilih Buat kebijakan. -
Kembali ke halaman pembuatan pengguna, segarkan daftar kebijakan, dan pilih yang baru saja DeadlineCloudOutputDownloadPolicy Anda buat, lalu pilih Ber ikutnya.
-
Tinjau detail pengguna dan kemudian pilih Buat pengguna.
Buat kunci akses
-
Dari halaman detail pengguna, pilih tab Kreden sibilitas keamanan. Pada bagian Access key, pilih Buat access key.
-
Tunjukkan bahwa Anda ingin menggunakan kunci untuk Lainnya, lalu pilih Ber ikutnya, lalu pilih Buat kunci akses.
-
Pada halaman Ambil kunci akses, pilih Tampilkan untuk mengungkapkan nilai kunci akses rahasia pengguna Anda. Anda dapat menyalin kredensialnya atau mengunduh file.csv.
Simpan kunci akses pengguna
-
Simpan kunci akses pengguna dalam file AWS kredensional di sistem Anda:
-
PadaLinux, file tersebut terletak di
~/.aws/credentials -
PadaWindows, file tersebut terletak di
%USERPROFILE%\.aws\credentials
Ganti tombol berikut:
[deadline-downloader] aws_access_key_id=ACCESS_KEY_IDaws_secret_access_key=SECRET_ACCESS_KEYregion=YOUR_AWS_REGION -
penting
Jika Anda tidak lagi membutuhkan pengguna IAM ini, kami sarankan Anda menghapusnya agar sesuai dengan praktik terbaik AWS keamanan. Kami menyarankan Anda meminta pengguna manusia Anda untuk menggunakan kredenSIAL sementara AWS IAM Identity Center saat mengakses AWS.
Prasyarat
Selesaikan langkah-langkah berikut sebelum membuat pekerjaan cron atau tugas terjadwal untuk unduhan otomatis.
-
Jika Anda belum melakukannya, instal Python
dari situs web Python. -
Instal Deadline CLI dengan menjalankan:
python -m pip install deadline -
Konfirmasikan versi Deadline CLI 0.52.1 atau yang lebih baru dengan perintah berikut.
$ deadline --version deadline, version 0.52.1Untuk melihat status unduhan di monitor Deadline Cloud, gunakan versi 0.60.4 atau yang lebih baru. Versi itu mulai merekam status unduhan yang dibaca monitor. Untuk informasi selengkapnya, lihat Lihat status unduhan keluaran di Deadline Cloud.
Uji perintah unduhan keluaran
Untuk memverifikasi perintah berfungsi di lingkungan Anda
-
Dapatkan jalan menuju Deadline
-
Jalankan perintah sync-output ke bootstrap.
/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 \ -
Anda hanya perlu melakukan langkah ini jika mesin pengunduh Anda sama dengan mesin pengiriman. Ganti
--storage-profile-id YOUR_PROFILE_ID \di atas dengan--ignore-storage-profiles -
Kirim pekerjaan tes.
-
Unduh file.zip dari GitHub.
-
Buka repositori deadline-cloud-sample
di situs web. GitHub -
Pilih Kode dan kemudian, dari menu tarik-turun, pilih Unduh ZIP.
-
Buka zip arsip yang diunduh ke direktori lokal.
-
-
Jalankan .
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output -
Jalankan .
deadline bundle submit .-
Jika Anda tidak memiliki pengaturan konfigurasi tenggat waktu default, Anda mungkin perlu memberikan yang berikut di baris perintah.
--farm-idYOUR-FARM-ID--queue-idYOUR-QUEUE-ID
-
-
Tunggu pekerjaan selesai sebelum melanjutkan ke langkah berikutnya.
-
-
Jalankan perintah sync-output lagi.
/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 -
Verifikasi hal berikut:
-
Output pekerjaan pengujian Anda muncul di direktori tujuan.
-
File pos pemeriksaan dibuat di direktori pos pemeriksaan yang Anda tentukan.
-
Siapkan unduhan terjadwal
Pilih tab untuk sistem operasi Anda untuk mempelajari cara mengonfigurasi unduhan otomatis untuk setiap 5 menit.
Verifikasi penyiapannya
Untuk memverifikasi penyiapan unduhan otomatis berhasil, selesaikan langkah-langkah berikut.
-
Kirim pekerjaan tes baru.
-
Tunggu satu interval penjadwal selesai, yang dalam hal ini adalah 5 menit.
-
Verifikasi bahwa output baru diunduh secara otomatis.
Jika output tidak diunduh, periksa bagian Pemecahan masalah untuk log proses.
Memecahkan masalah unduhan otomatis
Jika Anda mengalami masalah dengan unduhan otomatis, periksa hal berikut:
Unduh kode kesalahan
Ketika unduhan gagal, kolom Status un duhan di monitor Deadline Cloud menyebutkan alasannya, dan deadline queue sync-output perintah mencatat salah satu kode kesalahan berikut. Sebagian besar kesalahan ini diselesaikan pada mesin yang menjalankan perintah unduhan, yang seringkali merupakan mesin yang berbeda dari yang Anda lihat di monitor.
PERMISSION_DENIED(Izin ditolak)-
Pengunduh tidak diizinkan untuk menulis ke lokasi keluaran, atau AWS kredensialnya ditolak aksesnya. Berikan pengguna yang menjalankan perintah unduhan akses menulis ke lokasi keluaran, konfirmasikan AWS profil perintah memiliki akses ke antrian, dan jalankan perintah lagi.
DISK_FULL(Disk penuh)-
Mesin yang menjalankan unduhan kehabisan ruang disk. Kosongkan ruang pada drive yang memegang lokasi output, lalu jalankan perintah lagi.
PATH_NOT_FOUND(Jalur tidak ditemukan)-
Tujuan keluaran tidak ada atau tidak dipasang pada mesin yang menjalankan unduhan. Buat direktori atau pasang drive bersama, lalu jalankan perintah lagi.
NETWORK_ERROR(Kesalahan jaringan)-
Gangguan jaringan menghentikan transfer. Kesalahan jaringan biasanya bersifat sementara. Jalankan perintah lagi, dan periksa konektivitas mesin jika kesalahan berulang.
UNKNOWN(Gagal)-
Pengunduh tidak dapat mengidentifikasi penyebab tertentu. Monitor menunjukkan Gagal untuk kode ini dan untuk kode apa pun yang tidak dikenali. Periksa output log dari
deadline queue sync-outputperintah untuk kesalahan yang mendasarinya.
Pekerjaan yang unduhannya gagal dicoba ulang secara otomatis setiap kali dijalankan nanti. Setelah lima upaya gagal, pengunduh berhenti mencoba lagi pekerjaan dan mencetak peringatan. Setelah Anda memperbaiki penyebabnya, pulihkan pekerjaan dengan menjalankan perintah download dengan jendela tampilan balik yang mencakup saat pekerjaan selesai:
deadline queue sync-output --farm-idFARM_ID--queue-idQUEUE_ID\ --storage-profile-idSTORAGE_PROFILE_ID\ --force-bootstrap --bootstrap-lookback-minutes1440
Berikan kedua bendera bersama-sama. --bootstrap-lookback-minutesOpsi default ke 0, jadi dengan sendirinya --force-bootstrap tidak memulihkan apa pun.
Mengapa pekerjaan saya dilewati?
Saat pengunduh melewatkan pekerjaan, kolom Status unduh menyebutkan alasannya langsung di sel:
- Tidak ada lampiran (
no_attachments) -
Pekerjaan tidak dikirimkan dengan lampiran pekerjaan, sehingga tidak memiliki file output yang direkam untuk diunduh. Beberapa pekerjaan tidak pernah menghasilkan output yang dapat diunduh, jadi pekerjaan yang dilewati tanpa lampiran biasanya tidak memerlukan tindakan.
- Profil penyimpanan hilang (
missing_storage_profile) -
Pekerjaan dikirimkan tanpa profil penyimpanan sementara perintah unduh menggunakannya, sehingga pengunduh tidak tahu di mana file pekerjaan berada di setiap mesin. Tidak ada yang diunduh untuk pekerjaan sampai profil penyimpanan dikonfigurasi untuk itu. Profil penyimpanan pekerjaan diatur saat pekerjaan dikirimkan, jadi kirimkan pekerjaan dengan profil penyimpanan dan berikan profil yang sama ke perintah download. Di tabel tugas, status profil penyimpanan hilang adalah tautan yang membuka penjelasan, tautan dokumentasi, dan tombol Troubles hooting with AI. Untuk informasi selengkapnya, lihat Profil penyimpanan untuk lampiran pekerjaan.
Pekerjaan yang dilewati tanpa alasan yang ditampilkan dibatalkan atau dihentikan sebelum menghasilkan output. Tidak perlu tindakan.
Apakah ini masalah unduhan atau masalah render?
Masalah di kolom Status Unduh tugas dapat berarti dua hal yang berbeda, dan mereka memiliki perbaikan yang berbeda. Teks status memberi tahu Anda mana yang Anda miliki:
-
Tidak ada output pada tugas yang status menjalan
FAILEDkannya berarti tugas gagal dirender di peternakan. Tidak ada file yang pernah diproduksi, jadi tidak ada yang bisa diunduh. Drive dan jaringan Anda baik-baik saja. Periksa log tugas untuk menemukan kesalahan render, memperbaikinya, dan meminta tugas. Tugas juga dapat menunjukkan Tidak ada output setelah selesai dengan sukses tanpa menulis file apa pun, yang normal dan tidak memerlukan tindakan. -
Nama kesalahan, seperti Izin ditolak, berarti tugas yang dirender dan outputnya ada, dan menyalin file ke sistem file Anda gagal. Selesaikan kesalahan menggunakanUnduh kode kesalahan.
Dalam tabel pekerjaan, kedua masalah muncul sebagai segmen merah di bilah kemajuan unduhan pekerjaan. Buka tabel tugas pekerjaan untuk membedakannya. Pekerjaan di mana setiap tugas gagal menunjukkan tanda hubung alih-alih kesalahan unduhan, karena pekerjaan tidak pernah menghasilkan output. Kolom status pekerjaan itu sendiri melaporkan kegagalan itu. Mendiagnosis unduhan dalam kasus kegagalan rendering ini membuang waktu, jadi selalu periksa status menjalankan tugas terlebih dahulu.
Memecahkan masalah dengan AI
Pesan kegagalan unduhan di monitor Deadline Cloud, termasuk indikator gagal sinkronisasi keluaran merah, menyertakan tombol Trou bleshooting with AI. Tombol membuka asisten Deadline Cloud, yang membaca catatan status unduhan untuk antrian Anda dan memandu Anda melalui kegagalan spesifik Anda, termasuk perintah untuk dijalankan untuk memperbaikinya.
Jangkau saat unduhan terus gagal setelah Anda mencoba memperbaiki kode kesalahannya, ketika Anda melihat kesalahan yang tidak Anda kenali, atau ketika Anda tidak yakin mesin mana yang masalahnya aktif. Tombol muncul saat asisten Deadline Cloud diaktifkan untuk monitor Anda. Untuk informasi selengkapnya, lihat Asisten Deadline Cloud.
Masalah profil penyimpanan
-
Kesalahan seperti
[Errno 2] No such file or directoryatau[Errno 13] Permission denieddalam file log dapat terkait dengan profil penyimpanan yang hilang atau salah dikonfigurasi. -
Lihat Profil penyimpanan untuk informasi tentang cara mengatur profil penyimpanan Anda saat mesin pengunduh berbeda dari mesin pengirim.
-
Untuk unduhan mesin yang sama, coba bendera.
--ignore-storage-profiles
Izin direktori
-
Pastikan pengguna layanan penjadwal memiliki:
-
Read/write akses ke direktori pos pemeriksaan
-
Tulis akses ke direktori tujuan keluaran
-
-
Untuk Linux danmacOS, gunakan
ls -launtuk memeriksa izin. -
UntukWindows, tinjau pengaturan Keamanan di folder Properties.