Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Instalación de Docker para usarlo con la CLI de AWS SAM
Docker es una aplicación que ejecuta contenedores en su máquina. ConDocker, AWS SAM puede proporcionar un entorno local similar a AWS Lambda un 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`.
**Topics**
+ [Instalación de Docker](#install-docker-instructions)
+ [Siguientes pasos](#install-docker-next-steps)
## Instalación de Docker
Siga estas instrucciones para instalar Docker en su sistema operativo.
### Linux
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](https://docs.docker.com/get-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
```
1. 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
```
1. Inicie el servicio Docker.
```
$ sudo service docker start
```
1. Agregue el `ec2-user` al grupo `docker` para que pueda ejecutar comandos de Docker sin usar **sudo**.
```
$ sudo usermod -a -G docker ec2-user
```
1. 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.
1. 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](install-sam-cli.md#sam-cli-troubleshoot-install). O bien, consulte la sección de [Resolución de problemas](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting) de los **Pasos posteriores a la instalación en Linux** en el sitio web de Docker Docs.
### macOS
**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](https://docs.docker.com/docker-for-mac/install/) en el sitio web de Docker Docs.
1. Configuración de las unidades compartidas
AWS SAMCLIRequiere que el directorio del proyecto, o cualquier directorio principal, esté incluido 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](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home) en *Docker Docs*.
1. 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](https://docs.docker.com/docker-for-mac/troubleshoot/) del sitio web de Docker Docs para más consejos sobre resolución de problemas.
### Windows
**nota**
AWS SAM oficialmente es compatible con Docker Desktop. 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. Instale 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:
+ Para instalar Docker para Windows 10, consulte [Instalar Docker Desktop para Windows](https://docs.docker.com/docker-for-windows/install/) en el sitio web de Docker Docs.
+ Para realizar la instalación Docker para versiones anteriores de Windows, consulte [The Docker Toolbox](https://github.com/docker-archive/toolbox) en el repositorio de Docker Toolbox. GitHub
1. Configuración de las unidades compartidas
AWS SAMCLIRequiere que el directorio del proyecto, o cualquier directorio principal, esté incluido en una unidad compartida. En algunos casos, debe compartir la unidad para que Docker funcione correctamente.
1. 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](https://docs.docker.com/docker-for-mac/troubleshoot/) del sitio web de Docker Docs para más consejos sobre resolución de problemas.
## Siguientes pasos
Para saber cómo instalar el AWS SAMCLI, consulte[Instala la AWS SAM CLI](install-sam-cli.md).