sam package

L'interface de ligne de AWS Serverless Application Model commande (AWS SAM CLI) empaquette une AWS SAM application.

Cette commande crée un .zip fichier contenant votre code et 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 SAMCLI premier essaie de localiser un fichier modèle créé à l'aide de la sam build commande, situé dans le .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 l'--templateoption, AWS SAMCLI le comportement par défaut est remplacé et empaquetera uniquement ce AWS SAM modèle et les ressources locales vers lesquelles il pointe.

Note

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

Utilisation

$ sam package <arguments> <options>

Arguments

ID de ressource

ID de la fonction Lambda à empaqueter.

Cet argument est facultatif. Si votre application contient une seule fonction Lambda, la AWS SAM CLI l'empaquetera. 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'ID d'une clé AWS Key Management Service (AWS KMS) utilisée pour chiffrer les artefacts inactifs dans le compartiment Amazon S3. Si cette option n'est pas spécifiée, AWS SAM utilise les clés de chiffrement gérées par Amazon S3.

--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'informations d'identification qui obtient les AWS informations d'identification.

--region TEXT

La AWS région dans laquelle le déploiement doit être effectué. 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.

--s3-bucket TEXT

Le nom du compartiment Amazon S3 dans lequel cette commande télécharge votre artefact. Si votre artefact est supérieur à 51 200 octets, l'option --s3-bucket ou l'--resolve-s3option est requise. Si vous précisez les deux options --s3-bucket et --resolve-s3, alors une erreur se produira.

--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 le fichier AWS SAM 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 modèle.

Note

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

--use-json

Sortie JSON pour le AWS CloudFormation modèle. Par défaut, YAML est utilisé.