

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 première application avec Infrastructure Composer
<a name="getting-started-build"></a>

Dans ce didacticiel, vous allez AWS Infrastructure Composer créer une application sans serveur de création, de lecture, de mise à jour et de suppression (CRUD) qui gère les utilisateurs d'une base de données.

Pour ce didacticiel, nous utilisons Infrastructure Composer dans le AWS Management Console. Nous vous recommandons d'utiliser Google Chrome ouMicrosoft Edge, et une fenêtre de navigateur en plein écran.

**Êtes-vous novice dans le domaine du sans serveur ?**  
Nous vous recommandons d'avoir des connaissances de base sur les points suivants :  
[Architecture basée sur les événements](what-is-concepts.md#what-is-concepts-terms-eda)
[Infrastructure en tant que code (IaC)](what-is-concepts.md#what-is-concepts-terms-iac)
[Technologies sans serveur](what-is-concepts.md#what-is-concepts-terms-serverless)
Pour en savoir plus, veuillez consulter la section [Concepts sans serveur pour AWS Infrastructure Composer](what-is-concepts.md).

**Topics**
+ [Référence des propriétés des ressources](#getting-started-build-reference)
+ [Étape 1 : Créez votre projet](#getting-started-build-start)
+ [Étape 2 : ajouter des cartes au canevas](#getting-started-build-rest-cards)
+ [Étape 3 : Configuration de votre API REST API Gateway](#getting-started-build-rest)
+ [Étape 4 : Configuration de vos fonctions Lambda](#getting-started-build-functions)
+ [Étape 5 : Connectez vos cartes](#getting-started-build-connect)
+ [Étape 6 : Organiser le canevas](#getting-started-build-organize)
+ [Étape 7 : Ajouter et connecter une table DynamoDB](#getting-started-build-table)
+ [Étape 8 : passez en revue votre AWS CloudFormation modèle](#getting-started-build-template)
+ [Étape 9 : Intégrez à vos flux de travail de développement](#getting-started-build-integrate)
+ [Étapes suivantes](#getting-started-build-next)

## Référence des propriétés des ressources
<a name="getting-started-build-reference"></a>

Lors de la création de votre application, utilisez ce tableau comme référence pour configurer les propriétés de votre Amazon API Gateway et de vos AWS Lambda ressources.


| Method | Chemin | Nom de la fonction | 
| --- | --- | --- | 
|  GET  |  /objets  |  Obtenir des objets  | 
|  GET  |  /articles/ \$1id\$1  |  getItem  | 
|  PUT  |  /articles/ \$1id\$1  |  Mettre à jour l'article  | 
|  POST  |  /article  |  Ajouter un article  | 
|  DELETE  |  /articles/ \$1id\$1  |  deleteItem  | 

## Étape 1 : Créez votre projet
<a name="getting-started-build-start"></a>

Pour commencer à utiliser votre application sans serveur CRUD, créez un nouveau projet dans Infrastructure Composer et activez la synchronisation **locale**.

**Pour créer un nouveau projet vierge**

1. Connectez-vous à la [console Infrastructure Composer](https://console.aws.amazon.com/composer/home).

1. Sur la page d'**accueil**, choisissez **Créer un projet**.

Comme le montre l'image suivante, Infrastructure Composer ouvre le canevas visuel et charge un modèle d'application de départ (vide).

![\[Compositeur d'infrastructure avec un canevas visuel vierge.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_01.png)


**Pour activer la synchronisation locale**

1. Dans le **menu** Infrastructure Composer, sélectionnez **Enregistrer** > **Activer la synchronisation locale**.  
![\[Un menu Infrastructure Composer avec Activate local sync sélectionné.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_09.png)

1. Pour l'**emplacement du projet**, appuyez sur **Sélectionner un dossier** et choisissez un répertoire. C'est ici qu'Infrastructure Composer enregistrera et synchronisera vos fichiers modèles et dossiers au fur et à mesure de votre conception. 

   L'emplacement du projet ne doit pas contenir de modèle de candidature existant.
**Note**  
La **synchronisation locale** nécessite un navigateur compatible avec l'API d'accès au système de fichiers. Pour de plus amples informations, veuillez consulter [Data Infrastructure Composer a accès à](reference-fsa.md#reference-fsa-access).

1. Lorsque vous êtes invité à autoriser l'accès, sélectionnez **Afficher les fichiers**.

1. Appuyez sur **Activer pour activer** la **synchronisation locale**. Lorsque vous êtes invité à enregistrer les modifications, sélectionnez **Enregistrer les modifications**.

   Lorsqu'il est activé, l'indicateur de **sauvegarde automatique** s'affiche dans le coin supérieur gauche de votre canevas.

## Étape 2 : ajouter des cartes au canevas
<a name="getting-started-build-rest-cards"></a>

Commencez à concevoir l'architecture de votre application à l'aide de cartes de composants améliorées, en commençant par une API REST API Gateway et cinq fonctions Lambda.

**Pour ajouter des cartes API Gateway et Lambda au canevas**

Dans la palette **Ressources**, sous la section **Composants améliorés**, procédez comme suit :

1. Faites glisser une carte **API Gateway** sur le canevas.

1. Faites glisser une carte de **fonction Lambda** sur le canevas. Répétez l'opération jusqu'à ce que vous ayez ajouté cinq cartes de **fonctions Lambda** au canevas.

![\[Une vue en canevas d'Infrastructure Composer avec une API Gateway et cinq cartes de fonctions Lambda.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_02.png)


## Étape 3 : Configuration de votre API REST API Gateway
<a name="getting-started-build-rest"></a>

Ajoutez ensuite cinq routes dans votre carte API Gateway.

**Pour ajouter des itinéraires à la carte API Gateway**

1. Ouvrez le panneau **des propriétés des ressources** de la carte **API Gateway**. Pour ouvrir le panneau, double-cliquez sur la carte. Vous pouvez également sélectionner la carte, puis cliquez **sur Détails**.

1. Dans le panneau **des propriétés des ressources**, sous **Routes**, procédez comme suit :
**Note**  
Pour chacune des routes suivantes, utilisez la méthode HTTP et les valeurs de chemin spécifiées dans le [tableau de référence des propriétés des ressources](#getting-started-build-reference).

   1. Pour **Méthode**, choisissez la méthode HTTP spécifiée. Par exemple, **GET**.

   1. Pour **Chemin**, entrez le chemin spécifié. Par exemple, **/items**.

   1. Choisissez **Ajouter une route**.

   1. Répétez les étapes précédentes jusqu'à ce que vous ayez ajouté les cinq itinéraires spécifiés.

1. Choisissez **Enregistrer**.

![\[Le canevas visuel Infrastructure Composer avec une ressource API Gateway avec cinq itinéraires. Le Resource properties panneau affiche les sélections pour la méthode, le chemin et l'ajout d'un itinéraire.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_03.png)


## Étape 4 : Configuration de vos fonctions Lambda
<a name="getting-started-build-functions"></a>

Nommez chacune des cinq fonctions Lambda comme indiqué dans le tableau de [référence des propriétés des ressources](#getting-started-build-reference).

**Pour nommer les fonctions Lambda**

1. Ouvrez le panneau **des propriétés des ressources** d'une carte de **fonction Lambda.** Pour ouvrir le panneau, double-cliquez sur la carte. Vous pouvez également sélectionner la carte, puis cliquez **sur Détails**.

1. Dans le panneau **des propriétés de la ressource**, pour **Logical ID**, entrez un nom de fonction spécifié. Par exemple, **getItems**.

1. Choisissez **Enregistrer**.

1. Répétez les étapes précédentes jusqu'à ce que vous ayez nommé les cinq fonctions.

![\[Le canevas visuel du compositeur d'infrastructure avec cinq cartes de ressources nommées Lambda Function.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_04.png)


## Étape 5 : Connectez vos cartes
<a name="getting-started-build-connect"></a>

Connectez chaque route de votre carte **API Gateway** à la carte de **fonction Lambda correspondante**, comme indiqué dans le tableau de [référence des propriétés des ressources](#getting-started-build-reference).

**Pour connecter vos cartes**

1. Cliquez sur un port droit sur la carte **API Gateway** et faites-le glisser vers le port gauche de la carte de **fonction Lambda** spécifiée. Par exemple, cliquez sur le port **GET /items** et faites-le glisser vers le port gauche de **GetItems**.

1. Répétez l'étape précédente jusqu'à ce que vous ayez connecté les cinq routes de la carte **API Gateway** aux cartes **Lambda Function** correspondantes.

![\[Le canevas visuel d'Infrastructure Composer avec l'API REST connectée à cinq fonctions Lambda.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_05.png)


## Étape 6 : Organiser le canevas
<a name="getting-started-build-organize"></a>

Organisez le canevas visuel en regroupant vos fonctions Lambda et en organisant toutes les cartes.

**Pour regrouper vos fonctions**

1. Maintenez la touche **Shift** enfoncée, puis sélectionnez chaque carte de **fonction Lambda** sur le canevas.

1. Choisissez **le groupe**.

**Pour donner un nom à votre groupe**

1. Double-cliquez en haut du groupe, près du nom du groupe (**Groupe**).

   Le panneau **des propriétés du groupe** s'ouvre.

1. Dans le panneau **Propriétés du groupe**, dans **Nom du groupe**, entrez**API**.

1. Choisissez **Enregistrer**.

**Pour organiser vos cartes**

Sur le canevas, au-dessus de la zone d'affichage principale, choisissez **Arrangement**.

Infrastructure Composer organise et aligne toutes les cartes sur le canevas visuel, y compris votre nouveau groupe (**API**), comme indiqué ici :

![\[Le canevas visuel du compositeur d'infrastructure est organisé avec toutes les fonctions Lambda regroupées.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_06.png)


## Étape 7 : Ajouter et connecter une table DynamoDB
<a name="getting-started-build-table"></a>

Ajoutez maintenant une table DynamoDB à l'architecture de votre application et connectez-la à vos fonctions Lambda.

**Pour ajouter et connecter une table DynamoDB**

1. Dans la palette de **ressources (Ressources**), sous la section **Composants améliorés**, faites glisser une carte **DynamoDB** Table sur le canevas.

1. **Cliquez sur le port droit d'une carte de **fonction Lambda** et faites-le glisser vers le port gauche de la carte DynamoDB Table.**

1. **Répétez l'étape précédente jusqu'à ce que vous ayez connecté les cinq cartes **Lambda Function** à la carte DynamoDB Table.**

1. **(Facultatif) Pour réorganiser et réaligner les cartes sur le canevas, choisissez Arrangement.**

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_07.png)


## Étape 8 : passez en revue votre AWS CloudFormation modèle
<a name="getting-started-build-template"></a>

Félicitations \$1 Vous avez conçu avec succès une application sans serveur prête à être déployée. Enfin, choisissez **Modèle** pour consulter le AWS CloudFormation modèle qu'Infrastructure Composer a automatiquement généré pour vous.

Dans le modèle, Infrastructure Composer a défini les éléments suivants :
+ La `Transform` déclaration, qui spécifie le modèle en tant que modèle AWS Serverless Application Model (AWS SAM). Pour plus d'informations, consultez [l'anatomie du AWS SAM modèle](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-specification-template-anatomy.html) dans le *guide du AWS Serverless Application Model développeur*.
+ Une `AWS::Serverless::Api` ressource qui spécifie votre API REST API Gateway avec ses cinq routes.
+ Cinq `AWS::Serverless::Function` ressources, qui spécifient les configurations de vos fonctions Lambda, y compris leurs variables d'environnement et leurs politiques d'autorisation.
+ Une `AWS::DynamoDB::Table` ressource qui spécifie votre table DynamoDB et ses propriétés.
+ La `Metadata` section, qui contient des informations sur votre groupe de ressources (**API**). Pour plus d'informations sur cette section, consultez la section [Métadonnées](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/metadata-section-structure.html) dans le *guide de AWS CloudFormation l'utilisateur*.

![\[La vue du modèle Infrastructure Composer affichant le code du modèle de l'application.\]](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_t2_08.png)


## Étape 9 : Intégrez à vos flux de travail de développement
<a name="getting-started-build-integrate"></a>

Utilisez le fichier modèle et les répertoires de projet créés par Infrastructure Composer pour des tests et des déploiements plus approfondis.
+ Grâce à la **synchronisation locale**, vous pouvez connecter Infrastructure Composer à l'IDE de votre machine locale pour accélérer le développement. Pour en savoir plus, veuillez consulter la section [Connectez la console Infrastructure Composer à votre IDE local](other-services-ide.md).
+ Avec la **synchronisation locale**, vous pouvez utiliser l'interface de ligne de AWS Serverless Application Model commande (AWS SAM CLI) de votre machine locale pour tester et déployer votre application. Pour en savoir plus, veuillez consulter la section [Déployez votre application sans serveur Infrastructure Composer dans le cloud AWS](other-services-cfn.md).

## Étapes suivantes
<a name="getting-started-build-next"></a>

Vous êtes maintenant prêt à créer vos propres applications avec Infrastructure Composer. Pour plus de détails sur l'utilisation d'Infrastructure Composer, reportez-vous à[Comment composer AWS Infrastructure Composer](using-composer-basics.md). Lorsque vous êtes prêt à déployer votre application, reportez-vous à[Déployez votre application sans serveur Infrastructure Composer dans le cloud AWS](other-services-cfn.md).