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 la CLI de AWS SAM
Instale la última versión de la interfaz de línea de AWS Serverless Application Model comandos (AWS SAMCLI) en los sistemas operativos compatibles.
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, consulteAdministración de versiones de la CLI de AWS SAM.
¿Es la primera vez que instala AWS SAM CLI?
Complete todos los requisitos previos de la sección anterior antes de continuar. Esto incluye:
-
Registrarse para obtener una AWS cuenta.
-
Creación de un usuario de IAM no administrativo.
-
Creación de un identificador de clave de acceso y de una clave de acceso secreta.
-
Instalación del AWS CLI.
-
Configuración de AWS credenciales.
Instalación de la CLI de AWS SAM
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, puede utilizar el instalador gestionado por la comunidad. Para obtener más información, consulte Administración de CLI de AWS SAM con la 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, consulte Cambiar de Homebrew.
Para instalarlo AWS SAMCLI, siga las instrucciones de su sistema operativo.
- arm64 - command line installer
-
-
Descargue el archivo .zip deAWS SAM CLI a un directorio de su elección.
-
(Opcional) Puede comprobar la integridad del instalador antes de la instalación. Para ver instrucciones, consulte Compruebe la integridad del instalador de la CLI de AWS SAM..
-
Descomprima los archivos de instalación en el directorio que prefiera. A continuación, se muestra un ejemplo de uso del subdirectorio sam-installation.
Si el sistema operativo no tiene el comando unzip integrado, utilice un equivalente.
$ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
-
Instale la CLI de AWS SAMejecutando 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
-
Verifique la instalación.
$ sam --version
Para confirmar que la instalación se ha realizado correctamente, debería 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>
- x86_64 - command line installer
-
-
Descargue el archivo .zip deAWS SAM CLI a un directorio de su elección.
-
(Opcional) Puede comprobar la integridad del instalador antes de la instalación. Para ver instrucciones, consulte Compruebe la integridad del instalador de la CLI de AWS SAM..
-
Descomprima los archivos de instalación en el directorio que prefiera. A continuación, se muestra un ejemplo de uso del subdirectorio sam-installation.
Si el sistema operativo no tiene el comando unzip integrado, utilice un equivalente.
$ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
-
Instale la CLI de AWS SAMejecutando 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
-
Verifique 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>
Instale AWS SAM CLI mediante el instalador del paquete.
El instalador del paquete está disponible en las opciones x86_64 y arm64. Elija el paquete que coincida con el hardware Mac:
Para obtener más información, consulte equipos Mac con silicio de Apple.
Uso del instalador del paquete
El instalador del paquete tiene dos métodos de instalación entre los que puede elegir:
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.
Pasos de instalación
Instale la CLI de AWS SAMutilizando cualquiera de las siguientes opciones.
- GUI - All users
-
Para descargar el instalador del paquete
Para comprobar el instalador del paquete (opcional)
Para instalar la CLI de AWS SAM
-
Ejecute el archivo descargado y siga las instrucciones que aparecen en pantalla para continuar con los pasos de introducción, léame y licencia.
-
En Destination Select, seleccione Instalar para todos los usuarios de este equipo.
-
Para el tipo de instalación, elija dónde se instalará la CLI de AWS SAMy pulse Instalar. La ubicación predeterminada recomendada es /usr/local/aws-sam-cli.
Para invocar la CLI de AWS SAMcon 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 elija.
-
El AWS SAMy la CLI procederán a la instalación y mostrarán “La instalación se ha realizado correctamente”. Pulse Cerrar.
Para comprobar que la instalación se ha realizado correctamente
-
Compruebe que la CLI de AWS SAMse 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
-
Para descargar el instalador del paquete
Para comprobar el instalador del paquete (opcional)
Para instalar la CLI de AWS SAM
-
Ejecute el archivo descargado y siga las instrucciones que aparecen en pantalla para continuar con los pasos de introducción, léame y licencia.
-
En Destination Select, selecciona Instalar solo para mí. Si no ve esta opción, vaya al paso siguiente.
-
En Tipos de instancias, haga lo siguiente:
-
Elige dónde se instalará la CLI de AWS SAM. La ubicación predeterminada es /usr/local/aws-sam-cli. Seleccione una ubicación para la que tenga permisos de escritura. Para cambiar la ubicación de instalación, seleccione local y elija su ubicación. Pulse Continuar cuando haya terminado.
-
Si en el paso anterior no tenía la opción de elegir Instalar solo para mí, seleccione Cambiar ubicación de instalación > Instalar solo para mí y pulse Continuar.
-
Pulse Instalar.
-
El AWS SAMy la CLI procederán a la instalación y mostrarán “La instalación se ha realizado correctamente”. Pulse Cerrar.
Para crear un enlace simbólico
-
Para invocar la CLI de AWS SAMcon el comando sam, debe crear manualmente un enlace simbólico entre la CLI de AWS SAMy su $PATH. Cree su 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, sudo no es obligatorio. De lo contrario, se requiere el sudo.
-
path-to: ruta al lugar donde instaló la CLI de AWS SAM. 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
-
Compruebe que la CLI de AWS SAMse 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
-
Para descargar el instalador del paquete
Para comprobar el instalador del paquete (opcional)
Para instalar la CLI de AWS SAM
-
Modifique y ejecute 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.
Para invocar la CLI de AWS SAMcon 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
-
Compruebe que la CLI de AWS SAMse 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
-
Para descargar el instalador del paquete
Para comprobar el instalador del paquete (opcional)
Para instalar la CLI de AWS SAM
-
Defina un directorio de instalación en el que tenga 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 path-to-my-directoryreemplaza por/Users/myUser/Desktop, la carpeta del aws-sam-cli programa 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>
-
Guarde el archivo xml y compruebe que es válido ejecutando lo siguiente:
$ installer -pkg path-to-pkg-installer \
-target CurrentUserHomeDirectory \
-showChoicesAfterApplyingChangesXML path-to-your-xml-file
El resultado debe mostrar las preferencias que se aplicarán a la CLI de AWS SAM.
-
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 la CLI de AWS SAMcon el comando sam, debe crear manualmente un enlace simbólico entre la CLI de AWS SAMy su $PATH. Cree su 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, sudo no es obligatorio. De lo contrario, se requiere el sudo.
-
path-to: ruta al lugar donde instaló la CLI de AWS SAM. Por ejemplo, /Users/myUser/Desktop.
-
path-to-symlink-directory— Su variable de $PATH entorno. La ubicación predeterminada es /usr/local/bin.
Para comprobar que la instalación se ha realizado correctamente
-
Compruebe que la CLI de AWS SAMse 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 SAMmediante el archivo MSI.
-
Descargue la CLI de AWS SAMde 64 bits.
-
(Opcional) Puede comprobar la integridad del instalador antes de la instalación. Para ver instrucciones, consulte Compruebe la integridad del instalador de la CLI de AWS SAM..
-
Verifique la instalación.
Tras 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, <latest version>
-
Habilite las rutas largas (solo en Windows 10 y versiones posteriores).
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 sam init debido a las MAX_PATH limitaciones de Windows 10. Para resolver este problema, debe configurar el comportamiento de las nuevas rutas de acceso largo.
Para habilitar las rutas largas, consulte Habilitar las rutas largas en Windows 10, versión 1607 y versiones posteriores, en la documentación de desarrollo de aplicaciones de Microsoft Windows.
-
Instale Git
Para descargar aplicaciones de muestra mediante el comando sam init, también debe instalar Git. Para ver instrucciones, consulte la Instalación de Git.
Solución de problemas
Si encuentra problemas al instalar el AWS SAMCLI, consulteErrores de instalación.
Siguientes pasos
Para obtener más información sobre las aplicaciones sin servidor de la CLI de AWS SAMy comenzar a crear las suyas, consulte los siguientes enlaces:
