Instalando o Docker para usar com o AWS SAM CLI - 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 SAM CLI

Docker é um aplicativo que executa contêineres em sua máquina. Com Docker, AWS SAM pode fornecer um ambiente local semelhante a AWS Lambda um contêiner para criar, testar e depurar seus aplicativos sem servidor.

nota

Docker é necessário somente para testar seus aplicativos localmente e para criar pacotes de implantação usando a --use-container opção.

Instalar Docker

Siga estas instruções para instalar Docker no seu sistema operacional.

O Docker está disponível em muitos sistemas operacionais diferentes, incluindo a maioria das distribuições Linux modernas, como CentOS, Debian e Ubuntu. Para obter informações sobre a instalação Docker em seu sistema operacional específico, consulte Get Docker no site do Docker Docs.

Para instalar 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 mais recente Docker Pacote Community Edition.

    • 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 Docker serviço.

    $ sudo service docker start
  4. Adicione o ec2-user ao docker grupo para que você possa executar Docker comandos sem usarsudo.

    $ 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 atual SSH do terminal e reconecte-se à sua instância em uma nova. Sua nova SSH sessão deve ter as permissões de docker grupo 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 Lambda com uma arquitetura de conjunto de instruções diferente da sua máquina host, há etapas adicionais para configurar Docker. Por exemplo, para executar arm64 funções em uma x86_64 máquina, você pode executar o comando a seguir para configurar o Docker daemon:. docker run --rm --privileged multiarch/qemu-user-static --reset -p yes

Se você tiver problemas na instalação Docker, consulte Solução de problemas de erros de instalação do . 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 começando com AWS SAM CLI versão 1.47.0, você pode usar alternativas, desde que usem o Docker tempo de execução.

  1. Instalar Docker

    O AWS SAM CLI aguenta Docker rodando no macOS Sierra 10.12 ou posterior. Para saber como instalar Docker, consulte Instalar Docker Desktop para Mac no Docker Site do Docs.

  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 volume requer compartilhamento de arquivos em Docker documentos.

  3. Verificar a instalação

    Depois Docker está instalado, verifique se está funcionando. Confirme também se você pode executar Docker comandos da 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 Docker, para obter mais dicas de solução de problemas, consulte a seção Solução de problemas e diagnóstico do Docker Site do Docs.

nota

AWS SAM suporta oficialmente Docker Desktop. No entanto, começando com AWS SAM CLI versão 1.47.0, você pode usar alternativas, desde que usem o Docker tempo de execução.

  1. Instalar Docker.

    Docker O desktop é compatível com o sistema operacional Windows mais recente. Para versões antigas do Windows, o Docker A caixa de ferramentas está disponível. Escolha sua versão do Windows para a correta Docker etapas de instalação:

  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 Docker para funcionar corretamente.

  3. Verifique a instalação.

    Depois Docker está instalado, verifique se está funcionando. Confirme também se você pode executar Docker comandos da 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 Docker, para obter mais dicas de solução de problemas, consulte a seção Solução de problemas e diagnóstico do Docker Site do Docs.

Próximas etapas

Para saber como instalar o AWS SAM CLI, consulte Instale o AWS SAM CLI.