Instalación de Docker para usarlo con la CLI de AWS SAM - AWS Serverless Application Model
Instalación de DockerPasos a seguir a continuación

Instalación de Docker para usarlo con la CLI de AWS SAM

Docker es una aplicación que ejecuta contenedores en su máquina. Con Docker, AWS SAM puede proporcionar un entorno local similar a AWS Lambda como contenedor para crear, probar y depurar sus aplicaciones sin servidor.

nota

Docker solo es necesario para probar las aplicaciones de forma local y para crear paquetes de implementación mediante la opción --use-container.

Instalación de Docker

Siga estas instrucciones para instalar Docker en su sistema operativo.

Docker está disponible en muchos sistemas operativos diferentes, incluidas las distribuciones de Linux más modernas, como CentOS, Debian o Ubuntu. Para obtener más información sobre cómo instalar Docker en su sistema operativo concreto, consulte Conseguir Docker en el sitio web de Docker Docs.

Para instalar Docker en Amazon Linux 2 o Amazon Linux 2023

  1. Actualice la caché de paquetes y los paquetes instalados en la instancia.

    $ sudo yum update -y

  2. Instale el paquete de Community Edition de Docker más reciente.

    • Para Amazon Linux 2, ejecute lo siguiente:

      $ sudo amazon-linux-extras install docker

    • Para Amazon Linux 2023, ejecute lo siguiente:

      $ sudo yum install -y docker

  3. Inicie el servicio Docker.

    $ sudo service docker start

  4. Agregue el ec2-user al grupo docker para que pueda ejecutar comandos de Docker sin usar sudo.

    $ sudo usermod -a -G docker ec2-user

  5. Cierre sesión y vuelva a iniciarla para actualizar los nuevos permisos de grupo de docker. Para ello, cierre la ventana de su terminal de SSH actual y vuelva a conectarse a su instancia en una ventana nueva. De esta forma, la nueva sesión de SSH debería tener los permisos de grupo de docker adecuados.

  6. Compruebe que el ec2-user puede ejecutar comandos de Docker sin sudo.

    $ docker ps

    Debería ver el siguiente resultado, lo que confirma que Docker está instalado y en ejecución:

     CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
nota

En Linux, para crear y ejecutar funciones de Lambda con una arquitectura de conjunto de instrucciones diferente a la de la máquina host, hay pasos adicionales para configurar Docker. Por ejemplo, para ejecutar funciones arm64 en una unidad x86_64, puede ejecutar el siguiente comando para configurar el daemon de Docker: docker run --rm --privileged multiarch/qemu-user-static --reset -p yes.

Si tiene problemas para instalar Docker, consulte Solución de errores de la instalación. O bien, consulte la sección de Resolución de problemas de los Pasos posteriores a la instalación en Linux en el sitio web de Docker Docs.

nota

Docker Desktop cuenta con soporte oficial, pero a partir de la versión 1.47.0 de la CLI de AWS SAM, puede usar alternativas siempre que usen el tiempo de ejecución de Docker.

  1. Instalar Docker

    La CLI de AWS SAM es compatible con Docker para macOS Sierra 10.12 o posterior. Para saber cómo instalar Docker, consulte Instalar Docker Desktop para Mac en el sitio web de Docker Docs.

  2. Configuración de las unidades compartidas

    La CLI de AWS SAM requiere que el directorio del proyecto, o cualquier directorio principal, aparezca en una unidad compartida. Para ello puede ser necesario el uso compartido de archivos. Para obtener más información, consulte el tema de solución de problemas El montaje de volúmenes requiere el uso compartido de archivos en Docker Docs.

  3. Verificar la instalación

    Una vez Docker esté instalado, compruebe que funciona. Confirme también que puede ejecutar comandos de Docker desde la línea de comandos (por ejemplo, docker ps). No necesita instalar, recuperar ni extraer ningún contenedor; la CLI de AWS SAM lo hace automáticamente según sea necesario.

Si tiene problemas con la instalación de Docker, consulte la sección Solución de problemas y diagnóstico del sitio web de Docker Docs para más consejos sobre resolución de problemas.

nota

Docker Desktop cuenta con el soporte oficial de AWS SAM. Sin embargo, a partir de la versión 1.47.0 de la CLI de AWS SAM, puede usar alternativas siempre que usen el tiempo de ejecución de Docker.

  1. Instalar Docker.

    Docker Desktop es compatible con el sistema operativo Windows más reciente. Para las versiones antiguas de Windows, está disponible Docker Toolbox. Elija su versión de Windows para instalar Docker paso a paso de manera correcta:

  2. Configuración de las unidades compartidas

    La CLI de AWS SAM requiere que el directorio del proyecto, o cualquier directorio principal, aparezca en una unidad compartida. En algunos casos, debe compartir la unidad para que Docker funcione correctamente.

  3. Verifica la instalación.

    Una vez Docker esté instalado, compruebe que funciona. Confirme también que puede ejecutar comandos de Docker desde la línea de comandos (por ejemplo, docker ps). No necesita instalar, recuperar ni extraer ningún contenedor; la CLI de AWS SAM lo hace automáticamente según sea necesario.

Si tiene problemas con la instalación de Docker, consulte la sección Solución de problemas y diagnóstico del sitio web de Docker Docs para más consejos sobre resolución de problemas.

Pasos a seguir a continuación

Para saber cómo instalar la CLI de AWS SAM, consulte Instala la AWS SAM CLI.