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 e comandos do Docker usando o Amazon ECR
Em alguns casos, a execução de um comando do Docker no Amazon ECR pode resultar em uma mensagem de erro. Algumas mensagens de erro comuns e possíveis soluções são explicadas abaixo.
**Topics**
+ [Os logs do Docker não contêm mensagens de erro esperadas](#debug)
+ [Erro: "Filesystem Verification Failed (Falha na verificação do sistema de arquivos)" ou "404: Image Not Found (Imagem não encontrada)" ao extrair uma imagem de um repositório do Amazon ECR](#error-filesystem-verification-failed)
+ [Erro: "Filesystem Layer Verification Failed (Falha na verificação da camada do sistema de arquivos)" ao extrair imagens do Amazon ECR](#error-filesystem-layer-verification)
+ [Erros 403 de HTTP ou o erro "no basic auth credentials (não há credenciais de autenticação básica)" ao enviar ao repositório](#error-403)
## Os logs do Docker não contêm mensagens de erro esperadas
Para começar a depurar qualquer problema relacionado ao Docker, você deve começar ativando a saída de depuração do Docker no daemon do Docker em execução nas instâncias do host. Caso esteja usando imagens extraídas do Amazon ECR nas instâncias de contêiner do Amazon ECS, consulte [Configuração da saída detalhada do daemon do Docker](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/docker-debug-mode.html) no *Guia do desenvolvedor do Amazon Elastic Container Service*.
## Erro: "Filesystem Verification Failed (Falha na verificação do sistema de arquivos)" ou "404: Image Not Found (Imagem não encontrada)" ao extrair uma imagem de um repositório do Amazon ECR
Você pode receber o erro `Filesystem verification failed` ao usar o comando **docker pull** para extrair uma imagem de um repositório do Amazon ECR com o Docker 1.9 ou versões posteriores. Ou o erro `404: Image not found` ao utilizar versões do Docker anteriores à 1.9.
Alguns motivos possíveis e suas explicações são mostrados abaixo.
O disco local está cheio
Se o disco local em que você está executando **docker pull** estiver cheio, o hash SHA-1 calculado no arquivo local pode ser diferente do calculado pelo Amazon ECR. Verifique se o disco local tem espaço livre suficiente para armazenar a imagem de Docker que você está extraindo. Você também pode excluir imagens antigas para dar espaço às novas. Use o comando **docker images** para ver uma lista com todas as imagens de Docker obtidas por download localmente, bem como os tamanhos delas.
O cliente não consegue se conectar ao repositório remoto devido a um erro de rede
As chamadas feitas para um repositório do Amazon ECR exigem uma conexão com a Internet. Verifique suas configurações de rede e se outros aplicativos e ferramentas podem acessar recursos na Internet. Se estiver executando **docker pull** em uma instância do Amazon EC2 em uma sub-rede privada, verifique se a sub-rede tem uma rota para a Internet. Use um servidor de tradução de endereço de rede (NAT) ou um gateway NAT gerenciado.
Atualmente, as chamadas feitas para um repositório do Amazon ECR também exigem acesso de rede por firewall corporativo para o Amazon Simple Storage Service (Amazon S3). Se sua organização usa software de firewall ou um dispositivo NAT que permite endpoints de serviço, verifique se os endpoints de serviço do Amazon S3 para a sua região atual são permitidos.
Se você usa o Docker atrás de um proxy HTTP, pode configurá-lo com as configurações de proxy apropriadas. Para obter mais informações, consulte [proxy HTTP](https://docs.docker.com/engine/admin/systemd/#/http-proxy) na documentação do Docker.
## Erro: "Filesystem Layer Verification Failed (Falha na verificação da camada do sistema de arquivos)" ao extrair imagens do Amazon ECR
Você pode receber o erro `image image-name not found` ao extrair imagens com o comando **docker pull**. Se você inspecionar os logs do Docker, poderá ver um erro como este:
```
filesystem layer verification failed for digest sha256:2b96f...
```
Esse erro indica que uma ou mais das camadas da sua imagem não foram baixadas. Alguns motivos possíveis e suas explicações são mostrados abaixo.
Você está usando uma versão antiga do Docker
Esse erro pode ocorrer em alguns casos, quando uma versão do Docker anterior à 1.10 é usada. Atualize o cliente do Docker para a versão 1.10 ou posterior.
O cliente encontrou um erro de rede ou de disco
Um disco cheio ou um problema de rede pode impedir que uma ou mais camadas sejam baixadas, como já falamos sobre a mensagem `Filesystem verification failed`. Siga as recomendações acima para que seu sistema de arquivos não fique cheio e para verificar se você habilitou o acesso ao Amazon S3 de dentro da sua rede.
## Erros 403 de HTTP ou o erro "no basic auth credentials (não há credenciais de autenticação básica)" ao enviar ao repositório
Algumas vezes, você poderá receber um erro `HTTP 403 (Forbidden)` ou a mensagem de erro `no basic auth credentials` dos comandos **docker push** ou **docker pull**, mesmo que tenha feito a autenticação no Docker com o comando **aws ecr get-login-password**. Veja a seguir algumas causas conhecidas desse problema:
Você fez a autenticação em outra região
As solicitações de autenticação são vinculadas a regiões específicas e não podem ser usadas entre regiões. Por exemplo, se você obtiver um token de autorização de Oeste dos EUA (Oregon), não poderá usá-lo para autenticação nos seus repositórios em Leste dos EUA (Norte da Virgínia). Para resolver o problema, verifique se você recuperou um token de autenticação da mesma região na qual o repositório existe. Para obter mais informações, consulte [Autenticação de registro privado no Amazon ECR](registry_auth.md).
Você realizou uma autenticação para enviar por push para um repositório ao qual não tem permissões
Você não tem as permissões necessárias para realizar o envio por push para o repositório. Para obter mais informações, consulte [Políticas de repositório privado no Amazon ECR](repository-policies.md).
Seu token expirou
O período de expiração padrão para tokens de autorização obtidos usando a operação `GetAuthorizationToken` é de 12 horas.
Erro no gerenciador de credenciais`wincred`
Algumas versões do Docker para Windows usam um gerenciador de credenciais chamado`wincred`, que não manipula adequadamente o comando de login do Docker produzido por **aws ecr get-login-password** (para obter mais informações, consulte [`CredsStore`falha com repositórios privados](https://github.com/moby/moby/issues/22910)). Você pode executar o comando de login do Docker gerado. No entanto, quando você tenta enviar ou extrair imagens, esses comandos falham. Para resolver esse erro, remova o esquema `https://` do argumento de registro no comando de login do Docker gerado a partir de **aws ecr get-login-password**. Um exemplo de comando de login do Docker sem o esquema HTTPS é mostrado abaixo.
```
docker login -u AWS -p .dkr.ecr..amazonaws.com
```