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.

# AWS SAM CLI
<a name="using-sam-cli"></a>

AWS Serverless Application Model L'interface de ligne de commande (AWS SAMCLI) est un outil de ligne de commande pour le développement local et le test d'applications sans serveur. Vous AWS SAMCLI permet de créer, de transformer, de déployer, de déboguer, d'empaqueter, d'initialiser et de synchroniser vos applications sans serveur localement avant de les déployer dans le cloud.

AWS SAMCLIfonctionne avec des applications sans serveur définies à l'aide de différents frameworks et outils d'infrastructure en tant que code (IaC), avec différents niveaux de support :
+ **AWS SAM modèles** : fournit un support natif avec l'ensemble complet des fonctionnalités, y compris les fonctionnalités de test local, de débogage, d'empaquetage et de déploiement.
+ **AWS Applications CDK** : prend en charge le test local des fonctions Lambda une fois que vous avez synthétisé l'application CDK en modèles CloudFormation à AWS l'aide de la commande cdk synth.
+ **CloudFormation modèles** : offre une compatibilité directe car elle AWS SAM s'étend CloudFormation et prend en charge les ressources sans serveur définies dans les CloudFormation modèles standard.
+ **Applications Terraform** — Fournit un support limité pour la création et les tests locaux de fonctions Lambda. Vous oblige à générer des artefacts de AWS SAM modèle qui représentent vos fonctions Lambda définies par Terraform.

Pour bénéficier d'une prise en charge complète des fonctionnalités et d'une expérience de développement rationalisée, nous vous recommandons d'utiliser des AWS SAM modèles natifs.

**Topics**
+ [Comment les commandes de la CLI  AWS SAM sont documentées](#using-sam-cli-documentation)
+ [Configuration de la CLI  AWS SAM](using-sam-cli-configure.md)
+ [AWS SAMCLIcommandes de base](using-sam-cli-corecommands.md)
+ [Tests locaux avec AWS SAMCLI](using-sam-cli-local-testing.md)

## Comment les commandes de la CLI  AWS SAM sont documentées
<a name="using-sam-cli-documentation"></a>

Les commandes de la CLI AWS SAM sont documentées en utilisant le format suivant :
+ **Invite** : l'invite Linux est documentée par défaut et s'affiche sous la forme (`$ `). Pour les commandes spécifiques à Windows, (`> `) est utilisé comme invite. N’incluez pas le symbole d’invite lorsque vous saisissez des commandes.
+ **Répertoire** : lorsque des commandes doivent être saisies depuis un répertoire spécifique, le nom de répertoire s’affiche sous le symbole d’invite.
+ **Entrée utilisateur** : le texte de commande que vous saisissez en ligne de commande est indiqué sous la forme **user input**.
+ **Texte remplaçable : le texte** variable, tel que les noms de fichiers et les paramètres, est formaté comme suit. *replaceable text* Dans les commandes sur plusieurs lignes ou les commandes dans lesquelles une saisie clavier spécifique est nécessaire, les commandes clavier peuvent également être indiquées sous la forme de texte remplaçable. Par exemple, *ENTER*.
+ **Sortie** : la sortie renvoyée en réponse à la commande est indiquée sous la forme `computer output`.

Voici un exemple de sortie de la commande `sam deploy` et de la sortie :

```
$ sam deploy --guided --template template.yaml

Configuring SAM deploy
======================

    Looking for config file [samconfig.toml] :  Found
    Reading default arguments  :  Success

    Setting default arguments for 'sam deploy'
    =========================================
    Stack Name [sam-app]: ENTER
    AWS Region [us-west-2]: ENTER
    #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
    Confirm changes before deploy [y/N]: ENTER
    #SAM needs permission to be able to create roles to connect to the resources in your template
    Allow SAM CLI IAM role creation [Y/n]: ENTER
    #Preserves the state of previously provisioned resources when an operation fails
    Disable rollback [y/N]: ENTER
    HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
    Save arguments to configuration file [Y/n]: ENTER
    SAM configuration file [samconfig.toml]: ENTER
    SAM configuration environment [default]: ENTER
```

1. `sam deploy --guided --template template.yaml` est la commande que vous saisissez dans la ligne de commande.

1. **sam deploy --guided --template** doit être fourni tel quel.

1. *template.yaml*peut être remplacé par votre nom de fichier spécifique.

1. La sortie commence à `Configuring SAM deploy`.

1. Dans la sortie, *ENTER* et *y* indiquez les valeurs remplaçables que vous fournissez.