compilación de sam

Opcional. Indica AWS SAM que se cree un único recurso declarado en una AWS SAM plantilla. Los artefactos de compilación del recurso especificado serán los únicos disponibles para los siguientes comandos del flujo de trabajo, es decir, sam package y sam deploy.

Resuelve las rutas relativas al código fuente de la función o capa con respecto a este directorio. Utiliza esta opción si desea cambiar la forma en que se resuelven las rutas relativas a las carpetas de código fuente. De forma predeterminada, las rutas relativas se resuelven con respecto a la ubicación de la plantilla de AWS SAM .

Además de los recursos de la aplicación o pila raíz que está creando, esta opción también se aplica a las aplicaciones o pilas anidadas.

Esta opción se aplica a los siguientes tipos y propiedades de recursos:

Permitir o denegar las características beta.

La ruta a un directorio en el que se almacenan los artefactos creados. Este directorio y todo su contenido se eliminan con esta opción.

URI de la imagen del contenedor que quiere extraer para la compilación. De forma predeterminada, AWS SAM extrae la imagen del contenedor de Amazon ECR Public. Utiliza esta opción para extraer la imagen desde otra ubicación.

Puedes especificar esta opción varias veces. Cada instancia de esta opción puede tomar una cadena o un par clave-valor. Si especificas una cadena, será el URI de la imagen del contenedor que se usará para todos los recursos de la aplicación. Por ejemplo, sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8. Si especificas un par clave-valor, la clave es el nombre del recurso y el valor es el URI de la imagen del contenedor que se va a usar para ese recurso. Por ejemplo, sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8. Con los pares clave-valor, puede especificar distintas imágenes del contenedor para distintos recursos.

Esta opción solo se aplica si se especifica la opción --use-container; de lo contrario, se producirá un error.

Proporciona --build-in-source para compilar el proyecto directamente en la carpeta de origen.

La opción --build-in-source admite los siguientes tiempos de ejecución y métodos de compilación:

La opción --build-in-source no es compatible con las siguientes opciones:

Valor predeterminado: --no-build-in-source

Habilitar o desactivar las compilaciones en caché. Usa esta opción para reutilizar artefactos de compilación que no hayan cambiado con respecto a compilaciones anteriores. AWS SAM evalúa si has cambiado algún archivo del directorio de tu proyecto. De forma predeterminada, las compilaciones no se almacenan en caché. Si se invoca la opción --no-cached, anula la configuración cached = true de samcofig.toml.

El directorio en el que se almacenan los artefactos de la caché cuando se especifica --cached. El directorio predeterminado de la caché es .aws-sam/cache.

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.

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 por defecto 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.

Las variables de entorno que transferir al contenedor de compilaciones. Puedes especificar esta opción varias veces. Cada instancia de esta opción utiliza un par clave-valor, donde la clave es la variable de recurso y entorno, y el valor es el valor de la variable de entorno. Por ejemplo: --container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2.

Esta opción solo se aplica si se especifica la opción --use-container; de lo contrario, se producirá un error.

La ruta y el nombre de un archivo JSON que contiene valores para las variables de entorno del contenedor. Para obtener más información sobre archivos de variable de entorno del contenedor, consulta Archivo de variables del entorno del contenedor..

Esta opción solo se aplica si se especifica la opción --use-container; de lo contrario, se producirá un error.

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

Especifica el nombre o el ID de una red de Docker existente a la que deben conectarse los contenedores de Docker , junto con la red en modo puente predeterminada. Si no se especifica, los contenedores de Lambda se conectan únicamente a la red Docker en modo puente predeterminada.

El nombre de los recursos que se van a excluir de sam build. Por ejemplo, si tu plantilla contiene Function1, Function2 y Function3 y usted ejecuta sam build --exclude Function2, solo se compilarán Function1 y Function3.

Muestra este mensaje y sale.

El nombre del enlace que se utiliza para ampliar la funcionalidad de la CLI de AWS SAM.

Valores aceptados: terraform.

La ruta a un archivo de manifiesto de dependencias personalizado (por ejemplo, package.json) para usarlo en lugar del predeterminado.

Garantiza que la CLI de AWS SAM siempre monte los enlaces simbólicos que están presentes en los archivos para compilarlos o invocarlos. Esto solo se aplica a los enlaces simbólicos del directorio de nivel superior (es decir, los que se encuentran directamente en la raíz de la función). Por defecto, los enlaces simbólicos no se montan, excepto los necesarios para utilizar build-in-source para node_modules en NodeJS.

Una opción que permite usar el kit de herramientas de IDE para establecer el comportamiento predeterminado. También puede utilizar sam build --no-use-container para ejecutar una compilación en su máquina local en lugar de en un contenedor de Docker.

El formato del resultado del comando:

Cuando lo especificas--output json, AWS SAMCLI imprime un único objeto JSON una vez finalizado el comando. En caso de éxito, este objeto incluye campos como el estado de compilación, el directorio de compilación, el archivo de plantilla y una lista de los recursos que se crearon. En caso de error, incluye un error objeto que describe lo que ha fallado.

Habilitar compilaciones paralelas. Usa esta opción para crear las funciones y capas de tu AWS SAM plantilla en paralelo. De forma predeterminada, las funciones y las capas se crean en secuencia.

(Opcional) Una cadena que contiene anulaciones de CloudFormation parámetros codificadas como pares clave-valor. Usa el mismo formato que (). AWS Command Line Interface AWS CLI Por ejemplo: 'ParameterKey=KeyPairName, ParameterValue=MyKey ParameterKey=InstanceType, ParameterValue=t1.micro'. Esta opción no es compatible con --hook-name.

El perfil específico de su archivo de credenciales que obtiene AWS las credenciales.

El lugar en el Región de AWS que realizar el despliegue. Por ejemplo, us-east-1.

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

Omite la fase de preparación si no se ha realizado ningún cambio en la infraestructura. Ejecuta con la opción --hook-name.

Especifica si el comando debe omitir la extracción de la última imagen de Docker para el tiempo de ejecución de Lambda.

La ruta y el nombre del archivo de AWS SAM plantilla[default: template.[yaml|yml]]. Esta opción no es compatible con --hook-name.

La ruta relativa o absoluta al directorio de nivel superior que contiene los archivos de configuración de Terraform o el código fuente de la función. Si estos archivos se encuentran fuera del directorio que contiene el módulo raíz de Terraform, utilice esta opción para especificar su ruta absoluta o relativa. Esta opción requiere que --hook-name se establezca en terraform.

Activa o desactiva el uso del BuildKit complemento para la creación de imágenes de contenedores. Esto usará el Finch o DockerCLIs. De forma predeterminada, las compilaciones utilizan el generador heredado del SDK. Si se invoca la opción --no-use-buildkit, anula la configuración use-buildkit = true de samcofig.toml.

Si tus funciones dependen de paquetes que tienen dependencias compiladas de forma nativa, usa esta opción para crear tu función dentro de un Lambda-like contenedor Docker.