sam init - AWS Serverless Application Model
UsoOpcionesEjemplo

sam init

Esta página proporciona información de referencia para el comando sam init de la interfaz de la línea de comandos AWS Serverless Application Model (AWS SAM CLI).

El comando sam init proporciona opciones para inicializar una nueva aplicación sin servidor.

Uso

$ sam init <options>

Opciones

--app-template TEXT

El identificador de la plantilla de la aplicación gestionada que recomendamos utilizar. Si no está seguro, llame a sam init sin opciones para disfrutar de un flujo de trabajo interactivo.

Este parámetro es obligatorio si se especifica --no-interactive, y --location si no se proporciona.

Esta característica solo está disponible en la versión 0.30.0 o posterior de la CLIde AWS SAM. Si se especifica este parámetro con una versión anterior, se produce un error.

--application-insights | --no-application-insights

Active la supervisión de información de aplicaciones de Amazon CloudWatch para su aplicación. Para obtener más información, consulta Uso de Información de aplicaciones de CloudWatch para supervisar sus aplicaciones sin servidor de AWS SAM.

La opción predeterminada es --no-application-insights.

--architecture, -a [ x86_64 | arm64 ]

La arquitectura del conjunto de instrucciones para las funciones de Lambda de la aplicación. Especifica una de las siguientes opciones: x86_64 o arm64

--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]

La imagen base de su aplicación. Esta opción solo se aplica cuando el tipo de paquete es Image.

Este parámetro es obligatorio si --no-interactive se especifica, --package-type se especifica como Image y --location no se especifica.

--config-env TEXT

El nombre del entorno que especifica los valores de los parámetros predeterminados del archivo de configuración que se va a utilizar. El valor por defecto es «predeterminado». Para obtener más información sobre los archivos de configuración, consulta Archivo de configuración de la CLI de AWS SAM.

--config-file PATH

La ruta y el nombre del archivo de configuración que contiene los valores de parámetros predeterminados que se van a utilizar. El valor predeterminado es «samconfig.toml» en la raíz del directorio del proyecto. Para obtener más información sobre los archivos de configuración, consulta Archivo de configuración de la CLI de AWS SAM.

--debug

Activa el registro de depuración para imprimir los mensajes de depuración que genera la AWS SAM de CLI y para mostrar las marcas temporales.

--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]

El administrador de dependencias de su tiempo de ejecución de Lambda.

--extra-content

Anule cualquier parámetro personalizado de la configuración cookiecutter.json de la plantilla, por ejemplo, {"customParam1": "customValue1", "customParam2":"customValue2"}.

--help, -h

Muestra este mensaje y sale.

--location, -l TEXT

La ubicación de la plantilla o aplicación (Git, Mercurial, HTTP/HTTPS, archivo.zip, ruta).

Este parámetro es obligatorio si se especifica --no-interactive, --runtime o --name, y --app-template si no se proporciona.

Para los repositorios Git, debe usar la ubicación de la raíz del repositorio.

Para las rutas locales, la plantilla debe estar en formato de archivo.zip o Cookiecutter.

--name, -n TEXT

El nombre del proyecto que se generará como un directorio.

Este parámetro es obligatorio si se especifica --no-interactive, y --location si no se proporciona.

--no-input

Desactiva las solicitudes de Cookiecutter y acepta los valores vcfdefault que se definen en la configuración de plantilla.

--no-interactive

Deshabilita la solicitud interactiva para los parámetros de inicio y falla si falta algún valor obligatorio.

--output-dir, -o PATH

La ubicación en la que se muestra la aplicación inicializada.

--package-type [ Zip | Image ]

El tipo de paquete de la aplicación de ejemplo. Zip crea un archivo .zip y Image crea una imagen del contenedor.

--runtime, -r [ dotnet8 | dotnet6 | java21 | java17 | java11 | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]

El tiempo de ejecución Lambda de su aplicación. Esta opción solo se aplica cuando el tipo de paquete es Zip.

Este parámetro es obligatorio si --no-interactive se especifica, --package-type se especifica como Zip y --location no se especifica.

--save-params

Guarda los parámetros que proporciones en la línea de comandos en el archivo de configuración de AWS SAM.

--tracing | --no-tracing

Active el rastreo de AWS X-Ray para sus funciones de Lambda.

Ejemplo

Para ver un ejemplo y un tutorial detallados sobre el uso del subcomando sam init, consulte Creación de una aplicación en AWS SAM.