AWS App Runner ne sera plus ouvert aux nouveaux clients à compter du 30 avril 2026. Si vous souhaitez utiliser App Runner, inscrivez-vous avant cette date. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez [AWS App Runner la section Modification de la disponibilité](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
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.
# Commencer à utiliser App Runner
AWS App Runner est un AWS service qui fournit un moyen rapide, simple et économique de transformer une image de conteneur ou un code source existant directement en un service Web actif dans le AWS Cloud.
Ce didacticiel explique comment AWS App Runner déployer votre application sur un service App Runner. Il explique comment configurer le code source et le déploiement, le build du service et le runtime du service. Il montre également comment déployer une version de code, apporter une modification de configuration et consulter les journaux. Enfin, le didacticiel montre comment nettoyer les ressources que vous avez créées en suivant les procédures du didacticiel.
**Topics**
+ [Conditions préalables](#getting-started.prereq)
+ [Étape 1 : créer un service App Runner](#getting-started.create)
+ [Étape 2 : modifiez votre code de service](#getting-started.deploy)
+ [Étape 3 : effectuer une modification de configuration](#getting-started.config)
+ [Étape 4 : Afficher les journaux de votre service](#getting-started.logs)
+ [Étape 5 : nettoyer](#getting-started.cleanup)
+ [Quelle est la prochaine étape](#getting-started.next)
## Conditions préalables
Avant de commencer le didacticiel, veillez à effectuer les actions suivantes :
1. Effectuez les étapes de configuration dans[Configuration d'App Runner](setting-up.md).
1.
Décidez si vous souhaitez travailler avec un GitHub dépôt ou un dépôt Bitbucket.
+ Pour travailler avec un Bitbucket, créez d'abord un compte [Bitbucket](https://bitbucket.org/), si vous n'en avez pas déjà un. Si vous utilisez Bitbucket pour la première fois, consultez [Getting started with Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/get-started-with-bitbucket-cloud/) dans la documentation de *Bitbucket Cloud*.
+ Pour travailler avec GitHub, créez un [GitHub](https://github.com/)compte, si vous n'en avez pas déjà un. Si vous êtes nouveau GitHub dans ce domaine GitHub, consultez la section [Getting started with](https://docs.github.com/en/github/getting-started-with-github) the *GitHubDocs*.
**Note**
Vous pouvez créer des connexions à plusieurs fournisseurs de référentiels à partir de votre compte. Donc, si vous souhaitez effectuer un déploiement à la fois à partir d'un dépôt Bitbucket GitHub et d'un dépôt Bitbucket, vous pouvez répéter cette procédure. La prochaine fois, créez un nouveau service App Runner et créez une nouvelle connexion de compte pour l'autre fournisseur de référentiel.
1. Créez un référentiel dans votre compte fournisseur de référentiel. Ce didacticiel utilise le nom du dépôt`python-hello`. Créez des fichiers dans le répertoire racine du référentiel, avec les noms et le contenu spécifiés dans les exemples suivants.
### Fichiers pour le référentiel d'`python-hello`exemple
**Example requirements.txt**
```
pyramid==2.0
```
**Example server.py**
```
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response
import os
def hello_world(request):
name = os.environ.get('NAME')
if name == None or len(name) == 0:
name = "world"
message = "Hello, " + name + "!\n"
return Response(message)
if __name__ == '__main__':
port = int(os.environ.get("PORT"))
with Configurator() as config:
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', port, app)
server.serve_forever()
```
## Étape 1 : créer un service App Runner
Au cours de cette étape, vous allez créer un service App Runner basé sur l'exemple de référentiel de code source que vous avez créé sur GitHub ou dont Bitbucket fait partie[Conditions préalables](#getting-started.prereq). L'exemple contient un site Web Python simple. Voici les principales étapes à suivre pour créer un service :
1. Configurez votre code source.
1. Configurez le déploiement de la source.
1. Configurez le build de l'application.
1. Configurez votre service.
1. Vérifiez et confirmez.
Le schéma suivant décrit les étapes de création d'un service App Runner :
![\[Schéma du flux de travail de création du service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-create-service-workflow.png)
**Pour créer un service App Runner basé sur un référentiel de code source**
1. Configurez votre code source.
1. Ouvrez la [console App Runner](https://console.aws.amazon.com/apprunner), puis dans la liste des **régions**, sélectionnez votre Région AWS.
1. Si aucun service App Runner Compte AWS n'est encore disponible, la page d'accueil de la console s'affiche. Choisissez **Créer un service App Runner**.
![\[Page d'accueil de la console App Runner affichant le bouton de création de service\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-home.png)
S'il Compte AWS possède des services existants, la page **Services** contenant la liste de vos services s'affiche. Choisissez **Créer un service**.
![\[Page des services de la console App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-services.png)
1. Sur la page **Source et déploiement**, dans la section **Source**, pour **Type de référentiel**, choisissez **Référentiel de code source**.
1. Sélectionnez un **type de fournisseur**. Choisissez l'un **GitHub**ou l'autre ou **Bitbucket.**
1. Choisissez ensuite **Ajouter**. Si vous y êtes invité, fournissez vos informations d'identification GitHub ou celles de Bitbucket.
1. Choisissez la série d'étapes suivante en fonction du **type de fournisseur** que vous avez sélectionné précédemment.
**Note**
Les étapes suivantes pour installer le connecteur AWS GitHub sur votre GitHub compte sont des étapes uniques. Vous pouvez réutiliser la connexion pour créer plusieurs services App Runner basés sur les référentiels de ce compte. Lorsque vous disposez d'une connexion existante, choisissez-la et passez à la sélection du référentiel.
Il en va de même pour le connecteur AWS pour votre compte Bitbucket. Si vous utilisez les deux GitHub et Bitbucket comme référentiels de code source pour vos services App Runner, vous devez installer un connecteur AWS pour chaque fournisseur. Vous pouvez ensuite réutiliser chaque connecteur pour créer d'autres services App Runner.
+ Pour **GitHub**, suivez ces étapes.
1. Sur l'écran suivant, entrez un **nom de connexion**.
1. Si c'est la première fois que vous utilisez GitHub App Runner, sélectionnez **Installer un autre logiciel**.
1. Dans la boîte de GitHub dialogue **AWS Connector for**, si vous y êtes invité, choisissez le nom de votre GitHub compte.
1. Si vous êtes invité à autoriser le AWS connecteur pour GitHub, choisissez **Authorize AWS Connections**.
1. Dans la boîte de GitHub dialogue **Installer le AWS connecteur pour**, choisissez **Installer**.
Le nom de votre compte apparaît en tant que **GitHub compte/organisation** sélectionné. Vous pouvez désormais choisir un dépôt dans votre compte.
1. Pour **Repository**, choisissez l'exemple de référentiel que vous avez créé,`python-hello`. Pour **Branch**, choisissez le nom de branche par défaut de votre dépôt (par exemple, **main**).
1. Laissez le **répertoire source** avec la valeur par défaut. Le répertoire par défaut est la racine du dépôt. Vous avez enregistré votre code source dans le répertoire racine du référentiel lors des étapes précédentes relatives aux *prérequis*.
+ Pour **Bitbucket**, procédez comme suit.
1. Sur l'écran suivant, entrez un **nom de connexion**.
1. Si c'est la première fois que vous utilisez Bitbucket avec App Runner, sélectionnez **Installer un autre**.
1. Dans la boîte de dialogue des **AWS CodeStar demandes d'accès**, vous pouvez sélectionner votre espace de travail et lui accorder l'accès AWS CodeStar pour l'intégration de Bitbucket. Sélectionnez votre espace de travail, puis sélectionnez **Autoriser l'accès**.
1. Vous serez ensuite redirigé vers la AWS console. **Vérifiez que l'application Bitbucket est configurée sur le bon espace de travail Bitbucket et sélectionnez Next.**
1. Pour **Repository**, choisissez l'exemple de référentiel que vous avez créé,`python-hello`. Pour **Branch**, choisissez le nom de branche par défaut de votre dépôt (par exemple, **main**).
1. Laissez le **répertoire source** avec la valeur par défaut. Le répertoire par défaut est la racine du dépôt. Vous avez enregistré votre code source dans le répertoire racine du référentiel lors des étapes précédentes relatives aux *prérequis*.
1. Configurez vos déploiements : dans la section **Paramètres de déploiement**, choisissez **Automatique**, puis **Next**.
**Note**
Avec le déploiement automatique, chaque nouvelle validation dans le répertoire source de votre référentiel déploie automatiquement une nouvelle version de votre service.
![\[Paramètres de source et de déploiement lors de la création d'un service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-create-source-depl.png)
1. Configurez le build de l'application.
1. Sur la page **Configurer le build**, dans **Fichier de configuration**, choisissez **Configurer tous les paramètres ici**.
1. Fournissez les paramètres de compilation suivants :
+ **Runtime** — Choisissez **Python 3**.
+ **Commande de construction** — Entrez**pip install -r requirements.txt**.
+ **Commande de démarrage** — Entrez**python server.py**.
+ **Port** — Entrez**8080**.
1. Choisissez **Suivant**.
**Note**
Le moteur d'exécution Python 3 crée une image Docker à l'aide d'une image Python 3 de base et de votre exemple de code Python. Il lance ensuite un service qui exécute une instance de conteneur de cette image.
![\[Créez des paramètres lors de la création d'un service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-create-build.png)
1. Configurez votre service.
1. Sur la page **Configurer le service**, dans la section **Paramètres du service**, entrez un nom de service.
1. Sous **Variables d'environnement**, sélectionnez **Ajouter une variable d'environnement**. Fournissez les valeurs suivantes pour la variable d'environnement.
+ **Source** — Choisissez le **texte brut**
+ **Nom de la variable d'environnement** — **NAME**
+ **Valeur de la variable d'environnement** : n'importe quel nom (par exemple, votre prénom).
**Note**
L'application d'exemple lit le nom que vous avez défini dans cette variable d'environnement et l'affiche sur sa page Web.
1. Choisissez **Suivant**.
![\[Paramètres de service lors de la création d'un service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-create-service.png)
1. Sur la page **Réviser et créer**, vérifiez tous les détails que vous avez saisis, puis choisissez **Créer et déployer**.
Si le service est créé avec succès, la console affiche le tableau de bord du service, avec une **vue d'ensemble** du nouveau service.
![\[Page du tableau de bord du service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-create-dashboard.png)
1. Vérifiez que votre service fonctionne.
1. Sur la page du tableau de bord du service, attendez que le **statut** du service soit **en cours d'exécution**.
1. Choisissez la valeur de **domaine par défaut** : il s'agit de l'URL du site Web de votre service.
**Note**
[Pour renforcer la sécurité de vos applications App Runner, le *domaine\$1.awsapprunner.com* est enregistré dans la liste des suffixes publics (PSL).](https://publicsuffix.org/) Pour plus de sécurité, nous vous recommandons d'utiliser des cookies avec un `__Host-` préfixe si vous devez définir des cookies sensibles dans le nom de domaine par défaut de vos applications App Runner. Cette pratique vous aidera à protéger votre domaine contre les tentatives de falsification de requêtes intersites (CSRF). Pour plus d’informations, consultez la page [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) du Mozilla Developer Network.
Une page Web affiche : **Hello, *your name* \$1**
![\[La page Web d'application d'un service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-create-webpage.png)
## Étape 2 : modifiez votre code de service
Au cours de cette étape, vous apportez une modification à votre code dans le répertoire source du référentiel. La CI/CD fonctionnalité App Runner crée et déploie automatiquement les modifications apportées à votre service.
**Pour modifier votre code de service**
1. Accédez à votre exemple de référentiel.
1. Modifiez le fichier nommé`server.py`.
1. Dans l'expression affectée à la variable`message`, remplacez le texte `Hello` par`Good morning`.
1. Enregistrez et validez vos modifications dans le référentiel.
1. Les étapes suivantes illustrent la modification du code de service dans un GitHub référentiel.
1. Accédez à votre exemple de GitHub référentiel.
1. Choisissez le nom du fichier `server.py` pour accéder à ce fichier.
1. Choisissez **Modifier ce fichier** (icône en forme de crayon).
1. Dans l'expression affectée à la variable`message`, remplacez le texte `Hello` par`Good morning`.
![\[GitHub page de fichier avec icône d'édition et message surligné\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/getting-started-deploy-edit.png)
1. Choisissez **Valider les modifications**.
1. Le nouveau commit commence à être déployé pour votre service App Runner. Sur la page du tableau de bord du service, l'**état du** service **devient Opération en cours**.
Attendez la fin du déploiement. Sur la page du tableau de bord du service, le **statut** du service doit redevenir En **cours d'exécution**.
1. Vérifiez que le déploiement est réussi : actualisez l'onglet du navigateur où la page Web de votre service est affichée.
La page affiche désormais le message modifié : **Bonjour *your name* \$1**
## Étape 3 : effectuer une modification de configuration
Au cours de cette étape, vous modifiez la valeur de la variable d'**NAME**environnement afin de démontrer une modification de la configuration du service.
**Pour modifier la valeur d'une variable d'environnement**
1. Ouvrez la [console App Runner](https://console.aws.amazon.com/apprunner), puis dans la liste des **régions**, sélectionnez votre Région AWS.
1. Dans le volet de navigation, choisissez **Services**, puis choisissez votre service App Runner.
La console affiche le tableau de bord des services avec une vue d'**ensemble des services**.
![\[Page du tableau de bord du service App Runner affichant la liste des activités\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/console-dashboard.png)
1. Sur la page du tableau de bord du service, choisissez l'onglet **Configuration**.
La console affiche les paramètres de configuration de votre service dans plusieurs sections.
1. Dans la section **Configurer le service**, choisissez **Modifier**.
![\[La section Configuration du service de l'onglet Configuration de la page du tableau de bord du service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/service-dashboad-config-service.png)
1. Pour la variable d'environnement avec la clé**NAME**, remplacez la valeur par un autre nom.
1. Choisissez **Apply changes**.
App Runner lance le processus de mise à jour. Sur la page du tableau de bord du service, l'**état du** service **devient Opération en cours**.
1. Attendez la fin de la mise à jour. Sur la page du tableau de bord du service, le **statut** du service doit redevenir En **cours d'exécution**.
1. Vérifiez que la mise à jour est réussie : actualisez l'onglet du navigateur où la page Web de votre service est affichée.
La page affiche désormais le nom modifié : **Bonjour *new name* \$1**
## Étape 4 : Afficher les journaux de votre service
Au cours de cette étape, vous utilisez la console App Runner pour consulter les journaux de votre service App Runner. App Runner diffuse les journaux vers Amazon CloudWatch Logs (CloudWatch Logs) et les affiche sur le tableau de bord de votre service. Pour plus d'informations sur les journaux d'App Runner, consultez[Afficher les logs d'App Runner transmis à CloudWatch Logs](monitor-cwl.md).
**Pour consulter les journaux de votre service**
1. Ouvrez la [console App Runner](https://console.aws.amazon.com/apprunner), puis dans la liste des **régions**, sélectionnez votre Région AWS.
1. Dans le volet de navigation, choisissez **Services**, puis choisissez votre service App Runner.
La console affiche le tableau de bord des services avec une vue d'**ensemble des services**.
![\[Page du tableau de bord du service App Runner affichant la liste des activités\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/console-dashboard.png)
1. Sur la page du tableau de bord du service, choisissez l'onglet **Logs**.
La console affiche quelques types de journaux dans plusieurs sections :
+ **Journal des événements** : activité pendant le cycle de vie de votre service App Runner. La console affiche les derniers événements.
+ **Journaux de déploiement** : envoyez les déploiements de référentiels à votre service App Runner. La console affiche un flux de journal distinct pour chaque déploiement.
+ **Journaux d'application** : sortie de l'application Web déployée sur votre service App Runner. La console combine les résultats de toutes les instances en cours d'exécution dans un seul flux de journal.
![\[L'onglet Logs sur la page du tableau de bord du service App Runner\]](http://docs.aws.amazon.com/fr_fr/apprunner/latest/dg/images/service-dashboad-logs.png)
1. Pour rechercher des déploiements spécifiques, réduisez la liste des journaux de déploiement en saisissant un terme de recherche. Vous pouvez rechercher n'importe quelle valeur figurant dans le tableau.
1. Pour afficher le contenu d'un journal, choisissez **Afficher le journal complet (journal** des événements) ou le nom du flux du journal (journaux de déploiement et d'application).
1. Choisissez **Télécharger** pour télécharger un journal. Pour un flux de journal de déploiement, sélectionnez d'abord un flux de journal.
1. Choisissez **Afficher dans CloudWatch** pour ouvrir la CloudWatch console et utiliser toutes ses fonctionnalités pour explorer les journaux de service de votre App Runner. Pour un flux de journal de déploiement, sélectionnez d'abord un flux de journal.
**Note**
La CloudWatch console est particulièrement utile si vous souhaitez consulter les journaux d'applications d'instances spécifiques au lieu du journal d'applications combiné.
## Étape 5 : nettoyer
Vous avez maintenant appris à créer un service App Runner, à consulter les journaux et à apporter des modifications. Au cours de cette étape, vous supprimez le service pour supprimer les ressources dont vous n'avez plus besoin.
**Pour supprimer votre service**
1. Sur la page du tableau de bord du service, choisissez **Actions**, puis sélectionnez **Supprimer le service**.
1. Dans la boîte de dialogue de confirmation, entrez le texte demandé, puis choisissez **Supprimer**.
Résultat : La console accède à la page **Services**. Le service que vous venez de supprimer affiche le statut **DELETING**. Peu de temps après, il disparaît de la liste.
Pensez également à supprimer les connexions GitHub et Bitbucket que vous avez créées dans le cadre de ce didacticiel. Pour de plus amples informations, veuillez consulter [Gestion des connexions App Runner](manage-connections.md).
## Quelle est la prochaine étape
Maintenant que vous avez déployé votre premier service App Runner, consultez les rubriques suivantes pour en savoir plus :
+ [Architecture et concepts d'App Runner](architecture.md)— L'architecture, les principaux concepts et les AWS ressources liés à App Runner.
+ [Service basé sur l'image](service-source-image.md)et [Service basé sur le code](service-source-code.md) — Les deux types de sources d'applications qu'App Runner peut déployer.
+ [Développement du code d'application pour App Runner](develop.md)— Ce que vous devez savoir lors du développement ou de la migration du code d'une application en vue de son déploiement vers App Runner.
+ [Utilisation de la console App Runner](console.md)— Gérez et surveillez votre service à l'aide de la console App Runner.
+ [Gestion de votre service App Runner](manage.md)— Gérez le cycle de vie de votre service App Runner.
+ [Observabilité pour votre service App Runner](monitor.md)— Obtenez de la visibilité sur les opérations de votre service App Runner en surveillant les indicateurs, en lisant les journaux, en gérant les événements, en suivant les appels d'action du service et en suivant les événements liés aux applications tels que les appels HTTP.
+ [Fichier de configuration d'App Runner](config-file.md)— Méthode basée sur la configuration pour spécifier des options pour le comportement de compilation et d'exécution de votre service App Runner.
+ [L'API App Runner](api.md)— Utilisez l'interface de programmation d'applications (API) App Runner pour créer, lire, mettre à jour et supprimer des ressources App Runner.
+ [Sécurité dans App Runner](security.md)— Les différentes manières de garantir AWS la sécurité du cloud lorsque vous utilisez App Runner et d'autres services.