Instalación deAWS SAMCLI en macOS

Siga estos pasos para instalar y configurar los requisitos previos para utilizar laAWS SAMinterfaz de línea de comandos (CLI) de su host de macOS:

1. Cree una cuenta de AWS.

2. ConfigurarAWS Identity and Access Managementpermisos (IAM) yAWSCredenciales de .

3. Instalar Docker. Nota: Docker es un requisito previo solo para probar su aplicación localmente o utilizar el--use-containeropción

4. Instale Homebrew.

5. Instale la CLI de AWS SAM.

Paso 1: Crear una cuenta de AWS

Si aún no tiene unAWScuenta, consulteaws.amazon.comy eligeCreación de unAWSCuenta. Para obtener instrucciones detalladas, consulte .¿Cómo puedo crear y activar un nuevo?AWScuenta?

Paso 2: Configure los permisos de IAM yAWScredenciales

El usuario de IAM que utiliza conAWS SAMdebe tener permisos suficientes para hacer necesarioAWSllamadas de servicio y gestiónAWSde AWS. La forma más sencilla de garantizar que un usuario tenga permisos suficientes es otorgarle privilegios de administrador. Para obtener más información, consulte Creación del primer grupo y usuario administrador de IAM en la Guía del usuario de IAM.

nota

Si no desea conceder privilegios de administrador a los usuarios que utilizan elAWS Command Line Interface(AWS CLI), puede otorgarles conjuntos restringidos de permisos. Para obtener más información, consulte Permisos.

Además, para habilitar elAWS SAMCLI para hacerAWSllamadas de servicio, debe configurarAWSCredenciales de . Para obtener más información, consulte Configuración deAWScredenciales.

Paso 3: Instale Docker (opcional)

nota

Docker es un requisito previo solo para probar la aplicación localmente y para crear paquetes de implementación mediante el--use-containeropción. Si no tiene previsto utilizar estas funciones inicialmente, puede omitir esta sección o instalar Docker más adelante.

nota

Soportamos oficialmente Docker Desktop pero, a partir de SAM CLI versión 1.47.0, puedes usar alternativas siempre que utilicen el tiempo de ejecución de Docker.

Docker es una aplicación que ejecuta contenedores en sus máquinas macOS.AWS SAMproporciona un entorno local similar aAWS Lambdapara utilizar como contenedor de Docker. Puede utilizar este contenedor para compilar, probar y depurar aplicaciones sin servidor.

Para ejecutar proyectos y funciones sin servidor localmente con elAWS SAMCLI, debe tener Docker instalado y funcionando. LaAWS SAMLa CLI utiliza laDOCKER_HOSTvariable de entorno para contactar con el demonio de Docker. En los pasos que se describen a continuación, se describe cómo instalar, configurar y verificar una instalación de Docker para que funcione con laAWS SAMCLI.

1. Instalar Docker

   LaAWS SAMCLI admite Docker que se ejecuta en macOS Sierra 10.12 o superior. Para instalar Docker, consulte.Instalación de Docker Desktop para Mac.

2. Configurar las unidades compartidas

   LaAWS SAMLa CLI requiere que el directorio del proyecto, o cualquier directorio principal, aparezca en una unidad compartida. Para compartir unidades en macOS, consulteUso compartido de archivos.

3. Verificar la instalación de

   Después de instalar Docker, compruebe que funciona. Confirme también que puede ejecutar comandos de Docker desde la línea de comandos (por ejemplo,docker ps). No es necesario instalar, buscar ni extraer ningún contenedor: laAWS SAMCLI lo hace automáticamente según sea necesario.

Si tiene problemas al instalar Docker, consulte laRegistros y solución de problemasSección sobre de laGuía de instalación de DockerPara obtener consejos adicionales para la solución de problemas.

Paso 4: Instalar Homebrew

El enfoque recomendado para instalar elAWS SAMCLI en macOS consiste en utilizar elHomebrewadministrador de paquetes. Para obtener más información acerca de Homebrew, consulte Homebrew Documentation.

Para instalarHomebrew, primero debe instalar Git. Para obtener más información acerca de Git, consulte.Documentación de Git. Git está disponible en muchos sistemas operativos diferentes, incluido macOS. Para obtener instrucciones sobre cómo instalar Git en su sistema operativo concreto, consulteInstalación de Git.

Una vez que haya instalado correctamente Git, ejecute lo siguiente para instalarHomebrew, asegúrate de seguir las instrucciones:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Verifique queHomebrewestá instalado:

brew --version

Debería ver un resultado como el siguiente cuando se instale correctamente deHomebrew:

 
 Homebrew 2.5.7
 Homebrew/homebrew-core (git revision 1be3ad; last commit 2020-10-29)
 Homebrew/homebrew-cask (git revision a0cf3; last commit 2020-10-29)
        

Paso 5: Instalación delAWS SAMCLI

Siga estos pasos para instalar laAWS SAMCLI medianteHomebrew:

brew tap aws/tap
brew install aws-sam-cli

Verifique la instalación:

sam --version

Debería ver un resultado como el siguiente después de la instalación correcta de laAWS SAMCLI:

 
 SAM CLI, version 1.35.0

Ahora está preparado para iniciar el desarrollo.

Actualización

Para actualizarAWS SAMCLI:Homebrew, ejecute el siguiente comando:

brew upgrade aws-sam-cli

Desinstalación

Para desinstalar elAWS SAMCLI:Homebrew, ejecute el siguiente comando:

brew uninstall aws-sam-cli

Construcción nocturna

Una compilación nocturna delAWS SAMLa CLI está disponible para que la instale. Una vez instalado, puede utilizar la compilación nocturna mediante lasam-nightlycomando. Puede instalar y utilizar las versiones de producción y compilación nocturna delAWS SAMCLI al mismo tiempo.

La compilación nocturna contiene una versión preliminar deAWS SAMCódigo CLI que puede ser menos estable que la versión de producción. Tenga en cuenta que la compilación nocturna no contiene la versión preliminar de la imagen de compilación, por lo que compilar una aplicación sin servidor con el--use-containerutiliza la última versión de producción de la imagen de compilación.

Para instalar la versión de compilación nocturna delAWS SAMCLI: ejecute los siguientes comandos:

brew tap aws/tap
brew install aws-sam-cli-nightly

Para verificar que ha instalado la versión de compilación nocturna, ejecute lasam-nightly --versioncomando. El resultado de este comando está en el formulario1.X.Y.dev<YYYYMMDDHHmm>, por ejemplo:

SAM CLI, version 1.20.0.dev202103151200

Pasos siguientes

Ahora está preparado para comenzar a crear sus propias aplicaciones sin servidor medianteAWS SAM! Si desea iniciar con aplicaciones sin servidor de ejemplo, elija uno de los siguientes enlaces:

• Tutorial: Implementar una aplicación Hello World— Instrucciones paso a paso para descargar, compilar e implementar una aplicación sencilla sin servidor.

• AWS SAMaplicaciones y patrones de ejemplo— Aplicaciones de ejemplo y patrones de autores de la comunidad con los que puede seguir experimentando.