

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á.

# Solução de problemas
<a name="troubleshooting"></a>

Os procedimentos e dicas a seguir podem ajudar você a solucionar problemas com seus farms e recursos do AWS Deadline Cloud.

**Topics**
+ [Por que um usuário não consegue ver minha fazenda, minha frota ou minha fila?](#troubleshooting_user_not_seeing_farm)
+ [Por que os trabalhadores não estão aceitando meus empregos?](#troubleshooting_workers_not_picking_jobs)
+ [Por que meu funcionário está preso correndo?](#troubleshooting_worker_stuck_running)
+ [Solução de problemas de trabalhos do Deadline](#jobs-troubleshooting)
+ [Registros de aplicativos de desktop do Deadline Cloud](#troubleshooting-desktop-logs)
+ [Recursos adicionais do](#troubleshooting_additional_resources)

## Por que um usuário não consegue ver minha fazenda, minha frota ou minha fila?
<a name="troubleshooting_user_not_seeing_farm"></a>

### Acesso do usuário
<a name="troubleshooting_user_access"></a>

Quando seus usuários não estão vendo suas fazendas, frotas ou filas no monitor do Deadline Cloud, pode haver um problema com o acesso deles à sua fazenda e aos recursos.

Usuários sem acesso a nenhuma fazenda recebem a mensagem “Nenhuma fazenda disponível” no monitor Deadline Cloud.

**Para confirmar que você tem o usuário ou grupo correto atribuído à sua fazenda, frota ou fila**

1. No console do AWS Deadline Cloud, encontre sua fazenda, frota ou fila e escolha Gerenciamento de ** ** acesso.

1. A guia de grupos é selecionada por padrão. Se você estiver atribuindo permissões por grupos, o que é recomendado, seu grupo deve ser exibido na lista e ter um nível de acesso atribuído.

   Se o grupo não estiver na lista, escolha ** Adicionar grupo ** para atribuir permissão ao grupo.

1. Se você estiver atribuindo permissões por usuário, selecione a ** guia ** Usuários. Seu usuário deve ser exibido na lista e ter um nível de acesso atribuído.

   Se seu usuário não estiver na lista, escolha ** Adicionar usuário ** para atribuir permissão ao usuário.

**Para confirmar que você tem o usuário atribuído ao seu grupo**

1. No console do AWS Deadline Cloud, encontre sua fazenda, frota ou fila e escolha Gerenciamento de ** ** acesso.

1. A guia de grupos é selecionada por padrão. Selecione o nome do grupo para ver seus membros.

1. Se o usuário não estiver listado no grupo, ele deverá ser adicionado.

   Se você estiver usando a configuração de identidade padrão, poderá adicionar diretamente o usuário ao grupo no console do Identity Center. Se você estiver conectado a um provedor de identidade externo, como Okta ouGoogle Workspace, poderá adicionar seu usuário ao grupo no seu provedor de identidade.
**nota**  
Alguns provedores de identidade externos sincronizam usuários, mas não grupos, com o Identity Center. Nesse caso, considere atribuir permissões diretamente a um usuário em vez de por grupo.

Para obter mais informações sobre como gerenciar o acesso do usuário ao Deadline Cloud, consulte[Gerenciando usuários no Deadline Cloud](managing-users.md).

## Por que os trabalhadores não estão aceitando meus empregos?
<a name="troubleshooting_workers_not_picking_jobs"></a>

### Configuração da função da frota
<a name="troubleshooting_workers_fleet_role_config"></a>

Às vezes, quando os trabalhadores são criados, mas não concluem a inicialização e não começam a trabalhar nas tarefas, é porque a função da frota não foi configurada corretamente.

Para verificar essa causa, verifique seus CloudTrail registros em busca de erros de acesso negado. Depois de confirmar o problema de acesso negado, acesse sua frota e atualize a configuração da função para as permissões corretas. Para obter mais informações, consulte [ CloudTrail os registros ](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/logging-using-cloudtrail.html) no guia do desenvolvedor do Deadline Cloud.

## Por que meu funcionário está preso correndo?
<a name="troubleshooting_worker_stuck_running"></a>

### Trabalhador preso ao sair do ambiente OpenJD
<a name="troubleshooting_worker_fleet_role_config"></a>

Os trabalhadores podem ficar presos em ações de `envExit` sessão de longa duração. Esse problema pode acontecer se você usar um modelo de trabalho que substitua o modelo do OpenJD e defina o tempo limite das ações de saída do ambiente para mais de 5 minutos. O monitor Deadline Cloud fornece alguma visibilidade dos trabalhadores presos nessa situação, mas exige o cruzamento `RUNNING` dos trabalhadores com o trabalho disponível nas filas associadas.

Para encontrar trabalhadores paralisados, analise todas as frotas no monitor Deadline Cloud e conclua as seguintes etapas:

1. Na coluna de status do trabalhador, encontre `RUNNING` trabalhadores.

1. Na seção Detalhes da frota, navegue até cada fila associada.

1. Em cada fila associada, pesquise trabalhos que sejam `RUNNING``READY`, ou`PENDING`. Se todas as filas associadas não tiverem nenhuma tarefa nesses estados, o trabalhador está executando uma saída do ambiente.

Para impedir que um trabalhador fique preso nesse estado, use o seguinte AWS CLI comando:

```
aws deadline update-worker \
    --farm-id $FARM_ID     \
    --fleet-id $FLEET_ID   \
    --worker-id $WORKER_ID \
    --status STOPPED
```

Depois de executar o comando, o agente de trabalho é reiniciado quando o programa é encerrado. Em seguida, os trabalhadores voltam à Internet e executam mais trabalhos a partir das filas associadas. Se a fila contiver mais trabalhos com tempos limite de ação de saída do ambiente superiores a 5 minutos, o trabalhador ficará preso novamente. Se isso acontecer, você precisará repetir esse processo até que não haja mais trabalhadores parados na saída. 

Para evitar esse problema, defina a opção de tempo limite para no máximo 5 minutos ao usar um modelo de trabalho.

## Solução de problemas de trabalhos do Deadline
<a name="jobs-troubleshooting"></a>

Para obter informações sobre problemas comuns com trabalhos no AWS Deadline Cloud, consulte os tópicos a seguir.

### Por que a criação do meu trabalho falhou?
<a name="troubleshooting-create-failed"></a>

#### Validação de cota
<a name="troubleshooting-quota-validation"></a>

Alguns dos possíveis motivos pelos quais um trabalho pode falhar nas verificações de validação incluem o seguinte:
+ O modelo de trabalho não segue a especificação do OpenJD.
+ O trabalho contém muitas etapas. 
+ O trabalho contém muitas tarefas no total.
+ Houve um erro interno de serviço que impede a criação do trabalho.

Para ver as cotas para o número máximo de etapas e tarefas em um trabalho, use o console Cotas de Serviço. Para obter mais informações, consulte [Cotas para Deadline Cloud](deadline-cloud-quotas.md).

#### Erro no parâmetro da tarefa CHUNK [INT]
<a name="troubleshooting-task-chunking-extension"></a>

Se a criação do trabalho falhar com a seguinte mensagem de erro, você precisará adicionar a `TASK_CHUNKING` extensão ao seu modelo de trabalho.

```
The CHUNK[INT] task parameter requires the TASK_CHUNKING extension.
```

Para resolver esse problema, adicione o seguinte ao seu modelo de trabalho:

```
extensions:
  - TASK_CHUNKING
```

Para obter mais informações, consulte [ Adicionar fragmentação de tarefas a um modelo de trabalho ](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/build-job-bundle-chunking-add.html) no Guia do desenvolvedor do *AWS Deadline Cloud. *

### Por que meu trabalho não é compatível?
<a name="troubleshooting-not-compatible"></a>

Os motivos comuns pelos quais os trabalhos não são compatíveis com filas incluem os seguintes: 
+ Nenhuma frota está associada à fila para a qual o trabalho foi enviado. Abra o monitor Deadline Cloud e verifique se a fila tem frotas associadas. Para obter mais informações sobre como visualizar filas, consulte[Veja os detalhes da fila e da frota no Deadline Cloud](view-queue-and-fleet.md).
+ O trabalho tem requisitos de host que não são atendidos por nenhuma das frotas associadas à fila. Para verificar, compare a `hostRequirements` entrada no modelo de trabalho com a configuração das frotas em sua fazenda. Certifique-se de que uma das frotas atenda aos requisitos do anfitrião. Para obter mais informações sobre a compatibilidade da frota, consulte [ Determinar a compatibilidade da frota](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/build-jobs-scheduling.html#jobs-scheduling-compatibility). Para ver a configuração da frota, consulte[Veja os detalhes da fila e da frota no Deadline Cloud](view-queue-and-fleet.md). 

O Deadline Cloud verifica a compatibilidade quando você envia o trabalho. Se você associar uma frota compatível à fila posteriormente, os `NOT_COMPATIBLE` trabalhos existentes não serão reiniciados automaticamente. Para executar esses trabalhos, coloque-os na fila. Para obter mais informações, consulte [Solicitar um trabalho](view-a-job.md#view-jobs-steps-tasks-requeue).

### Por que meu trabalho está pronto?
<a name="troubleshooting-stuck-ready"></a>

Os possíveis motivos para seu emprego parecer estar preso no `READY` estado incluem os seguintes:
+ A contagem máxima de trabalhadores para frotas associadas à fila é definida como zero. Para verificar, consulte[Veja os detalhes da fila e da frota no Deadline Cloud](view-queue-and-fleet.md).
+ Há um trabalho de maior prioridade na fila. Para verificar, consulte[Veja os detalhes da fila e da frota no Deadline Cloud](view-queue-and-fleet.md).
+ Para frotas gerenciadas pelo cliente, verifique a configuração de escalabilidade automática. Para obter mais informações, consulte [ Criar infraestrutura de frota com um grupo do Amazon EC2 Auto Scaling ](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/create-auto-scaling.html) no * Deadline Cloud Developer Guide. *

### Por que meu trabalho falhou?
<a name="troubleshooting-job-failed"></a>

Um trabalho pode falhar por vários motivos. Para pesquisar o problema, abra o monitor Deadline Cloud e escolha o trabalho que falhou. Escolha uma tarefa que falhou e, em seguida, visualize os registros da tarefa. Para instruções, consulte [Visualize os registros da sessão e do trabalhador no Deadline Cloud](view-logs.md).
+ Se você ver erros de licença ou receber uma marca d'água que ocorre porque o software não tem uma licença válida, certifique-se de que o funcionário possa se conectar ao servidor de licenças necessário. Para obter mais informações, consulte [ Conectar frotas gerenciadas pelo cliente a um endpoint de licença ](https://docs.aws.amazon.com/deadline-cloud/latest/developerguide/cmf-ubl.html) no Guia do desenvolvedor do * Deadline Cloud. *
+ A mensagem de ação da última sessão ou o código de saída do processo podem fornecer informações sobre por que seu trabalho falhou. Se você estiver usando Windows e seu código de saída for negativo, tente pesquisar a versão não assinada do seu código de saída:

  ```
  2,147,483,647 - |{{your exit code}}|
  ```

### Por que minha etapa está pendente?
<a name="troubleshooting-pending-failed"></a>

As etapas podem permanecer no `PENDING` estado quando uma ou mais de suas dependências não estiverem concluídas. Você pode verificar o estado das dependências usando o monitor Deadline Cloud. Para instruções, consulte [Veja uma etapa no Deadline Cloud](view-a-step.md).

## Registros de aplicativos de desktop do Deadline Cloud
<a name="troubleshooting-desktop-logs"></a>

O aplicativo de desktop Deadline Cloud monitor grava registros de diagnóstico que você pode usar para investigar falhas ou outros comportamentos inesperados. Ao relatar um problema com o aplicativo de desktop, inclua os arquivos de log relevantes para ajudar no diagnóstico.

A localização dos arquivos de log depende do seu sistema operacional:

Windows  

```
%APPDATA%\com.amazonaws.deadline.monitor\logs
```

macOS  

```
~/Library/Logs/com.amazonaws.deadline.monitor/
```

Linux  

```
~/.config/com.amazonaws.deadline.monitor/logs
```

## Recursos adicionais do
<a name="troubleshooting_additional_resources"></a>

Você pode encontrar informações e recursos adicionais em [ GitHub](https://github.com/aws-deadline).