Instalando o Docker para usar com o AWS SAMCLI - AWS Serverless Application Model

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. Com o Docker, o AWS SAM pode fornecer um ambiente local semelhante a AWS Lambda como um contêiner para criar, testar e depurar seus aplicativos com tecnologia 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.

Instalação do Docker

Siga essas instruções para instalar a Docker, siga as instruções para seu sistema operacional.

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 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
  2. 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
  3. Inicie o serviço Docker.

    $ sudo service docker start
  4. 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
  5. 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.

  6. 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 Erros de instalação. Ou consulte a seção Solução de problemas das etapas de pós-instalação para Linux no site do Docker Docs.

nota

Docker O desktop é oficialmente suportado, mas a partir da versão 1.47.0 do AWS SAM CLI, você pode usar alternativas, desde que elas usem o tempo de execução do Docker.

  1. Instalar o Docker

    O AWS SAM CLI 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 no site do Docs Docker.

  2. Como configurar seus drives compartilhados

    O AWS SAM CLI 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 na documentaçãoDocker.

  3. 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 SAM CLI 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 do site do Docs Docker.

nota

O AWS SAM suporta oficialmente o Docker Desktop. No entanto, a partir da versão 1.47.0 do AWS SAM CLI, 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:

  2. Como configurar seus drives compartilhados.

    O AWS SAM CLI 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.

  3. 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 SAM CLI 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 do site do Docs Docker.

Próximas etapas

Para saber como instalar o AWS SAMCLI, consulteInstalando o AWS SAM CLI.