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. # Instala la AWS SAM CLI Instale la versión más reciente de la interfaz de línea de AWS Serverless Application Model comandos (AWS SAMCLI) en los sistemas operativos compatibles siguiendo las instrucciones de[Paso 4: Instale el AWS CLI](prerequisites.md#prerequisites-install-cli). Para obtener información sobre la administración de una versión instalada actualmente de AWS SAMCLI, incluido cómo actualizar, desinstalar o administrar las compilaciones nocturnas, consulte[Administración de versiones de AWS SAM CLI](manage-sam-cli-versions.md). **¿Es la primera vez que instala AWS SAM CLI?** Completa todos los [requisitos previos](prerequisites.md) de la sección anterior antes de continuar. Esto incluye: Registrarse para obtener una AWS cuenta. Configurar el acceso seguro a AWS. Creación de un identificador de claves de acceso y de una claves de acceso secreta. Instalación del AWS CLI. Configuración de AWS credenciales. **Topics** + [Instalación de la AWS SAM CLI](#install-sam-cli-instructions) + [Solución de errores de la instalación](#sam-cli-troubleshoot-install) + [Siguientes pasos](#install-sam-cli-next-steps) + [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md) ## Instalación de la AWS SAM CLI **nota** A partir de septiembre de 2023, AWS dejará de mantener el Homebrew instalador AWS gestionado de AWS SAMCLI (`aws/tap/aws-sam-cli`). Si lo utiliza Homebrew para instalar y administrar AWS SAMCLI, consulte las siguientes opciones: Para seguir utilizando Homebrew, puedes utilizar el instalador gestionado por la comunidad. Para obtener más información, consulta [Administración de CLI de AWS SAM con la Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew). Se recomienda utilizar uno de los métodos de instalación propios que se documentan en esta página. Antes de utilizar uno de estos métodos, consulta [Cambiar de Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-switch). Para obtener más información, consulte [Release version: 1.121.0](https://github.com/aws/aws-sam-cli/releases). Para instalarlo AWS SAMCLI, siga las instrucciones de su sistema operativo. ### Linux ------ #### [ x86\$164 - command line installer ] 1. Descarga el [archivo .zip de AWS SAM CLI](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip) a un directorio de tu elección. 1. **(Opcional)** Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Descomprime los archivos de instalación en el directorio que prefieras. A continuación, se muestra un ejemplo de uso del subdirectorio `sam-installation`. **nota** Si el sistema operativo no tiene el comando **unzip** integrado, utiliza un equivalente. ``` $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation ``` 1. Instala la AWS SAM CLI ejecutando el `install` ejecutable. Este ejecutable se ubica en el directorio utilizado en el paso anterior. A continuación, se muestra un ejemplo de uso del subdirectorio `sam-installation`: ``` $ sudo ./sam-installation/install ``` 1. Verifica la instalación. ``` $ sam --version ``` Para confirmar que la instalación se ha realizado correctamente, debería aparecer un resultado que sustituya el siguiente texto entre corchetes por la última versión disponible: ``` SAM CLI, ``` ------ #### [ arm64 - command line installer ] 1. Descarga el [archivo .zip de AWS SAM CLI](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip) a un directorio de tu elección. 1. **(Opcional)** Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Descomprime los archivos de instalación en el directorio que prefieras. A continuación, se muestra un ejemplo de uso del subdirectorio `sam-installation`. **nota** Si el sistema operativo no tiene el comando **unzip** integrado, utiliza un equivalente. ``` $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation ``` 1. Instala la AWS SAM CLI ejecutando el `install` ejecutable. Este ejecutable se ubica en el directorio utilizado en el paso anterior. A continuación, se muestra un ejemplo de uso del subdirectorio `sam-installation`: ``` $ sudo ./sam-installation/install ``` 1. Verifica la instalación. ``` $ sam --version ``` Para confirmar que la instalación se ha realizado correctamente, debería aparecer un resultado como el siguiente, pero que reemplace el texto entre corchetes por la última versión de la CLI de SAM: ``` SAM CLI, ``` ------ ### macOS #### Pasos de instalación Utilice el instalador del paquete para instalar el AWS SAMCLI. Además, el instalador del paquete tiene dos métodos de instalación entre los que puede elegir: **GUI** y **Línea de comandos**. Puede instalarlo para **todos los usuarios** o solo para **el usuario actual**. Para realizar la instalación para todos los usuarios, se requiere la autorización del superusuario. **nota** AWS SAM La CLI no admite versiones de macOS anteriores a macOS 13.x. Actualice a una versión compatible de macOS o instale AWS SAM CLI conHomebrew. ------ #### [ GUI - All users ] **Descarga del instalador del paquete para instalar la CLI de AWS SAM** **nota** Si instalaste previamente la AWS SAM CLI mediante Homebrew o pip, primero debes desinstalarlo. Para obtener instrucciones, consulta [Desinstalación de la AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Descargue el `pkg` para macOS al directorio que elija: + **Para equipos Mac con procesadores Intel, elija x86\$164** [— -x86\$164.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Para equipos Mac con Apple Silicon, selecciona arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **nota** Tiene la opción de comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Ejecuta el archivo descargado y sigue las instrucciones que aparecen en pantalla para continuar con los pasos de **introducción**, **léeme** y **licencia**. 1. En **Destination Select**, selecciona **Instalar para todos los usuarios de este equipo**. 1. Para el **tipo de instalación**, elige dónde se instalará la CLI de AWS SAM y pulsa **Instalar**. La ubicación predeterminada recomendada es `/usr/local/aws-sam-cli`. **nota** Para invocar la AWS SAM CLI con el comando **sam**, el instalador crea automáticamente un enlace simbólico entre `/usr/local/bin/sam` y `/usr/local/aws-sam-cli/sam` o la carpeta de instalación que elijas. 1. El AWS SAM CLI, procederán a la instalación y mostrarán el siguiente mensaje: «**La instalación se ha realizado correctamente**». Pulsa **Cerrar**. **Para comprobar que la instalación se ha realizado correctamente** + Comprueba que la AWS SAM CLI se ha instalado correctamente y que el enlace simbólico está configurado ejecutando: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, ``` ------ #### [ GUI - Current user ] **Descarga e instalación de la CLI de AWS SAM** **nota** Si instalaste previamente la AWS SAM CLI mediante Homebrew o pip, primero debes desinstalarlo. Para obtener instrucciones, consulta [Desinstalación de la AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Descargue el `pkg` para macOS al directorio que elija: + **Para equipos Mac con procesadores Intel, elige** [x86\$164 — -x86\$164.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Para equipos Mac con Apple Silicon, selecciona arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **nota** Tiene la opción de comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Ejecuta el archivo descargado y sigue las instrucciones que aparecen en pantalla para continuar con los pasos de **introducción**, **léeme** y **licencia**. 1. En **Destination Select**, selecciona **Instalar solo para mí**. Si no ves esta opción, ve al paso siguiente. 1. En **Tipos de instancias**, haga lo siguiente: 1. Elige dónde se instalará la CLI de AWS SAM. La ubicación predeterminada es `/usr/local/aws-sam-cli`. Selecciona una ubicación para la que tengas permisos de escritura. Para cambiar la ubicación de instalación, selecciona **local** y elige su ubicación. Pulsa **Continuar** cuando hayas terminado. 1. Si en el paso anterior no tenías la opción de elegir **Instalar solo para mí**, selecciona **Cambiar ubicación de instalación** > **Instalar solo para mí** y pulsa **Continuar**. 1. Pulsa **Instalar**. 1. El AWS SAM CLI procederán a la instalación y mostrarán «**La instalación se ha realizado correctamente**». Pulsa **Cerrar**. **Para crear un enlace simbólico** + Para invocar AWS SAM CLI con el comando **sam**, debes crear manualmente un enlace simbólico entre la CLI de AWS SAM y su `$PATH`. Crea tu enlace simbólico modificando y ejecutando el siguiente comando: ``` $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam ``` + *sudo*— Si su usuario tiene permisos de escritura para`$PATH`, no **sudo** es obligatorio. De lo contrario, se requiere el **sudo**. + *path-to*— Ruta a la que instalaste el AWS SAMCLI programa. Por ejemplo, `/Users/myUser/Desktop`. + *path-to-symlink-directory*— Tu variable de `$PATH` entorno. La ubicación predeterminada es `/usr/local/bin`. **Para comprobar que la instalación se ha realizado correctamente** + Comprueba que la AWS SAM CLI se ha instalado correctamente y que el enlace simbólico está configurado ejecutando: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, ``` ------ #### [ Command line - All users ] **Descarga e instalación de la CLI de AWS SAM** **nota** Si instalaste previamente la AWS SAM CLI mediante Homebrew o pip, primero debes desinstalarlo. Para obtener instrucciones, consulta [Desinstalación de la AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Descargue el `pkg` para macOS al directorio que elija: + **Para ordenadores Mac con procesadores Intel, elija x86\$164** [— -x86\$164.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Para equipos Mac con Apple Silicon, selecciona arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **nota** Tiene la opción de comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Modifica y ejecuta el script de instalación: ``` $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target / installer: Package name is AWS SAM CLI installer: Upgrading at base path / installer: The upgrade was successful. ``` **nota** Para invocar la CLI de AWS SAM con el **sam** comando, el instalador crea automáticamente un enlace simbólico entre `/usr/local/bin/sam` y `/usr/local/aws-sam-cli/sam`. **Para comprobar que la instalación se ha realizado correctamente** + Comprueba que la AWS SAM CLI se ha instalado correctamente y que el enlace simbólico está configurado ejecutando: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, ``` ------ #### [ Command line - Current user ] **Descarga e instalación de la CLI de AWS SAM** **nota** Si instalaste previamente la AWS SAM CLI mediante Homebrew o pip, primero debes desinstalarlo. Para obtener instrucciones, consulta [Desinstalación de la AWS SAM CLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 1. Descargue el `pkg` para macOS al directorio que elija: + **Para equipos Mac con procesadores Intel, elige** [x86\$164 — -x86\$164.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Para equipos Mac con Apple Silicon, selecciona arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **nota** Tiene la opción de comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Define un directorio de instalación en el que tengas permisos de escritura. A continuación, cree un archivo `xml` con la plantilla y modifíquelo para que refleje el directorio de instalación. El directorio debe existir previamente. Por ejemplo, si lo *path-to-my-directory* reemplaza por`/Users/myUser/Desktop`, la carpeta del `aws-sam-cli` programa se instalará allí. ``` choiceAttribute customLocation attributeSetting path-to-my-directory choiceIdentifier default ``` 1. Guarda el archivo `xml` y comprueba que es válido ejecutando lo siguiente: ``` $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -showChoicesAfterApplyingChangesXML path-to-your-xml-file ``` El resultado debes mostrar las preferencias que se aplicarán al programa AWS SAM CLI. 1. Ejecute lo siguiente para instalar AWS SAMCLI: ``` $ installer -pkg path-to-pkg-installer \ -target CurrentUserHomeDirectory \ -applyChoiceChangesXML path-to-your-xml-file # Example output installer: Package name is AWS SAM CLI installer: choices changes file 'path-to-your-xml-file' applied installer: Upgrading at base path base-path-of-xml-file installer: The upgrade was successful. ``` **Para crear un enlace simbólico** + Para invocar AWS SAM CLI con el comando **sam**, debes crear manualmente un enlace simbólico entre la CLI de AWS SAM y su `$PATH`. Crea tu enlace simbólico modificando y ejecutando el siguiente comando: ``` $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam ``` + *sudo*— Si su usuario tiene permisos de escritura para`$PATH`, no **sudo** es obligatorio. De lo contrario, se requiere el **sudo**. + *path-to*— Ruta a la que instalaste el AWS SAMCLI programa. Por ejemplo, `/Users/myUser/Desktop`. + *path-to-symlink-directory*— Tu variable de `$PATH` entorno. La ubicación predeterminada es `/usr/local/bin`. **Para comprobar que la instalación se ha realizado correctamente** + Comprueba que la AWS SAM CLI se ha instalado correctamente y que el enlace simbólico está configurado ejecutando: ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, ``` ------ ### Windows Los archivos Windows Installer (MSI) son los archivos de instalación de paquetes para el sistema operativo Windows. Siga estos pasos para instalar la CLI de AWS SAM mediante el archivo MSI. 1. Descarga la CLI de AWS SAM de [64 bits](https://github.com/aws/aws-sam-cli/releases/latest/download/AWS_SAM_CLI_64_PY3.msi). 1. **(Opcional)** Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta [Opcional: Comprobación de la integridad del instalador de la CLI de AWS SAM](reference-sam-cli-install-verify.md). 1. Verifica la instalación. Después de completar la instalación, verifíquela abriendo una nueva línea de comandos o línea de PowerShell comandos. Debería poder invocar `sam` en la línea de comandos. ``` sam --version ``` Tras una instalación correcta del AWS SAMCLI, debería ver un resultado como el siguiente: ``` SAM CLI, ``` 1. Habilite las rutas largas (solo en Windows 10 y versiones posteriores). **importante** AWS SAMCLIEs posible que interactúen con las rutas de archivo que superen el límite máximo de rutas de Windows. Esto puede provocar errores durante la ejecución de `sam init` debido a las limitaciones de **MAX\$1PATH** en Windows 10. Para resolver este problema, debes configurar el comportamiento de las nuevas rutas de acceso largo. Para habilitar las rutas largas, consulta [Habilitar las rutas largas en Windows 10, versión 1607 y versiones posteriores,](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later) en la *documentación de desarrollo de aplicaciones de Microsoft Windows*. 1. Instala Git Para descargar aplicaciones de muestra mediante el comando `sam init`, también debes instalar Git. Para ver las instrucciones, consulta la [Instalación de Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git). ## Solución de errores de la instalación ### Linux #### Error de Docker: «No se puedes conectar al daemon de Docker. ¿Se está ejecutando el daemon de Docker en este host?» En algunos casos, es posible que tengas que reiniciar la instancia para que `ec2-user` tengas los permisos necesarios para acceder al daemon de Docker. Si recibes este error, intenta reiniciar la instancia. #### Error del intérprete de comandos: «no se ha encontrado el comando» Si recibes este error, tu intérprete de comandos no puede localizar el ejecutable AWS SAMCLI en la ruta. Comprueba la ubicación del directorio en el que instalaste el ejecutable AWS SAMCLI y, a continuación, comprueba que el directorio se encuentra en su ruta. #### AWS SAMCLIerror: «/lib64/libc.so.6: no se ha encontrado la versión `GLIBC\$12.14' (requerida por /.so.1)» usr/local/aws-sam-cli/dist/libz Si recibes este error, significa que estás usando una versión no admitida de Linux y que la versión integrada de glibc es obsoleta. Haz una de estas dos operaciones: + Actualiza el host de Linux a la versión de 64 bits de una distribución reciente de CentOS, Fedora, Ubuntu o Amazon Linux 2. + Siga estas instrucciones para [Instala la AWS SAM CLI](#install-sam-cli). ### macOS #### Error en la instalación ![\[Imagen del instalador AWS SAMCLI que muestra un mensaje de error en la instalación\]](http://docs.aws.amazon.com/es_es/serverless-application-model/latest/developerguide/images/sam-cli-troubleshoot-install-macos-install-failed.jpg) Si estás instalando la AWS SAMCLI para tu usuario y has seleccionado un directorio de instalación para el que no tienes permisos de escritura, podría producirse este error. Haz una de estas dos operaciones: 1. Selecciona otro directorio de instalación para el que tengas permisos de escritura. 1. Elimine el instalador. A continuación, descárgala y ejecútalo de nuevo. ## Siguientes pasos Para obtener más información sobre las aplicaciones sin servidor de AWS SAM CLI y comenzar a crear las suyas, consulta los siguientes enlaces: + [Tutorial: Implemente una aplicación Hello World con AWS SAM](serverless-getting-started-hello-world.md)— Step-by-step instrucciones para descargar, crear e implementar una aplicación básica sin servidor. + [El AWS SAM taller completo](https://catalog.workshops.aws/complete-aws-sam/en-US): un taller diseñado para enseñarle muchas de las principales funciones que AWS SAM ofrece. + [AWS SAM ejemplos de aplicaciones y patrones](https://serverlessland.com/patterns?framework=AWS+SAM): ejemplos de aplicaciones y patrones de autores de la comunidad con los que puede seguir experimentando.