sam package

La interfaz de línea de AWS Serverless Application Model comandos (AWS SAM CLI) empaqueta una AWS SAM aplicación.

Este comando crea un .zip archivo con el código y las dependencias y lo carga en Amazon Simple Storage Service (Amazon S3). AWS SAM permite el cifrado de todos los archivos almacenados en Amazon S3. A continuación, devuelve una copia de la AWS SAM plantilla y reemplaza 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 se utiliza este comando, AWS SAM CLI asume que el directorio de trabajo actual es el directorio raíz del proyecto. El AWS SAM CLI primero intenta localizar un archivo de plantilla creado mediante el sam build comando, ubicado en la .aws-sam subcarpeta y denominadotemplate.yaml. A continuación, el AWS SAM CLI intenta localizar un archivo de plantilla llamado template.yaml o template.yml en el directorio de trabajo actual. Si especifica la --template opción, AWS SAM CLIse anula su comportamiento predeterminado y empaquetará solo esa AWS SAM 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.

Uso

$ sam package <arguments> <options>

Argumentos

ID de recurso

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

Este argumento es opcional. Si su aplicación contiene una sola función Lambda, la AWS SAM CLI 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 ID lógico o el recurso del recursoARN.

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 AWS SAM CLI Archivo de configuración de la de .

--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 AWS SAM CLI Archivo de configuración de la de .

--debug

Activa el registro de depuración para imprimir el mensaje de depuración generado por AWS SAM CLI y muestra las marcas de tiempo.

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

El repositorio URI de Amazon Elastic Container Registry (AmazonECR) en el que este comando carga la imagen de la función. Necesario para las funciones declaradas con el tipo de paquete Image.

--kms-key-id TEXT

El ID de una clave AWS Key Management Service (AWS KMS) que se utiliza para cifrar los artefactos que se encuentran en reposo en el bucket de Amazon S3. Si no se especifica esta opción, AWS SAM utiliza claves de cifrado gestionadas por Amazon S3.

--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 del archivo de credenciales que recibe las credenciales. AWS

--region TEXT

La AWS región en la que se va a 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.

--s3-bucket TEXT

El nombre del bucket de Amazon S3 donde este comando carga la plantilla de . Si la plantilla 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.

--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 proporcione en la línea de comandos en el archivo AWS SAM 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 se encuentra la AWS SAM plantilla.

nota

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

--use-json

Salida JSON para la AWS CloudFormation plantilla. YAML se utiliza de forma predeterminada.

Ejemplo

El siguiente ejemplo crea y empaqueta artefactos para una función y CodeDeploy aplicaciones de Lambda. 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