Instalación deAWS SAMCLI en Windows

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

1. Creación de unAWS Identity and Access Management(AWS) cuenta.

2. Configure los permisos de 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 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 .Creación y activación de unAWSCuenta.

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: Instalar 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 en otro momento.

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 Linux.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 SAMCLI 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 conAWS SAMCLI.

1. Instalar Docker.

   Docker Desktop es compatible con el sistema operativo Windows más reciente. Para las versiones heredadas de Windows, Docker Toolbox está disponible. Elija su versión de Windows para los pasos de instalación correctos de Docker:

   • Para instalar Docker para Windows 10, consulteInstalación de Docker Desktop para Windows.

   • Para instalar Docker para versiones anteriores de Windows, consulteInstalación de Docker Toolbox en Windows.

2. Configure las unidades compartidas.

   LaAWS SAMLa CLI requiere que el directorio del proyecto, o cualquier directorio principal, aparezca en una unidad compartida. En algunos casos, debe compartir la unidad para que Docker funcione correctamente.

   • Si utilizas Windows 10 en modo Hyper-V, consultaUso compartido de archivos de Docker.

   • Para compartir unidades en versiones anteriores de Windows, consulteAgregar directorios compartidos.

3. Verifique la instalación.

   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 o 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: Instalación delAWS SAMCLI

Los archivos de Windows Installer (MSI) son los archivos del instalador de paquetes del sistema operativo Windows.

Siga estos pasos para instalar laAWS SAMCLI mediante el archivo MSI.

1. Instalación delAWS SAMCLI64 bits.

   nota

   Si opera en un sistema de 32 bits, consulteInstalaciónAWS SAMCLI en Windows de 32 bits.

2. Verifique la instalación.

   Después de completar la instalación, compruébalo abriendo un nuevo símbolo del sistema o PowerShell . Debería poder invocarsamdesde la línea de comandos.

   sam --version

   Debería ver un resultado como el siguiente después de instalar correctamente laAWS SAMCLI:

    
    SAM CLI, version 1.35.0
                   

3. Instale Git.

   Para descargar aplicaciones de ejemplo mediante elsam init, también debe instalar Git. Para obtener instrucciones, consulteInstalación de Git.

Ahora está preparado para iniciar el desarrollo.

Desinstalación

Para desinstalar elAWS SAMCLI con Configuración de Windows: Siga estos pasos:

1. En el menú Inicio, busca «Agregar o quitar programas».

2. Seleccione la entrada denominadaAWS SAMCommand Line Interfacey eligeDesinstalación depara iniciar el desinstalador.

3. Confirme que desea desinstalar laAWS SAMCLI.

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

La compilación nocturna está disponible con este enlace de descarga:AWS SAM compilación nocturna de CLI. Para instalar la versión de compilación nocturna delAWS SAMCLI:, realice los mismos pasos que en laPaso 4: Instalación delAWS SAMCLIsección anterior en este tema, pero usa el enlace de descarga de compilación nocturna en su lugar.

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

SAM CLI, version 1.20.0.dev202103151200

Pasos siguientes

Ahora está preparado para iniciar la creación de sus propias aplicaciones sin servidor conAWS 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.