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.
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.
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-envTEXT-
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-filePATH-
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-repositoryTEXT-
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-idTEXT-
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é permetlambda.amazonaws.comappelerkms: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-filePATH-
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.
--profileTEXT-
Le profil spécifique de votre fichier d'identification qui obtient AWS informations d'identification.
--regionTEXT-
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-bucketet--resolve-s3, alors une erreur se produira.Cette option n'est pas prise en charge pour un modèle doté d'un
AWS::Serverless::WebFunctionqui possède un code local. Utilisezsam deployousam deploy --s3-bucketà la place. Pour plus d’informations, consultez Création et déploiement de fonctions Web Lambda. --s3-bucketTEXT-
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-bucketou le--resolve-s3l'option est requise. Si vous spécifiez les deux options--s3-bucketet--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-prefixTEXT-
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-profilesLIST-
(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, -tPATH-
Le chemin et le nom du fichier où se trouve votre AWS SAM le modèle est situé.
NoteSi 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-bucketamzn-s3-demo-bucket