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.
Instale la AWS SAM CLI
Instale la versión más reciente de AWS Serverless Application Model Interfaz de línea de comandos (AWS SAM CLI) en los sistemas operativos compatibles.
Para obtener información sobre la administración de una versión actualmente instalada del AWS SAM CLI, que incluye 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 el AWS SAM CLI?
Complete todos los requisitos previos de la sección anterior antes de continuar. Esto incluye:
-
Registrarse en un AWS account.
-
Crear un IAM usuario administrativo.
-
Creación de un identificador de clave de acceso y de una clave de acceso secreta.
-
Instalación de la de AWS CLI.
-
Configuración AWS credenciales.
Instalación de la de AWS SAM CLI
A partir de septiembre de 2023, AWS ya no mantendrá el AWS administradas Homebrew instalador para el AWS SAM CLI (aws/tap/aws-sam-cli). Si usas Homebrew para instalar y administrar el AWS SAM CLI, consulte las siguientes opciones:
Para instalar la de AWS SAM CLI, siga las instrucciones de su sistema operativo.
- x86_64 - command line installer
-
-
Descargar AWS SAM CLI archivo.zip a un directorio de su elección.
-
(Opcional) Puede comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulte Opcional: compruebe la integridad del AWS SAM CLI installer (instalador).
-
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 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
-
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>
- arm64 - command line installer
-
-
Descargar AWS SAM CLI El archivo.zip lo llevará al directorio que elija.
-
(Opcional) Puede comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulte Opcional: compruebe la integridad del AWS SAM CLI installer (instalador).
-
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 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
-
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 sustituye el texto entre corchetes por la SAM CLI versión más reciente:
SAM CLI, <latest version>
Pasos de instalación
Utilice 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 puede elegir: GUIy la 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.
- GUI - All users
-
Para descargar el instalador del paquete e instalar el AWS SAM CLI
-
Descarga macOS pkg en el directorio que prefieras:
-
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.
-
En el tipo de instalación, elija dónde está AWS SAM CLI se instalará y pulse Instalar. La ubicación predeterminada recomendada es /usr/local/aws-sam-cli.
Para invocar el AWS SAM CLI con el sam comando, el instalador crea automáticamente un enlace simbólico entre /usr/local/bin/sam una de las carpetas de instalación que elija /usr/local/aws-sam-cli/sam o la carpeta de instalación que elija.
-
La AWS SAM CLI se instalará y aparecerá el mensaje La instalación se ha realizado correctamente. Pulse Cerrar.
Para comprobar que la instalación se ha realizado correctamente
-
Compruebe que el AWS SAM CLI se ha instalado correctamente y que su enlace simbólico está configurado ejecutando:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- GUI - Current user
-
Para descargar e instalar el AWS SAM CLI
-
Descarga macOS pkg en el directorio que prefieras:
-
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:
-
Elija dónde está AWS SAM CLI se instalará. 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.
-
La AWS SAM CLI se instalará y aparecerá el mensaje La instalación se ha realizado correctamente. Pulse Cerrar.
Para crear un enlace simbólico
-
Para invocar el AWS SAM CLI con el sam comando, debe crear manualmente un enlace simbólico entre AWS SAM CLI programa y tu. $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, no sudo es obligatorio. De lo contrario, se requiere el sudo.
-
path-to — Ruta al lugar donde instaló el AWS SAM CLI 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
-
Compruebe que el AWS SAM CLI se ha instalado correctamente y que su enlace simbólico está configurado ejecutando:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - All users
-
Para descargar e instalar el AWS SAM CLI
-
Descarga macOS pkg en el directorio que prefieras:
-
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 el AWS SAM CLI con el sam comando, el instalador crea automáticamente un enlace simbólico entre y/usr/local/bin/sam. /usr/local/aws-sam-cli/sam
Para comprobar que la instalación se ha realizado correctamente
-
Compruebe que el AWS SAM CLI se ha instalado correctamente y que su enlace simbólico está configurado ejecutando:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - Current user
-
Para descargar e instalar el AWS SAM CLI
-
Descarga macOS pkg en el directorio que prefieras:
-
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 reemplaza path-to-my-directory con/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 AWS SAM CLI programa.
-
Ejecute lo siguiente para instalar el 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 el AWS SAM CLI con el sam comando, debe crear manualmente un enlace simbólico entre AWS SAM CLI programa y tu. $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, no sudo es obligatorio. De lo contrario, se requiere el sudo.
-
path-to — Ruta al lugar donde instaló el AWS SAM CLI 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
-
Compruebe que el AWS SAM CLI se ha instalado correctamente y que su 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 el AWS SAM CLI utilizando el MSI archivo.
-
Descarga el AWS SAM CLI 64 bits.
-
(Opcional) Puede comprobar la integridad del instalador antes de la instalación. Para obtener instrucciones, consulte Opcional: compruebe la integridad del AWS SAM CLI installer (instalador).
-
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 la instalación correcta del AWS SAM CLI, debería ver un resultado como el siguiente:
SAM CLI, <latest version>
-
Habilite las rutas largas (solo en Windows 10 y versiones posteriores).
La AWS SAM CLI podría interactuar 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 errores de la instalación de
Linux
Error de Docker: “No se puede conectar al daemon de Docker. ¿Se está ejecutando el daemon de Docker en este host?”
En algunos casos, es posible que tenga que reiniciar su instancia para que el ec2-user tenga los permisos necesarios para acceder al daemon de Docker. Si recibe este error, intente reiniciar la instancia.
Error del intérprete de comandos: “no se ha encontrado el comando”
Si recibes este error, tu shell no puede localizar el AWS SAM CLI ejecutable en la ruta. Compruebe la ubicación del directorio en el que instaló el AWS SAM CLI ejecutable y, a continuación, compruebe que el directorio se encuentra en su ruta.
AWS SAM CLI error: «/lib64/libc.so.6: no se ha encontrado la versión 'GLIBC_2.14' (requerida por /usr/local/ /dist/libz.so.1)» aws-sam-cli
Si recibe este error, significa que está usando una versión no admitida de Linux y que la versión integrada de glibc es obsoleta. Haga una de estas dos operaciones:
-
Actualice 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 Instale la AWS SAM CLI.
macOS
Error en la instalación
Si está instalando el AWS SAM CLI para su usuario y ha seleccionado un directorio de instalación para el que no tiene permisos de escritura, podría producirse este error. Haga una de estas dos operaciones:
-
Seleccione otro directorio de instalación para el que tenga permisos de escritura.
-
Elimine el instalador. A continuación, descárguelo y ejecútelo de nuevo.
Siguientes pasos
Para obtener más información sobre el AWS SAM CLI y para empezar a crear sus propias aplicaciones sin servidor, consulte lo siguiente:
