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.

Créez votre application dans AWS SAM

Après avoir terminé Getting started et luComment utiliser AWS Serverless Application Model (AWS SAM), vous serez prêt à créer un AWS SAM projet dans votre environnement de développement. Votre AWS SAM projet servira de point de départ pour l'écriture de votre application sans serveur. Pour obtenir la liste des options de AWS SAMCLI sam init commande, consultezsam init.

La AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI) sam init fournit des options permettant d'initialiser une nouvelle application sans serveur composée des éléments suivants :

Pour créer un AWS SAM projet, reportez-vous aux rubriques de ces sections.

Initialiser une nouvelle application sans serveur

Choisir un modèle de départ

Un modèle se compose des éléments suivants :

Vous pouvez choisir parmi une liste de modèles de démarrage rapide AWS disponibles ou fournir votre propre emplacement de modèle personnalisé.

Choisir une exécution

Lorsque vous choisissez un modèle de démarrage rapide AWS , la CLI  AWS SAM vous invite à sélectionner une exécution pour vos fonctions Lambda. La liste des options affichées par la CLI  AWS SAM correspond aux exécutions prises en charge nativement par Lambda.

Vous pouvez utiliser n'importe quel autre langage de programmation doté d'une exécution personnalisée. Pour ce faire, vous devez créer manuellement la structure de votre application de départ. Vous pouvez ensuite utiliser sam init pour initialiser rapidement votre application en configurant un emplacement de modèle personnalisé.

À partir de votre sélection, la CLI  AWS SAM crée le répertoire de départ pour votre code de fonction Lambda et vos dépendances.

Si Lambda prend en charge plusieurs gestionnaires de dépendances pour votre exécution, vous serez invité à choisir votre gestionnaire de dépendances préféré.

Choisir un type de package

Lorsque vous choisissez un modèle de démarrage rapide AWS , et une exécution laCLI  AWS SAM vous invite à sélectionner un type de package. Le type de package détermine la manière dont vos fonctions Lambda sont déployées pour être utilisées avec le service Lambda. Les deux types de packages pris en charge sont les suivants :

Pour en savoir plus sur le package de déploiement, consultez Packages de déploiement Lambda dans le Guide du développeur AWS Lambda .

Voici un exemple de structure de répertoires d'une application avec une fonction Lambda packagée sous forme d'image de conteneur. AWS SAMCLITélécharge l'image et en crée une Dockerfile dans le répertoire de la fonction pour spécifier l'image.

sam-app
├── README.md
├── __init__.py
├── events
│   └── event.json
├── hello_world
│   ├── Dockerfile
│   ├── __init__.py
│   ├── app.py
│   └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
    ├── __init__.py
    └── unit
        ├── __init__.py
        └── test_handler.py

Voici un exemple de structure de répertoires d'une application avec une fonction packagée sous forme d'archive de fichier .zip.

sam-app
├── README.md
├── __init__.py
├── events
│   └── event.json
├── hello_world
│   ├── __init__.py
│   ├── app.py
│   └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
    ├── __init__.py
    ├── integration
    │   ├── __init__.py
    │   └── test_api_gateway.py
    ├── requirements.txt
    └── unit
        ├── __init__.py
        └── test_handler.py

Configuration du AWS X-Ray suivi

Vous pouvez choisir d'activer le AWS X-Ray suivi. Pour en savoir plus, consultez Qu'est-ce que c'est AWS X-Ray ? dans le Guide AWS X-Ray du développeur.

Si vous l'activez, votre AWS SAM modèle AWS SAMCLI est configuré. Voici un exemple :

Globals:
  Function:
    ...
    Tracing: Active
  Api:
    TracingEnabled: True

Configurer la surveillance avec Amazon CloudWatch Application Insights

Vous pouvez choisir d'activer la surveillance à l'aide d'Amazon CloudWatch Application Insights. Pour en savoir plus, consultez Amazon CloudWatch Application Insights dans le guide de CloudWatch l'utilisateur Amazon.

Si vous l'activez, votre AWS SAM modèle AWS SAMCLI est configuré. Voici un exemple :

Resources:
  ApplicationResourceGroup:
    Type: AWS::ResourceGroups::Group
    Properties:
      Name:
        Fn::Join:
        - ''
        - - ApplicationInsights-SAM-
          - Ref: AWS::StackName
      ResourceQuery:
        Type: CLOUDFORMATION_STACK_1_0
  ApplicationInsightsMonitoring:
    Type: AWS::ApplicationInsights::Application
    Properties:
      ResourceGroupName:
        Fn::Join:
        - ''
        - - ApplicationInsights-SAM-
          - Ref: AWS::StackName
      AutoConfigurationEnabled: 'true'
    DependsOn: ApplicationResourceGroup

Nommer votre application

Saisissez un nom pour votre application. La CLI  AWS SAM crée un dossier de niveau supérieur pour votre application sous ce nom.

Options pour sam init

Voici quelques-unes des principales options que vous pouvez utiliser avec la commande sam init. Pour obtenir la liste de toutes les options, consultez sam init.

Initialiser une application à l'aide d'un emplacement de modèle personnalisé

Utilisez l'option --location et indiquez un emplacement de modèle personnalisé pris en charge. Voici un exemple :

$ sam init --location https://github.com/aws-samples/sessions-with-aws-sam/raw/master/starter-templates/web-app.zip

Initialiser une application sans le flux interactif

Utilisez l'option --no-interactive et indiquez vos choix de configuration sur la ligne de commande pour ignorer le flux interactif. Voici un exemple :

$ sam init --no-interactive --runtime go1.x --name go-demo --dependency-manager mod --app-template hello-world

Résolution des problèmes

Pour résoudre le problème AWS SAMCLI, voirRésolution des problèmes de la CLI AWS SAM.

Exemples

Initialisation d'une nouvelle application sans serveur à l'aide du modèle de démarrage Hello World AWS

Pour cet exemple, consultez Étape 1 : initialisation de l'exemple d'application Hello World dans le didacticiel : déploiement de l'application Hello World.

Initialiser une nouvelle application sans serveur avec un emplacement de modèle personnalisé

Vous trouverez ci-dessous des exemples d'ajout d'un emplacement GitHub à votre modèle personnalisé :

$ sam init --location gh:aws-samples/cookiecutter-aws-sam-python
$ sam init --location git+sh://git@github.com/aws-samples/cookiecutter-aws-sam-python.git
$ sam init --location hg+ssh://hg@bitbucket.org/repo/template-name

Voici un exemple de chemin d'accès à un fichier local :

$ sam init --location /path/to/template.zip

Voici un exemple de chemin accessible par HTTPS :

$ sam init --location https://github.com/aws-samples/sessions-with-aws-sam/raw/master/starter-templates/web-app.zip

En savoir plus

Pour en savoir plus sur l'utilisation de la commande sam init, reportez-vous à ce qui suit :

Étapes suivantes

Maintenant que vous avez créé votre AWS SAM projet, vous êtes prêt à commencer à créer votre application. Consultez Définissez votre infrastructure avec AWS SAM les instructions détaillées sur les tâches que vous devez effectuer pour ce faire.