View a markdown version of this page

sam package - AWS Serverless Application Model

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.

sam package

El AWS Serverless Application Model Interfaz de línea de comandos (AWS SAM CLI() paquetes y AWS SAM aplicación.

Este comando crea un .zip archivo de su código y dependencias, y lo sube a Amazon Simple Storage Service (Amazon S3). AWS SAM habilita el cifrado de todos los archivos almacenados en Amazon S3. A continuación, devuelve una copia de su AWS SAM plantilla, sustituyendo las referencias a los artefactos locales por la ubicación de Amazon S3 en la que el comando cargó los artefactos.

De forma predeterminada, cuando utiliza este comando, CLI de AWS SAM asume que su directorio de trabajo actual es el directorio raíz del proyecto. El AWS SAM CLI primero intenta localizar un archivo de plantilla creado con el compilación de sam comando, ubicado en el .aws-sam subcarpeta y se llama template.yaml. A continuación, la CLI de AWS SAM intenta localizar un archivo de plantilla llamado template.yaml o template.yml en el directorio de trabajo actual. Si especificas el --template opción, AWS SAM CLIse anula el comportamiento predeterminado y empaquetará precisamente eso AWS SAM la plantilla y los recursos locales a los que apunta.

nota

sam deploy ahora ejecuta implícitamente la funcionalidad del sam package. Puede utilizar el comando sam deploy directamente para empaquetar e implementar su aplicación.

importante

No corras sam package en código que no es de confianza. Carga los archivos y carpetas locales a los que hace referencia la plantilla, que pueden estar fuera del directorio del proyecto, en Amazon S3.

De uso

$ sam package <arguments> <options>

Argumentos

Resource ID (ID de recurso)

El ID de la función de eventos de Lambda que se va a empaquetar.

Este argumento es opcional. Si su aplicación contiene una sola función de Lambda, AWS SAM La CLI la empaquetará. Si la aplicación contiene varias funciones, proporciones el ID de la función para empaquetar una sola función.

Valores válidos: el identificador lógico o el ARN del recurso.

Opciones

--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 el mensaje de depuración que genera la CLI de AWS SAM y muestra las marcas temporales.

--force-upload

Anular los archivos existentes en el bucket de Amazon S3. Especificar este indicador para cargar artefactos incluso si coinciden con los artefactos existentes en el bucket de Amazon S3.

--help

Muestra este mensaje y sale.

--image-repository TEXT

La URI del repositorio Amazon Elastic Container Registry (Amazon ECR) donde este comando sube la imagen de la función. Necesario para las funciones declaradas con el tipo de paquete Image.

--kms-key-id TEXT

El ID de un AWS Key Management Service (AWS KMS) clave utilizada para cifrar los artefactos que están en reposo en el bucket de Amazon S3. Si no se especifica esta opción, entonces AWS SAM usa Amazon S3-managed claves de cifrado.

Para un AWS::Serverless::WebFunction, la clave debe ser una clave gestionada por el cliente cuya política de claves lo permita lambda.amazonaws.com para llamar kms:Decrypt. Si es un AWS clave gestionada, el comando falla.

--metadata

(Opcional) Un mapa de metadatos para adjuntarlo a todos los artefactos a los que se hace referencia en la plantilla.

--no-progressbar

No muestre una barra de progreso al cargar artefactos en Amazon S3.

--output-template-file PATH

La ruta al archivo donde el comando escribe la plantilla empaquetada. Si especificas una ruta, el comando escribe la plantilla en la salida estándar.

--profile TEXT

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

--region TEXT

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

--resolve-s3

Creación automática de un bucket de Amazon S3 para empaquetar. Si especificas las opciones --s3-bucket y --resolve-s3, entonces se producirá un error.

Esta opción no es compatible con una plantilla con AWS::Serverless::WebFunction que tiene código local. En su lugar, use sam deploy o sam deploy --s3-bucket. Para obtener más información, consulte Creación e implementación de funciones web de Lambda.

--s3-bucket TEXT

El nombre del bucket de Amazon S3 donde este comando carga el artefacto. Si el artefacto tiene más de 51 200 bytes, necesitará la opción --s3-bucket o --resolve-s3. Si especificas las opciones --s3-bucket y --resolve-s3, entonces se producirá un error.

Para un AWS::Serverless::WebFunction, el bucket debe tener habilitado el control de versiones y permitir que Lambda lea el código. Para obtener más información, consulte Creación e implementación de funciones web de Lambda.

--s3-prefix TEXT

Prefijo agregado al nombre de los artefactos que se cargan en el bucket de Amazon S3. El nombre del prefijo es un nombre de ruta (nombre de la carpeta) del bucket de Amazon S3. Esto solo se aplica a las funciones declaradas con el tipo de paquete Zip.

--save-params

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

--signing-profiles LIST

(Opcional) La lista de perfiles de firma con los que firmar los paquetes de implementación. Este parámetro toma una lista de pares clave-valor, donde la clave es el nombre de la función o capa que se va a firmar y el valor es el perfil de firma, con un propietario del perfil opcional delimitado con :. Por ejemplo, FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner.

--template-file, --template, -t PATH

La ruta y el nombre del archivo donde está AWS SAM se encuentra la plantilla.

nota

Si especifica esta opción, AWS SAM empaqueta solo la plantilla y los recursos locales a los que apunta.

--use-json

JSON de salida para CloudFormation plantilla. YAML se utiliza de forma predeterminada.

Ejemplo

El siguiente ejemplo crea y empaqueta artefactos para una función Lambda y CodeDeploy aplicaciones. Los artefactos se cargan en un bucket de Amazon S3. El resultado del comando es un nuevo archivo llamado package.yml.

$ sam package \ --template-file template.yml \ --output-template-file package.yml \ --s3-bucket amzn-s3-demo-bucket