View a markdown version of this page

package sam - AWS Serverless Application Model

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

package sam

Le AWS Serverless Application Model Interface de ligne de commande (AWS SAM CLIa) emballages et AWS SAM candidature.

Cette commande crée un .zip fichier de votre code et de vos dépendances, et télécharge le fichier sur Amazon Simple Storage Service (Amazon S3). AWS SAM active le chiffrement de tous les fichiers stockés dans Amazon S3. Il renvoie ensuite une copie de votre AWS SAM modèle, en remplaçant les références aux artefacts locaux par l'emplacement Amazon S3 où la commande a chargé les artefacts.

Par défaut, lorsque vous utilisez cette commande, la CLI  AWS SAM suppose que le répertoire de travail actuel est le répertoire racine du projet. Le AWS SAM CLI essaie d'abord de localiser un fichier modèle créé à l'aide du création sam commande, située dans .aws-sam sous-dossier, et nommé template.yaml. Ensuite, la CLI  AWS SAM tente de localiser un fichier modèle nommé template.yaml ou template.yml dans le répertoire de travail actuel. Si vous spécifiez --template option, AWS SAM CLIle comportement par défaut est remplacé, et c'est exactement ce que vous allez empaqueter AWS SAM modèle et les ressources locales vers lesquelles il pointe.

Note

déploiement sam exécute maintenant implicitement la fonctionnalité de sam package. Vous pouvez utiliser la commande déploiement sam directement pour empaqueter et déployer l’application.

Important

Ne courez pas sam package sur un code non fiable. Il télécharge les fichiers et dossiers locaux auxquels le modèle fait référence, qui peuvent se trouver en dehors du répertoire du projet, sur Amazon S3.

Usage

$ sam package <arguments> <options>

Arguments

ID de ressource

ID de la fonction événementielle Lambda à empaqueter.

Cet argument est facultatif. Si votre application contient une seule fonction Lambda, AWS SAM La CLI va l'empaqueter. Si votre application contient plusieurs fonctions, indiquez l'ID de la fonction pour empaqueter une seule fonction.

Valeurs valides : ID logique ou ARN de la ressource.

Options

--config-env TEXT

Le nom d’environnement spécifiant les valeurs de paramètre par défaut dans le fichier de configuration à utiliser. La valeur par défaut est « par défaut ». Pour plus d'informations sur les fichiers de configuration, consultez Fichier de configuration CLI AWS SAM.

--config-file PATH

Le chemin d'accès et le nom du fichier de configuration contenant les valeurs de paramètres par défaut à utiliser. La valeur par défaut est « samconfig.toml » dans la racine du répertoire du projet. Pour plus d'informations sur les fichiers de configuration, consultez Fichier de configuration CLI AWS SAM.

--debug

Active la journalisation de débogage pour imprimer le message de débogage généré par la CLI  AWS SAM et pour afficher les horodatages.

--force-upload

Remplacer les fichiers existants dans le compartiment Amazon S3. Spécifiez cet indicateur pour télécharger des artefacts, même s’ils correspondent à des artefacts existants dans le compartiment Amazon S3.

--help

Affiche ce message, puis se ferme.

--image-repository TEXT

L’URI du référentiel Amazon Elastic Container Registry (Amazon ECR) vers lequel cette commande télécharge l’image de la fonction. Requis pour les fonctions déclarées avec le type de package Image.

--kms-key-id TEXT

L'identifiant d'un AWS Key Management Service (AWS KMS) clé utilisée pour chiffrer les artefacts qui sont au repos dans le compartiment Amazon S3. Si cette option n'est pas spécifiée, AWS SAM utilise Amazon S3-managed clés de chiffrement.

Pour un AWS::Serverless::WebFunction, la clé doit être une clé gérée par le client dont la politique de clé permet lambda.amazonaws.com appeler kms:Decrypt. S'il s'agit d'un AWS clé gérée, la commande échoue.

--metadata

(Facultatif) Une carte de métadonnées à attacher à tous les artefacts référencés dans le modèle.

--no-progressbar

N’affichez pas de barre de progression lors du téléchargement d’artefacts sur Amazon S3.

--output-template-file PATH

Chemin d’accès au fichier dans lequel la commande écrit le modèle empaqueté. Si vous ne spécifiez pas de chemin d’accès, la commande écrit le modèle dans la sortie standard.

--profile TEXT

Le profil spécifique de votre fichier d'identification qui obtient AWS informations d'identification.

--region TEXT

Le AWS Région dans laquelle déployer. Par exemple, us-east-1.

--resolve-s3

Créez automatiquement un compartiment Amazon S3 à utiliser pour l’empaquetage. Si vous précisez les deux options --s3-bucket et --resolve-s3, alors une erreur se produira.

Cette option n'est pas prise en charge pour un modèle doté d'un AWS::Serverless::WebFunction qui possède un code local. Utilisez sam deploy ou sam deploy --s3-bucket à la place. Pour plus d’informations, consultez Création et déploiement de fonctions Web Lambda.

--s3-bucket TEXT

Nom du compartiment Amazon S3 dans lequel cette commande télécharge votre artefact. Si la taille de votre artefact est supérieure à 51 200 octets, soit le --s3-bucket ou le --resolve-s3 l'option est requise. Si vous spécifiez les deux options --s3-bucket et --resolve-s3, une erreur se produit.

Pour un AWS::Serverless::WebFunction, le contrôle de version du bucket doit être activé et permettre à Lambda de lire le code. Pour plus d’informations, consultez Création et déploiement de fonctions Web Lambda.

--s3-prefix TEXT

Le préfixe ajouté aux noms des artefacts téléchargés vers le compartiment Amazon S3. Le nom du préfixe est un nom de chemin d’accès (nom de dossier) pour le compartiment Amazon S3. Cela s’applique uniquement aux fonctions déclarées avec le type de package Zip.

--save-params

Enregistrez les paramètres que vous fournissez sur la ligne de commande dans AWS SAM fichier de configuration.

--signing-profiles LIST

(Facultatif) La liste des profils de signature pour signer les packages de déploiement. Ce paramètre prend une liste de paires valeur clé, où la clé est le nom de la fonction ou de la couche à signer et la valeur est le profil de signature, avec un propriétaire de profil facultatif délimité par :. Par exemple : FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner.

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

Le chemin et le nom du fichier où se trouve votre AWS SAM le modèle est situé.

Note

Si vous spécifiez cette option, AWS SAM regroupe uniquement le modèle et les ressources locales vers lesquelles il pointe.

--use-json

JSON de sortie pour CloudFormation modèle. Par défaut, YAML est utilisé.

Exemple

L'exemple suivant crée et empaquette des artefacts pour une fonction Lambda et CodeDeploy candidatures. Les artefacts sont chargés dans un compartiment Amazon S3. La sortie de la commande est un nouveau fichier nommé package.yml.

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