Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Download automatici
L'interfaccia a riga di comando di Deadline fornisce un comando per scaricare l'output di tutte le attività in una coda completate dall'ultima volta in cui è stato eseguito lo stesso comando. Puoi configurarlo come un cron job o un'attività pianificata da eseguire ripetutamente. Questa configurazione imposta il download automatico dell'output su base continua.
Prima di configurare i download automatici, segui i passaggi descritti in Profili di archiviazione per allegati di lavoro per configurare tutti i percorsi dei dati delle risorse per il caricamento e il download. Se un processo utilizza un percorso di output non presente nel relativo profilo di archiviazione, il download automatico ignora il download dell'output e stampa i messaggi di avviso per riepilogare i file non scaricati. Analogamente, se un lavoro viene inviato senza un profilo di archiviazione, il download automatico lo ignora e stampa un messaggio di avviso. Per impostazione predefinita, i mittenti di Deadline Cloud visualizzano messaggi di avviso per i percorsi esterni ai profili di archiviazione per contribuire a garantire la corretta configurazione.
Configurazione AWS credenziali
I download automatici utilizzano la CLI di Deadline per scaricare continuamente i risultati dei lavori. Per autenticare questi download, sono necessarie credenziali IAM a lungo termine. Le credenziali di monitoraggio di Deadline Cloud scadono, quindi non puoi utilizzarle per questo scopo.
Segui i passaggi seguenti per configurare le credenziali a lungo termine.
Importante
Presta attenzione ai seguenti avvertimenti:
-
NON utilizzare le credenziali root del tuo account per accedere AWS alle risorse. Queste credenziali forniscono un accesso illimitato all’account e sono difficili da revocare.
-
NON inserire chiavi di accesso letterali o informazioni sulle credenziali nei file dell’applicazione. In caso contrario, rischi di esporre accidentalmente le credenziali se, per esempio, carichi il progetto in repository pubblici.
-
NON includere file che contengono credenziali nell’area del progetto.
-
Proteggi le tue chiavi di accesso. Non fornire le chiavi di accesso a parti non autorizzate, neppure per contribuire a trovare gli identificatori di account. In questo modo, potresti concedere a qualcuno l'accesso permanente al tuo account.
-
Tieni presente che tutte le credenziali archiviate nel file delle AWS credenziali condivise sono archiviate in testo normale.
Per maggiori dettagli, vedi Best practice per la gestione delle chiavi di AWS accesso nella Guida AWS generale.
Creare un utente IAM
Aprire la console IAM all'indirizzo https://console.aws.amazon.com/iam/
. -
Nel riquadro di navigazione, seleziona Utenti, quindi seleziona Crea utente.
-
Assegna un nome all'utente
deadline-output-downloader. Deseleziona la casella di controllo Fornisci l'accesso utente a Console di gestione AWS, quindi scegli Avanti. -
Scegli Allega direttamente le politiche.
-
Scegli Crea policy per creare una policy personalizzata con le autorizzazioni minime richieste.
-
Nell'editor JSON, specifica le seguenti autorizzazioni:
-
Assegna un nome alla policy
DeadlineCloudOutputDownloadPolicye scegli Crea policy. -
Torna alla pagina di creazione dell'utente, aggiorna l'elenco dei criteri e seleziona quelli DeadlineCloudOutputDownloadPolicy appena creati, quindi scegli Avanti.
-
Rivedi i dettagli dell'utente e quindi scegli Crea utente.
Creare una chiave di accesso
-
Dalla pagina dei dettagli dell'utente, seleziona la scheda Credenziali di sicurezza. Nella sezione Chiavi di accesso, scegliere Crea chiave di accesso.
-
Indica che desideri utilizzare la chiave per Altro, quindi scegli Avanti, quindi scegli Crea chiave di accesso.
-
Nella pagina Recupera le chiavi di accesso, scegli Mostra per rivelare il valore della chiave di accesso segreta dell'utente. Puoi copiare le credenziali o scaricare un file .csv.
Memorizza le chiavi di accesso dell'utente
-
Archivia le chiavi di accesso degli utenti nel file AWS delle credenziali sul tuo sistema:
-
SìLinux, il file si trova in
~/.aws/credentials -
SìWindows, il file si trova in
%USERPROFILE%\.aws\credentials
Sostituisci i seguenti tasti:
[deadline-downloader] aws_access_key_id=ACCESS_KEY_IDaws_secret_access_key=SECRET_ACCESS_KEYregion=YOUR_AWS_REGION -
Importante
Quando non hai più bisogno di questo utente IAM, ti consigliamo di rimuoverlo per allinearti alle best practice AWS di sicurezza. Ti consigliamo di richiedere agli utenti umani di utilizzare credenziali temporanee Centro identità AWS IAM durante l'accesso. AWS
Prerequisiti
Completa i passaggi seguenti prima di creare un cron job o un'attività pianificata per il download automatico.
-
Se non l'hai già fatto, installa Python
dal sito web di Python. -
Installa la CLI di Deadline eseguendo:
python -m pip install deadline -
Verifica che la versione di Deadline CLI sia 0.52.1 o successiva con il seguente comando.
$ deadline --version deadline, version 0.52.1Per vedere lo stato del download nel monitor Deadline Cloud, utilizza la versione 0.60.4 o successiva. Quella versione ha iniziato a registrare lo stato del download letto dal monitor. Per ulteriori informazioni, consulta Visualizza lo stato del download dell'output in Deadline Cloud.
Prova il comando di download dell'output
Per verificare che il comando funzioni nel tuo ambiente
-
Ottieni il percorso verso Deadline
-
Esegui il comando sync-output su 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 \ -
È necessario eseguire questo passaggio solo se la macchina per il download è la stessa della macchina di invio. Sostituisci
--storage-profile-id YOUR_PROFILE_ID \quanto sopra con--ignore-storage-profiles. -
Invia un lavoro di prova.
-
Scarica il file .zip da GitHub.
-
Apri il repository deadline-cloud-samples sul sito web.
GitHub -
Scegli Codice e poi, dal menu a discesa, seleziona Scarica ZIP.
-
Decomprimi l'archivio scaricato in una directory locale.
-
-
Esecuzione
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output -
Esecuzione
deadline bundle submit .-
Se non disponi della configurazione di scadenza predefinita, potresti dover fornire quanto segue nella riga di comando.
--farm-idYOUR-FARM-ID--queue-idYOUR-QUEUE-ID
-
-
Attendi il completamento del lavoro prima di passare alla fase successiva.
-
-
Esegui nuovamente il comando 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 -
Verificare quanto segue:
-
Gli output del processo di test vengono visualizzati nella directory di destinazione.
-
Un file di checkpoint viene creato nella directory dei checkpoint specificata.
-
Configura i download pianificati
Seleziona la scheda relativa al tuo sistema operativo per scoprire come configurare i download automatici ogni 5 minuti.
Verifica la configurazione
Per verificare che la configurazione dei download automatici sia avvenuta correttamente, completa i seguenti passaggi.
-
Invia un nuovo lavoro di prova.
-
Attendi il completamento di un intervallo di pianificazione, che in questo caso è di 5 minuti.
-
Verifica che i nuovi output vengano scaricati automaticamente.
Se gli output non vengono scaricati, consulta la sezione Risoluzione dei problemi per i log del processo.
Risoluzione dei problemi relativi ai download automatici
Se riscontri problemi con i download automatici, verifica quanto segue:
Codici di errore del download
Quando un download non riesce, la colonna Stato del download nel monitor Deadline Cloud indica il motivo e il deadline queue sync-output comando registra uno dei seguenti codici di errore. La maggior parte di questi errori viene risolta sul computer che esegue il comando di download, che spesso è un computer diverso da quello su cui si visualizza il monitor.
PERMISSION_DENIED(Autorizzazione negata)-
Al downloader non è consentito scrivere nella posizione di output o alle sue AWS credenziali è stato negato l'accesso. Concedi all'utente che esegue il comando di download l'accesso in scrittura alla posizione di output, conferma che il AWS profilo del comando abbia accesso alla coda ed esegui nuovamente il comando.
DISK_FULL(Disco pieno)-
Il computer che esegue il download ha esaurito lo spazio su disco. Libera spazio sull'unità che contiene la posizione di output, quindi esegui nuovamente il comando.
PATH_NOT_FOUND(Percorso non trovato)-
La destinazione di output non esiste o non è montata sul computer che esegue il download. Crea la directory o monta l'unità condivisa, quindi esegui nuovamente il comando.
NETWORK_ERROR(Errore di rete)-
Un'interruzione della rete ha interrotto il trasferimento. Gli errori di rete sono in genere transitori. Esegui nuovamente il comando e controlla la connettività del computer se l'errore si ripete.
UNKNOWN(Fallito)-
Il downloader non è riuscito a identificare una causa specifica. Il monitor mostra Failed per questo codice e per qualsiasi codice che non riconosce. Controllate l'output del registro del
deadline queue sync-outputcomando per individuare l'errore sottostante.
Un processo il cui download non riesce viene ritentato automaticamente a ogni esecuzione successiva. Dopo cinque tentativi falliti, il downloader interrompe il tentativo di nuovo il lavoro e stampa un avviso. Dopo aver risolto la causa, ripristina il lavoro eseguendo il comando di download con una finestra di riepilogo che indica quando il lavoro è terminato:
deadline queue sync-output --farm-idFARM_ID--queue-idQUEUE_ID\ --storage-profile-idSTORAGE_PROFILE_ID\ --force-bootstrap --bootstrap-lookback-minutes1440
Passa entrambe le bandiere insieme. Il valore predefinito dell'--bootstrap-lookback-minutesopzione è 0, quindi da sola non --force-bootstrap recupera nulla.
Perché il mio lavoro è stato saltato?
Quando il downloader salta un processo, nella colonna Stato del download viene indicato il motivo direttamente nella cella:
- Nessun allegato ()
no_attachments -
Il lavoro non è stato inviato con allegati, quindi non ha file di output registrati da scaricare. Alcuni lavori non producono mai un output scaricabile, quindi un lavoro saltato e senza allegati di solito non richiede alcuna azione.
- Profilo di archiviazione mancante ()
missing_storage_profile -
Il lavoro è stato inviato senza un profilo di archiviazione mentre il comando di download ne utilizza uno, quindi il downloader non sa dove appartengono i file del lavoro su ogni computer. Non viene scaricato nulla per il processo finché non viene configurato un profilo di archiviazione. Il profilo di archiviazione di un processo viene impostato al momento dell'invio, quindi invia il lavoro con un profilo di archiviazione e passa lo stesso profilo al comando di download. Nella tabella delle attività, lo stato del profilo di archiviazione mancante è un collegamento che apre una spiegazione, un collegamento alla documentazione e un pulsante Troubleshoot with AI. Per ulteriori informazioni, consulta Profili di archiviazione per allegati di lavoro.
Un lavoro saltato senza motivo è stato annullato o interrotto prima della produzione dell'output. Non necessita di alcuna azione.
È un problema di download o di rendering?
Un problema nella colonna Stato del download di un'attività può significare due cose diverse e avere correzioni diverse. Il testo di stato indica quale hai:
-
L'assenza di output su un'operazione il cui stato di esecuzione è
FAILEDindica che il rendering dell'attività non è stato eseguito nella farm. Non è mai stato prodotto alcun file, quindi non c'era nulla da scaricare. L'unità e la rete sono a posto. Controlla i log dell'operazione per trovare l'errore di rendering, correggerlo e mettere in coda l'operazione. Un'attività può anche mostrare Nessun output dopo aver completato con successo senza scrivere alcun file, il che è normale e non richiede alcuna azione. -
Un nome di errore, ad esempio Autorizzazione negata, indica che l'operazione è stata renderizzata e il relativo output esiste e la copia dei file nel file system non è riuscita. Risolvete l'errore utilizzando. Codici di errore del download
Nella tabella dei lavori, entrambi i problemi vengono visualizzati come un segmento rosso nella barra di avanzamento del download del processo. Apri la tabella delle attività del lavoro per distinguerle. Un processo in cui ogni operazione non è riuscita mostra un trattino anziché un errore di download, poiché il lavoro non ha mai prodotto alcun output. La colonna sullo stato del processo riporta l'errore. La diagnosi del download in questi casi di errori di rendering comporta una perdita di tempo, quindi controllate sempre prima lo stato di esecuzione dell'attività.
Risolvi i problemi con l'IA
I messaggi di errore di download nel monitor Deadline Cloud, incluso l'indicatore rosso Output sync failed, includono un pulsante Troubleshoot with AI. Il pulsante apre l'assistente Deadline Cloud, che legge il record dello stato del download relativo alla coda e illustra l'errore specifico, inclusi i comandi da eseguire per correggerlo.
Richiedilo quando un download continua a fallire dopo aver provato a correggere il codice di errore, quando vedi un errore che non riconosci o quando non sei sicuro su quale computer si tratti del problema. Il pulsante appare quando l'assistente Deadline Cloud è abilitato per il tuo monitor. Per ulteriori informazioni, consulta Assistente Deadline Cloud.
Problemi relativi al profilo di archiviazione
-
Un errore simile
[Errno 2] No such file or directoryo presente[Errno 13] Permission deniednel file di registro potrebbe essere correlato a profili di archiviazione mancanti o non configurati correttamente. -
Vedi Profili di archiviazione per informazioni su come impostare i profili di archiviazione quando il computer che esegue il download è diverso da quello di invio.
-
Per i download sullo stesso computer, prova il flag.
--ignore-storage-profiles
Autorizzazioni directory
-
Assicurati che l'utente del servizio di pianificazione disponga di:
-
Read/write accesso alla directory dei checkpoint
-
Accesso in scrittura alla directory di destinazione dell'output
-
-
Per Linux emacOS, usa
ls -laper controllare le autorizzazioni. -
PerWindows, consulta le impostazioni di sicurezza nella cartella Proprietà.