Instala la AWS SAM CLI - AWS Serverless Application Model
Instalación de la AWS SAM CLISolución de errores de la instalaciónPasos a seguir a continuación

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

Instala la última versión de la interfaz de línea de AWS Serverless Application Modelcomandos (AWS SAM CLI) en los sistemas operativos compatibles.

Para obtener información sobre la administración de una versión instalada actualmente de la AWS SAM CLI, incluido cómo actualizar, desinstalar o administrar las compilaciones nocturnas, consulta Administración de versiones de AWS SAM CLI.

¿Es la primera vez que instala AWS SAM CLI?

Completa todos los requisitos previos de la sección anterior antes de continuar. Esto incluye:

  1. Registrarse para obtener una cuenta de AWS.

  2. Creación de un usuario de IAM no administrativo.

  3. Creación de un identificador de claves de acceso y de una claves de acceso secreta.

  4. Instalación de la AWS CLI.

  5. Configuración de credenciales de AWS.

Temas

Instalación de la AWS SAM CLI

nota

A partir de septiembre de 2023, AWS dejará de mantener el instalador Homebrew gestionado por AWS para la CLI de AWS SAM (aws/tap/aws-sam-cli). Si utiliza Homebrew para instalar y administrar la AWS SAM CLI, consulta las siguientes opciones:

Para instalar la AWS SAM CLI, sigue las instrucciones de su sistema operativo.

x86_64 - command line installer

  1. Descarga el archivo .zip de AWS SAM CLI a un directorio de tu elección.

  2. (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  3. Descomprime los archivos de instalación en el directorio que prefiera. A continuación, se muestra un ejemplo de uso del subdirectorio sam-installation.

    nota

    Si el sistema operativo no tienes el comando unzip integrado, utiliza un equivalente.

    $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation

  4. 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

  5. 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, <latest version>
arm64 - command line installer

  1. Descarga el archivo .zip de AWS SAM CLI a un directorio de tu elección.

  2. (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  3. 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

  4. 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

  5. Verifica la instalación.

    $ sam --version

    Para confirmar que la instalación se ha realizado correctamente, deberías ver un resultado como el siguiente, pero que reemplaza el texto entre corchetes por la última versión de la CLI de SAM:

     SAM CLI, <latest version>

Pasos de instalación

Utiliza el instalador del paquete para instalar el AWS SAM CLI. Además, el instalador del paquete tiene dos métodos de instalación entre los que puedes elegir: GUI y Línea de comandos. Puedes 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.

GUI - All users
Para descargar el instalador del paquete e instalar el AWS SAMCLI
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.

  1. Descarga el archivo .zip de pkg a un directorio de tu elección.

    nota

    (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  2. Ejecuta el archivo descargado y sigue las instrucciones que aparecen en pantalla para continuar con los pasos de introducción, léeme y licencia.

  3. En Destination Select, selecciona Instalar para todos los usuarios de este equipo.

  4. 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.

  5. 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, <latest version>
GUI - Current user
Descarga e instala el AWS SAM CLI
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.

  1. Descarga el archivo .zip de pkg a un directorio de tu elección.

    nota

    (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  2. Ejecuta el archivo descargado y sigue las instrucciones que aparecen en pantalla para continuar con los pasos de introducción, léeme y licencia.

  3. En Destination Select, selecciona Instalar solo para mí. Si no ves esta opción, ve al paso siguiente.

  4. 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.

    2. 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.

    3. Pulsa Instalar.

  5. 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 la 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 tu usuario tiene permisos de escritura para $PATH, sudo no es obligatorio. De lo contrario, se requiere el sudo.

    • path-to: ruta al lugar donde instalaste la CLI de AWS SAM. Por ejemplo, /Users/myUser/Desktop.

    • path-to-symlink-directory: su variable de entorno $PATH. 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, <latest version>
Command line - All users
Descarga e instala el AWS SAM CLI
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.

  1. Descarga el archivo .zip de pkg a un directorio de tu elección.

    nota

    (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  2. 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, <latest version>
Command line - Current user
Descarga e instala el AWS SAM CLI
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.

  1. Descarga el archivo .zip de pkg a un directorio de tu elección.

    nota

    (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  2. 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 reemplaza path-to-my-directory por /Users/myUser/Desktop, la carpeta del programa aws-sam-cli se instalará allí. 

    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <array>
    <dict>
      <key>choiceAttribute</key>
      <string>customLocation</string>
      <key>attributeSetting</key>
      <string>path-to-my-directory</string>
      <key>choiceIdentifier</key>
      <string>default</string>
    </dict>
  </array>
</plist>

  3. 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.

  4. Ejecuta lo siguiente para instalar la AWS SAM CLI: 

    $ 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 tu usuario tiene permisos de escritura para $PATH, sudo no es obligatorio. De lo contrario, se requiere el sudo.

    • path-to: ruta al lugar donde instalaste la CLI de AWS SAM. Por ejemplo, /Users/myUser/Desktop.

    • path-to-symlink-directory: su variable de entorno $PATH. 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, <latest version>

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.

  2. (Opcional) Puedes comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulta Comprueba la integridad del instalador de la CLI de AWS SAM..

  3. Verifica la instalación.

    Tras completar la instalación, verifícala abriendo una nueva línea de comandos o una línea de comandos de PowerShell. Debería poder invocar sam en la línea de comandos.

    sam --version

    Tras una instalación correcta de la AWS SAM CLI, debería ver un resultado similar al siguiente:

    SAM CLI, <latest version>

  4. Habilite las rutas largas (solo en Windows 10 y versiones posteriores).

    importante

    AWS SAMCLIEs posible que interactúen con rutas de archivos que superen el límite máximo de rutas de Windows. Esto puede provocar errores durante la ejecución sam init debido a las MAX_PATH limitaciones de 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, en la documentación de desarrollo de aplicaciones de Microsoft Windows.

  5. 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.

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 SAM CLI en la ruta. Comprueba la ubicación del directorio en el que instalaste el ejecutable AWS SAM CLI y, a continuación, comprueba que el directorio se encuentra en su ruta.

Error AWS SAMCLI: «/lib64/libc.so.6: no se ha encontrado la versión `GLIBC_2.14' (/usr/local/aws-sam-cli/dist/libz.so.1)»

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.

macOS

Error en la instalación

Imagen del instalador AWS SAM CLI que muestra un mensaje de error en la instalación

Si estás instalando la AWS SAM CLI 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.

  2. Elimine el instalador. A continuación, descárgala y ejecútalo de nuevo.

Pasos a seguir a continuación

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: