sam build

Facultatif. Indique AWS SAM de créer une seule ressource déclarée dans un AWS SAM modèle. Les artefacts de création pour la ressource spécifiée sont les seuls disponibles pour les commandes suivantes du flux de travail ; c’est-à-dire sam package et sam deploy.

Résout les chemins relatifs au code source de la fonction ou de la couche par rapport à ce répertoire. Utilisez cette option si vous souhaitez modifier la façon dont les chemins d’accès relatifs aux dossiers de code source sont résolus. Par défaut, les chemins relatifs sont résolus selon l’emplacement du modèle AWS SAM .

Outre les ressources de l’application racine ou de la pile que vous créez, cette option applique également des applications ou des piles imbriquées.

Cette option s’applique aux types de ressources et propriétés suivants :

Autorisez ou refusez les fonctionnalités bêta.

Le chemin d’accès à un répertoire dans lequel les artefacts créés sont stockés. Ce répertoire et tout son contenu sont supprimés avec cette option.

L’URI de l’image de conteneur que vous souhaitez extraire pour la création. Par défaut, AWS SAM extrait l’image de conteneur depuis Amazon ECR Public. Utilisez cette option pour extraire l’image à partir d’un autre emplacement.

Vous pouvez spécifier cette option plusieurs fois. Chaque instance de cette option peut prendre une chaîne ou une paire valeur clé. Si vous spécifiez une chaîne, il s’agit de l’URI de l’image de conteneur à utiliser pour toutes les ressources de l’application. Par exemple, sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8. Si vous spécifiez une paire valeur clé, la clé est le nom de la ressource et la valeur est l’URI de l’image de conteneur à utiliser pour cette ressource. Par exemple sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8. Avec les paires valeur clé, vous pouvez spécifier différentes images de conteneur pour différentes ressources.

Cette option ne s'applique que si l'option --use-container est spécifiée, dans le cas contraire, une erreur se produit.

Procurez-vous --build-in-source pour créer votre projet directement dans le dossier source.

L'option --build-in-source prend en charge les systèmes d’exécution ainsi que les méthodes de création suivantes :

L'option --build-in-source n'est pas compatible avec celles suivantes :

Par défaut : --no-build-in-source

Activez ou désactivez les créations mises en cache. Utilisez cette option pour réutiliser les artefacts de build qui n'ont pas changé par rapport aux versions précédentes. AWS SAM évalue si vous avez modifié des fichiers dans le répertoire de votre projet. Par défaut, les créations ne sont pas mises en cache. Si l'--no-cachedoption est invoquée, elle remplace le cached = true paramètre défini dans samconfig.toml.

Le répertoire dans lequel les artefacts mis en cache sont stockés lorsque --cached est spécifié. Le répertoire mis en caché par défaut est .aws-sam/cache.

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 AWS SAM CLI Fichier de configuration  .

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 AWS SAM CLI Fichier de configuration  .

Variables d’environnement à transmettre au conteneur de création. Vous pouvez spécifier cette option plusieurs fois. Chaque instance de cette option prend une paire clé-valeur, où la clé est la variable de ressource et d’environnement et la valeur est la valeur de la variable d’environnement. Par exemple : --container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2.

Cette option ne s’applique que si l’option --use-container est spécifiée, dans le cas contraire, une erreur se produit.

Le chemin d’accès et le nom d’un fichier JSON contenant les valeurs des variables d’environnement de conteneur. Pour plus d’informations sur les fichier des variables d’environnement de conteneur, consultez Fichier de variables d'environnement du conteneur..

Cette option ne s'applique que si l'option --use-container est spécifiée, dans le cas contraire, une erreur se produit.

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

Spécifie le nom ou l’identifiant d’un réseau Docker existant auquel les conteneurs Docker Lambda doivent se connecter, avec le réseau de pont par défaut. Si cela n’est pas spécifié, les conteneurs Lambda se connectent uniquement au réseau Docker de pont par défaut.

Le nom de la ou des ressource(s) à exclure de sam build. Par exemple, si votre modèle contient Function1, Function2 et Function3 et vous exécutez sam build --exclude Function2, uniquement Function1 et Function3 seront créés.

Affiche ce message, puis se ferme.

Nom du hook utilisé pour étendre la fonctionnalité de la CLI  AWS SAM.

Valeurs acceptées : terraform.

Le chemin d’accès à un fichier manifeste de dépendance personnalisé (par exemple, package.json) à utiliser à la place du fichier par défaut.

Garantit le AWS SAMCLI montage permanent des liens symboliques présents dans les fichiers à créer ou à invoquer. Cela s'applique uniquement aux liens symboliques du répertoire de niveau supérieur (c'est-à-dire aux liens symboliques situés directement à la racine de la fonction). Par défaut, les liens symboliques ne sont pas montés, à l'exception de ceux nécessaires pour être utilisés node_modules dans build-in-source NodeJS.

Option qui vous permet d'utiliser le kit d'outils IDE pour définir le comportement par défaut. Vous pouvez également l'utiliser sam build --no-use-container pour exécuter un build sur votre machine locale au lieu d'un conteneur docker.

Active les builds parallèles. Utilisez cette option pour créer les fonctions et les couches de votre AWS SAM modèle en parallèle. Par défaut, les fonctions et les couches sont créées en séquence.

(Facultatif) Chaîne contenant des remplacements de AWS CloudFormation paramètres codés sous forme de paires clé-valeur. Utilise le même format que le AWS Command Line Interface (AWS CLI). Par exemple : « ParameterKey=KeyPairName, ParameterValue=MyKey ParameterKey=InstanceType, ParameterValue=t1.micro ». Cette option n'est pas compatible avec --hook-name.

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

Le Région AWS vers lequel déployer. Par exemple, us-east-1.

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

Ignore l'étape de préparation si aucune modification d'infrastructure n'a été apportée. À utiliser avec l'option --hook-name.

Spécifie si la commande doit ignorer la dernière image Docker pour l’exécution Lambda.

Le chemin et le nom du fichier AWS SAM modèle[default: template.[yaml|yml]]. Cette option n'est pas compatible avec --hook-name.

Le chemin relatif ou absolu vers le répertoire de premier niveau contenant vos fichiers de configuration Terraform ou le code source de vos fonctions. Si ces fichiers se trouvent en dehors du répertoire contenant votre module racine Terraform, utilisez cette option pour spécifier son chemin absolu ou relatif. Cette option nécessite que --hook-name soit défini sur terraform.

Si les fonctions dépendent de packages avec des dépendances compilées nativement, utilisez cette option pour créer la fonction dans un conteneur Docker de type Lambda.