As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Downloads automáticos
O Deadline CLI fornece um comando para baixar a saída de todas as tarefas em uma fila que foi concluída desde a última vez em que o mesmo comando foi executado. Você pode configurar isso como um cron job ou uma tarefa agendada para ser executada repetidamente. Essa configuração configura o download automático da saída de forma contínua.
Antes de configurar os downloads automáticos, siga as etapas em Perfis de armazenamento para anexos de tarefas para configurar todos os caminhos dos dados do ativo para upload e download. Se um trabalho usa um caminho de saída que não está em seu perfil de armazenamento, o download automático ignora o download dessa saída e imprime mensagens de aviso para resumir os arquivos que não foram baixados. Da mesma forma, se um trabalho for enviado sem um perfil de armazenamento, o download automático ignora esse trabalho e imprime uma mensagem de aviso. Por padrão, os remetentes do Deadline Cloud exibem mensagens de aviso para caminhos que estão fora dos perfis de armazenamento para ajudar a garantir a configuração correta.
Configurar AWS credenciais
Os downloads automáticos usam a CLI do Deadline para baixar continuamente os resultados do trabalho. Para autenticar esses downloads, você precisa de credenciais IAM de longo prazo. As credenciais do monitor Deadline Cloud expiram, então você não pode usá-las para essa finalidade.
Siga as etapas abaixo para configurar credenciais de longo prazo.
Importante
Tenha atenção aos seguintes avisos:
-
NÃO use as credenciais raiz da sua conta para acessar AWS recursos. Estas credenciais fornecem acesso ilimitado à conta e são difíceis de revogar.
-
NÃO coloque chaves de acesso literais ou informações de credenciais em arquivos de aplicações. Se colocar, criará um risco de exposição acidental das credenciais se, por exemplo, fizer upload do projeto em um repositório público.
-
NÃO inclua arquivos que contenham credenciais em sua área de projeto.
-
Proteja suas chaves de acesso. Não as forneça a terceiros não autorizados, mesmo que seja para ajudar a localizar os identificadores da sua conta. Ao fazer isso, você pode dar a alguém acesso permanente à conta.
-
Lembre-se de que todas as credenciais armazenadas no arquivo de AWS credenciais compartilhadas são armazenadas em texto sem formatação.
Para obter mais detalhes, consulte Práticas recomendadas para gerenciar chaves de AWS acesso na Referência AWS geral.
Criar um usuário do IAM
Abra o console do IAM em https://console.aws.amazon.com/iam/
. -
No painel de navegação, selecione Usuários e escolha Criar usuário.
-
Nomeie o usuário
deadline-output-downloader. Desmarque a caixa de seleção Fornecer acesso do usuário ao Console de gerenciamento da AWS e escolha Avançar. -
Selecione Anexar políticas diretamente.
-
Escolha Criar política para criar uma política personalizada com as permissões mínimas necessárias.
-
No editor JSON, especifique as seguintes permissões:
-
Dê um nome à política
DeadlineCloudOutputDownloadPolicye escolha Criar política. -
Retorne à página de criação do usuário, atualize a lista de políticas, selecione a DeadlineCloudOutputDownloadPolicy que você acabou de criar e escolha Avançar.
-
Revise os detalhes do usuário e escolha Criar usuário.
Criar uma chave de acesso
-
Na página de detalhes do usuário, selecione a guia Credenciais de segurança. Na seção Chaves de acesso, escolha Criar chave de acesso.
-
Indique que você deseja usar a chave para Outro, escolha Avançar e, em seguida, escolha Criar chave de acesso.
-
Na página Recuperar chaves de acesso, escolha Mostrar para revelar o valor da chave de acesso secreta do seu usuário. Você pode copiar as credenciais ou baixar um arquivo .csv.
Armazene as chaves de acesso do usuário
-
Armazene as chaves de acesso do usuário no arquivo de AWS credenciais em seu sistema:
-
LinuxAtivado, o arquivo está localizado em
~/.aws/credentials -
WindowsAtivado, o arquivo está localizado em
%USERPROFILE%\.aws\credentials
Substitua as seguintes chaves:
[deadline-downloader] aws_access_key_id=ACCESS_KEY_IDaws_secret_access_key=SECRET_ACCESS_KEYregion=YOUR_AWS_REGION -
Importante
Quando você não precisar mais desse usuário do IAM, recomendamos que você o remova para se alinhar às melhores práticas AWS de segurança. Recomendamos que você exija que seus usuários humanos usem credenciais temporárias Centro de Identidade do AWS IAM durante o acesso AWS.
Pré-requisitos
Conclua as etapas a seguir antes de criar um cron job ou uma tarefa agendada para download automático.
-
Se você ainda não o fez, instale o Python a
partir do site do Python. -
Instale o Deadline CLI executando:
python -m pip install deadline -
Confirme se a versão do Deadline CLI é 0.52.1 ou mais recente com o comando a seguir.
$ deadline --version deadline, version 0.52.1Para ver o status do download no monitor Deadline Cloud, use a versão 0.60.4 ou mais recente. Essa versão começou a registrar o status do download que o monitor lê. Para obter mais informações, consulte Exibir o status do download de saída no Deadline Cloud.
Teste o comando de download de saída
Para verificar se o comando funciona em seu ambiente
-
Conheça o caminho até o Deadline
-
Execute o comando sync-output para inicializar.
/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 \ -
Você só precisará executar essa etapa se sua máquina de download for a mesma que a máquina de envio. Substitua
--storage-profile-id YOUR_PROFILE_ID \acima por--ignore-storage-profiles. -
Envie um trabalho de teste.
-
Faça o download do arquivo.zip do GitHub.
-
Abra o repositório deadline-cloud-samples no site.
GitHub -
Escolha Código e, no menu suspenso, selecione Baixar ZIP.
-
Descompacte o arquivo baixado em um diretório local.
-
-
Executar
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output -
Executar
deadline bundle submit .-
Se você não tiver a configuração de prazo padrão, talvez seja necessário fornecer o seguinte na linha de comando.
--farm-idYOUR-FARM-ID--queue-idYOUR-QUEUE-ID
-
-
Aguarde a conclusão do trabalho antes de passar para a próxima etapa.
-
-
Execute o comando sync-output novamente.
/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 -
Verifique o seguinte:
-
As saídas do seu trabalho de teste aparecem no diretório de destino.
-
Um arquivo de ponto de verificação é criado no diretório de pontos de verificação especificado.
-
Configurar downloads agendados
Selecione a guia do seu sistema operacional para saber como configurar downloads automáticos a cada 5 minutos.
Verificar a configuração.
Para verificar se a configuração dos downloads automáticos foi bem-sucedida, conclua as etapas a seguir.
-
Envie um novo trabalho de teste.
-
Aguarde a conclusão de um intervalo do agendador, que nesse caso é de 5 minutos.
-
Verifique se as novas saídas são baixadas automaticamente.
Se as saídas não forem baixadas, consulte a seção Solução de problemas para ver os registros do processo.
Solução de problemas de downloads automáticos
Se você encontrar problemas com os downloads automáticos, verifique o seguinte:
Baixar códigos de erro
Quando um download falha, a coluna de status do download no monitor do Deadline Cloud indica o motivo e o deadline queue sync-output comando registra um dos seguintes códigos de erro. A maioria desses erros é resolvida na máquina que executa o comando de download, que geralmente é uma máquina diferente daquela em que você visualiza o monitor.
PERMISSION_DENIED(Permissão negada)-
O downloader não tem permissão para gravar no local de saída ou suas AWS credenciais tiveram o acesso negado. Conceda ao usuário que executa o comando de download acesso de gravação ao local de saída, confirme se o AWS perfil do comando tem acesso à fila e execute o comando novamente.
DISK_FULL(Disco cheio)-
A máquina que estava executando o download ficou sem espaço em disco. Libere espaço na unidade que contém o local de saída e execute o comando novamente.
PATH_NOT_FOUND(Caminho não encontrado)-
O destino de saída não existe ou não está montado na máquina que está executando o download. Crie o diretório ou monte o drive compartilhado e execute o comando novamente.
NETWORK_ERROR(Erro de rede)-
Uma interrupção na rede interrompeu a transferência. Os erros de rede geralmente são transitórios. Execute o comando novamente e verifique a conectividade da máquina se o erro se repetir.
UNKNOWN(Falha)-
O downloader não conseguiu identificar uma causa específica. O monitor mostra Falha para esse código e para qualquer código que ele não reconheça. Verifique na saída de log do
deadline queue sync-outputcomando o erro subjacente.
Uma tarefa cujo download falha é repetida automaticamente em cada execução posterior. Depois de cinco tentativas fracassadas, o downloader para de repetir o trabalho e imprime um aviso. Depois de corrigir a causa, recupere o trabalho executando o comando de download com uma janela de lookback que mostra quando o trabalho foi concluído:
deadline queue sync-output --farm-idFARM_ID--queue-idQUEUE_ID\ --storage-profile-idSTORAGE_PROFILE_ID\ --force-bootstrap --bootstrap-lookback-minutes1440
Passe as duas bandeiras juntas. A --bootstrap-lookback-minutes opção padrão é 0, portanto, --force-bootstrap sozinha, não recupera nada.
Por que meu trabalho foi ignorado?
Quando o baixador pula um trabalho, a coluna Status do download nomeia o motivo diretamente na célula:
- Sem anexos ()
no_attachments -
O trabalho não foi enviado com anexos de trabalho, portanto, não tem arquivos de saída gravados para baixar. Alguns trabalhos nunca produzem resultados para download, portanto, um trabalho ignorado sem anexos geralmente não precisa de nenhuma ação.
- Perfil de armazenamento ausente (
missing_storage_profile) -
O trabalho foi enviado sem um perfil de armazenamento, enquanto o comando de download usa um, então o downloader não sabe onde os arquivos do trabalho pertencem em cada máquina. Nada é baixado para a tarefa até que um perfil de armazenamento seja configurado para ela. O perfil de armazenamento de um trabalho é definido quando o trabalho é enviado, então envie o trabalho com um perfil de armazenamento e passe o mesmo perfil para o comando de download. Na tabela de tarefas, o status do perfil de armazenamento ausente é um link que abre uma explicação, um link de documentação e um botão Solucionar problemas com IA. Para obter mais informações, consulte Perfis de armazenamento para anexos de tarefas.
Um trabalho ignorado sem nenhum motivo mostrado foi cancelado ou interrompido antes de produzir a saída. Não precisa de ação.
É um problema de download ou de renderização?
Um problema na coluna de status de download de uma tarefa pode significar duas coisas diferentes e elas têm soluções diferentes. O texto de status informa qual deles você tem:
-
Nenhuma saída em uma tarefa cujo status de execução é
FAILEDsignifica que a tarefa falhou na renderização na fazenda. Nenhum arquivo foi produzido, então não havia nada para baixar. Seu drive e sua rede estão bem. Verifique os registros da tarefa para encontrar o erro de renderização, corrigi-lo e colocar a tarefa na fila novamente. Uma tarefa também pode mostrar Nenhuma saída após ser concluída com êxito sem gravar nenhum arquivo, o que é normal e não precisa de nenhuma ação. -
Um nome de erro, como Permissão negada, significa que a tarefa foi renderizada e sua saída existem e a cópia dos arquivos para o sistema de arquivos falhou. Resolva o erro usandoBaixar códigos de erro.
Na tabela de trabalhos, os dois problemas aparecem como um segmento vermelho na barra de progresso do download do trabalho. Abra a tabela de tarefas do trabalho para diferenciá-las. Um trabalho em que cada tarefa falhou mostra um traço em vez de um erro de download, porque o trabalho nunca produziu saída. A própria coluna de status do trabalho relata essa falha. Diagnosticar o download nesses casos de falha de renderização desperdiça tempo, então sempre verifique primeiro o status de execução da tarefa.
Solucione problemas com IA
As mensagens de falha de download no monitor do Deadline Cloud, incluindo o indicador vermelho de falha na sincronização de saída, incluem um botão Solucionar problemas com IA. O botão abre o assistente Deadline Cloud, que lê o registro do status do download da sua fila e orienta você sobre sua falha específica, incluindo os comandos a serem executados para corrigi-la.
Busque-o quando um download continuar falhando depois de tentar corrigir o código de erro, quando você vê um erro que não reconhece ou quando não tem certeza em qual máquina o problema está. O botão aparece quando o assistente Deadline Cloud está ativado para seu monitor. Para obter mais informações, consulte Assistente do Deadline Cloud.
Problemas com o perfil de armazenamento
-
Um erro como
[Errno 2] No such file or directoryou[Errno 13] Permission deniedno arquivo de log pode estar relacionado a perfis de armazenamento ausentes ou mal configurados. -
Consulte Perfis de armazenamento para obter informações sobre como configurar seus perfis de armazenamento quando a máquina de download é diferente da máquina de envio.
-
Para downloads na mesma máquina, experimente a
--ignore-storage-profilesbandeira.
Permissões de diretório
-
Certifique-se de que o usuário do serviço de agendador tenha:
-
Read/write acesso ao diretório de pontos de verificação
-
Acesso de gravação ao diretório de destino de saída
-
-
Para Linux emacOS, use
ls -lapara verificar as permissões. -
ParaWindows, revise as configurações de segurança na pasta Propriedades.