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á.
# Instalando o Docker para usar com o AWS SAMCLI
O Docker é um aplicativo que executa contêineres em sua máquina. ComDocker, AWS SAM pode fornecer um ambiente local semelhante a AWS Lambda um contêiner para criar, testar e depurar seus aplicativos sem servidor.
**nota**
O Docker é necessário somente para testar seus aplicativos localmente e para criar pacotes de implantação usando a opção `--use-container`.
**Topics**
+ [Instalação do Docker](#install-docker-instructions)
+ [Próximas etapas](#install-docker-next-steps)
## Instalação do Docker
Siga essas instruções para instalar a Docker, siga as instruções para seu sistema operacional.
### Linux
O Docker está disponível em muitos sistemas operacionais diferentes, incluindo a maioria das distribuições modernas do Linux, como o CentOS, o Debian, e o Ubuntu. Para obter informações sobre a instalação Docker em seu sistema operacional específico, consulte [Obtenha o Docker](https://docs.docker.com/get-docker/) no site Docker Docs.
**Para instalar o Docker no Amazon Linux 2 ou Amazon Linux 2023**
1. Atualize os pacotes instalados e o cache de pacotes em sua instância.
```
$ sudo yum update -y
```
1. Instale o pacote do Docker Community Edition mais recente.
+ No Amazon Linux 2, execute o seguinte:
```
$ sudo amazon-linux-extras install docker
```
+ No Amazon Linux 2023, execute o seguinte:
```
$ sudo yum install -y docker
```
1. Inicie o serviço Docker.
```
$ sudo service docker start
```
1. Adicione o `ec2-user` ao grupo `docker`, para que você possa executar comandos Docker sem usar o **sudo**.
```
$ sudo usermod -a -G docker ec2-user
```
1. Obtenha as novas permissões de grupo `docker` efetuando logout e login novamente. Para fazer isso, feche a janela do terminal SSH atual e reconecte-se à sua instância em uma nova. Sua nova sessão SSH deverá ter as permissões de grupo `docker` apropriadas.
1. Verifique se o `ec2-user` pode executar comandos do Docker sem usar o **sudo**.
```
$ docker ps
```
Você deverá ver a saída a seguir, confirmando que o Docker está instalado e em execução:
```
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
```
**nota**
No Linux, para criar e executar funções do Lambda com uma arquitetura de conjunto de instruções diferente da sua máquina host, há etapas adicionais para configurar o Docker. Por exemplo, para executar funções `arm64` em uma máquina `x86_64`, você pode executar o seguinte comando para configurar o Docker daemon: `docker run --rm --privileged multiarch/qemu-user-static --reset -p yes`.
Se você tiver problemas ao instalar o Docker, consulte [Solução de problemas de erros de instalação do](install-sam-cli.md#sam-cli-troubleshoot-install). Ou consulte a seção [Solução](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting) de problemas das **etapas de pós-instalação para Linux** no site do Docker Docs.
### macOS
**nota**
Docker O desktop é oficialmente suportado, mas a partir da versão 1.47.0 do AWS SAMCLI, você pode usar alternativas, desde que elas usem o tempo de execução do Docker.
1. Instalar o Docker
O AWS SAMCLI tem suporte para a execução do Docker no macOS Sierra 10.12 ou posterior. Para saber como instalar o Docker, consulte [Instalar o Docker Desktop para Mac](https://docs.docker.com/docker-for-mac/install/) no site do Docs Docker.
1. Como configurar seus drives compartilhados
Isso AWS SAMCLI exige que o diretório do projeto, ou qualquer diretório principal, esteja listado em um drive compartilhado. Isso pode exigir o compartilhamento de arquivos. Para obter mais informações, consulte o tópico de solução de problemas [de montagem de volumes requer compartilhamento de arquivos](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home) na documentação*Docker.*
1. Verificar a instalação
Depois que o Docker estiver instalado, verifique se está funcionando. Confirme também se você pode executar comandos Docker na linha de comando (por exemplo, `docker ps`). Você não precisa instalar, buscar ou retirar nenhum contêiner. O AWS SAMCLI faz isso automaticamente conforme necessário.
Se você tiver problemas na instalação do Docker, para obter mais dicas de solução de problemas, consulte a seção [Solução de problemas e diagnóstico](https://docs.docker.com/docker-for-mac/troubleshoot/) do site do Docs Docker.
### Windows
**nota**
AWS SAM suporta oficialmente o Docker Desktop. No entanto, a partir da versão 1.47.0 do AWS SAMCLI, você pode usar alternativas, desde que elas usem o tempo de execução do Docker.
1. Instalar o Docker.
O Docker desktop é compatível com o sistema operacional Windows mais recente. Para versões antigas do Windows, a caixa de ferramentas Docker está disponível. Escolha sua versão do Windows para as etapas corretas de instalação do Docker:
+ Para instalar o Docker no Windows 10, consulte [Instalar o Docker Desktop para Windows](https://docs.docker.com/docker-for-windows/install/) no site do Docker Documentos.
+ DockerPara instalar em versões anteriores do Windows, consulte [A caixa de Docker ferramentas no repositório da Docker caixa](https://github.com/docker-archive/toolbox) de ferramentas GitHub .
1. Como configurar seus drives compartilhados.
Isso AWS SAMCLI exige que o diretório do projeto, ou qualquer diretório principal, esteja listado em um drive compartilhado. Em alguns casos, você deve compartilhar sua unidade para o Docker funcionar corretamente.
1. Verifique a instalação.
Depois que o Docker estiver instalado, verifique se está funcionando. Confirme também se você pode executar comandos Docker na linha de comando (por exemplo, **docker ps**). Você não precisa instalar, buscar ou retirar nenhum contêiner. O AWS SAMCLI faz isso automaticamente conforme necessário.
Se você tiver problemas na instalação do Docker, para obter mais dicas de solução de problemas, consulte a seção [Solução de problemas e diagnóstico](https://docs.docker.com/docker-for-mac/troubleshoot/) do site do Docs Docker.
## Próximas etapas
Para saber como instalar o AWS SAMCLI, consulte[Instale o AWS SAM CLI](install-sam-cli.md).