# Solução de problemas causados por erros ResourceInitializationError do Amazon ECS
<a name="resource-initialization-error"></a>

A seguir estão algumas mensagens do erro `ResourceInitialization` e ações que podem ser executadas para corrigi-lo.

Para verificar se há uma mensagem de erro nas tarefas interrompidas usando o Console de gerenciamento da AWS, consulte [Visualizar erros de tarefa interrompida do Amazon ECS](stopped-task-errors.md).

**Topics**
+ [A tarefa não pode extrair a autenticação do registro do Amazon ECR. Há um problema de conexão entre a tarefa e o Amazon ECR. Verifique a configuração de rede da tarefa.](#unable-to-pull-secrets-ecr)
+ [A tarefa não consegue baixar os arquivos de variáveis de ambiente do Amazon S3. Há um problema de conexão entre a tarefa e o Amazon S3. Verifique a configuração de rede da tarefa.](#failed-to-download-env-files)
+ [A tarefa consegue extrair segredos do AWS Systems Manager Parameter Store. Verifique a conexão de rede entre a tarefa e o AWS Systems Manager.](#unable-to-pull-secrets-sys-manager)
+ [A tarefa não consegue extrair segredos do AWS Secrets Manager. Há um problema de conexão entre a tarefa e o Secrets Manager. Verifique a configuração de rede da tarefa.](#unable-to-pull-secrets-asm-no-arn)
+ [A tarefa não consegue extrair o segredo do Secrets Manager. A tarefa não consegue recuperar o segredo com ARN "*secretARN'*" do Secrets Manager. Verifique se o segredo existe na região especificada.](#unable-to-pull-secrets-asm)
+ [Falha do comando pull: não é possível extrair segredos ou autenticação do registro. Verifique a configuração de rede da sua tarefa.](#pull-command-failed)
+ [A tarefa não consegue encontrar o grupo de logs do Amazon CloudWatch definido na tarefa. Há um problema de conexão entre a tarefa e o Amazon CloudWatch. Verifique a configuração da rede.](#failed-to-initialize-logging-network)
+ [falha ao inicializar o driver de registro em log](#failed-to-initialize-logging)
+ [falha ao invocar comandos do EFS utils para configurar volumes do EFS](#efs-utils-failed)

## A tarefa não pode extrair a autenticação do registro do Amazon ECR. Há um problema de conexão entre a tarefa e o Amazon ECR. Verifique a configuração de rede da tarefa.
<a name="unable-to-pull-secrets-ecr"></a>

Esse erro indica que a tarefa não consegue se conectar ao Amazon ECR.

Verifique a conexão entre a tarefa e o Amazon ECR. Para mais informações, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).

## A tarefa não consegue baixar os arquivos de variáveis de ambiente do Amazon S3. Há um problema de conexão entre a tarefa e o Amazon S3. Verifique a configuração de rede da tarefa.
<a name="failed-to-download-env-files"></a>

Esse erro ocorre quando a tarefa não consegue baixar o arquivo de ambiente do Amazon S3. 

Verifique a conexão entre a tarefa e o endpoint da VPC do Amazon S3. Para mais informações, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).

## A tarefa consegue extrair segredos do AWS Systems Manager Parameter Store. Verifique a conexão de rede entre a tarefa e o AWS Systems Manager.
<a name="unable-to-pull-secrets-sys-manager"></a>

Esse erro ocorre quando a tarefa não consegue extrair a imagem definida na definição de tarefa usando as credenciais do Systems Manager.

Verifique a conexão entre a tarefa e o endpoint da VPC do Systems Manager. Para mais informações, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).

## A tarefa não consegue extrair segredos do AWS Secrets Manager. Há um problema de conexão entre a tarefa e o Secrets Manager. Verifique a configuração de rede da tarefa.
<a name="unable-to-pull-secrets-asm-no-arn"></a>

Esse erro ocorre quando a tarefa não consegue extrair a imagem definida na definição de tarefa usando as credenciais do Secrets Manager. 

O erro indica que existe um problema de conectividade de rede entre o endpoint da VPC do Systems Manager e a tarefa.

Para obter informações sobre como verificar a conectividade entre a tarefa e o endpoint, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).

## A tarefa não consegue extrair o segredo do Secrets Manager. A tarefa não consegue recuperar o segredo com ARN "*secretARN'*" do Secrets Manager. Verifique se o segredo existe na região especificada.
<a name="unable-to-pull-secrets-asm"></a>

Esse erro ocorre quando a tarefa não consegue extrair a imagem definida na definição de tarefa usando as credenciais do Secrets Manager. 

Esse problema é causado por um ou mais dos seguintes motivos:


| Causa do erro | Fazer isso... | 
| --- | --- | 
|   Problema de conectividade de rede entre o endpoint da VPC do Secrets Manager e a tarefa. Existe um problema de rede quando você vê uma das seguintes strings na mensagem de erro: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/resource-initialization-error.html)  |  Verifique a conectividade entre a tarefa e o endpoint do Secrets Manager. Para obter mais informações, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).  | 
| O perfil de execução de tarefa definido na definição de tarefa não tem as permissões para o Secrets Manager. |  Adicione as permissões necessárias do Secrets Manager ao perfil de execução de tarefa. Para obter mais informações, consulte [Permissões do Secrets Manager ou do Systems Manager](task_execution_IAM_role.md#task-execution-secrets).  | 
| O ARN do segredo não existe | Verifique se o ARN existe no Secrets Manager. Para obter informações sobre visualização de imagens, consulte [Find secrets in Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_search-secret.html) no Secrets Manager Developer Guide. | 

## Falha do comando pull: não é possível extrair segredos ou autenticação do registro. Verifique a configuração de rede da sua tarefa.
<a name="pull-command-failed"></a>

Esse erro ocorre quando a tarefa não consegue se conectar ao Amazon ECR, Systems Manager ou Secrets Manager. Isso ocorre quando há uma configuração incorreta na rede.

Para corrigir o problema, verifique a conectividade entre a tarefa e o Amazon ECR. Também é necessário verificar a conectividade entre sua tarefa e o serviço que armazena seu segredo (Systems Manager ou Secrets Manager). Para obter mais informações, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).

## A tarefa não consegue encontrar o grupo de logs do Amazon CloudWatch definido na tarefa. Há um problema de conexão entre a tarefa e o Amazon CloudWatch. Verifique a configuração da rede.
<a name="failed-to-initialize-logging-network"></a>

Esse erro ocorre quando a tarefa não consegue encontrar o grupo de logs do CloudWatch especificado na definição da tarefa.

O erro indica que existe um problema de conectividade de rede entre o endpoint da VPC do CloudWatch e a tarefa.

Para obter informações sobre como verificar a conectividade entre a tarefa e o endpoint, consulte [Verificar conectividade de tarefa interrompida do Amazon ECS](verify-connectivity.md).

## falha ao inicializar o driver de registro em log
<a name="failed-to-initialize-logging"></a>

Esse erro ocorre quando a tarefa não consegue encontrar o grupo de logs do CloudWatch especificado na definição da tarefa.

O erro indica que o grupo do CloudWatch da definição de tarefa não existe.

Use as etapas a seguir para encontrar o CloudWatch ausente.

1. Execute o comando a seguir para obter as informações de definição da tarefa.

   ```
   aws ecs describe-task-definition \ 
       --task-definition task-def-name
   ```

   Observe a saída de cada contêiner e anote o valor `awslogs-group`.

   ```
   "logConfiguration": {
                   "logDriver": "awslogs",
                   "options": {
                       "awslogs-group": "/ecs/example-group",
                       "awslogs-create-group": "true",
                       "awslogs-region": "us-east-1",
                       "awslogs-stream-prefix": "ecs"
                   },
   ```

1. Verifique se o grupo existe no CloudWatch. Para obter mais informações, consulte [Como trabalhar com grupos de logs e fluxos de logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) no *Guia do usuário do Amazon CloudWatch Logs*.

   O problema é que o grupo especificado na definição da tarefa está incorreto ou o grupo de logs não existe.

1. Corrija o problema.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonECS/latest/developerguide/resource-initialization-error.html)

## falha ao invocar comandos do EFS utils para configurar volumes do EFS
<a name="efs-utils-failed"></a>

Os seguintes problemas podem impedir que você monte os volumes do Amazon EFS nas tarefas:
+ O sistema de arquivos do Amazon EFS não está configurado corretamente.
+ A tarefa não tem as permissões necessárias.
+ Há problemas relacionados às configurações de rede e VPC.

 Para obter informações sobre como depurar e corrigir esse problema, consulte [Por que não consigo montar meus volumes do Amazon EFS em minhas tarefas do AWS Fargate?](https://repost.aws/knowledge-center/fargate-unable-to-mount-efs) no AWS re:Post.