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.
Déploiement d'une nouvelle version de l'application sur App Runner
Lorsque vous créez un service dans AWS App Runner, vous configurez une source d'application, qu'il s'agisse d'une image de conteneur ou d'un référentiel source. App Runner fournit des ressources pour exécuter votre service et y déploie votre application.
Cette rubrique décrit les méthodes permettant de redéployer la source de votre application vers votre service App Runner lorsqu'une nouvelle version est disponible. Il peut s'agir d'une nouvelle version d'image dans le référentiel d'images ou d'un nouveau commit dans le référentiel de code. App Runner propose deux méthodes de déploiement sur un service : automatique et manuel.
Méthodes de déploiement
App Runner propose les méthodes suivantes pour vous permettre de contrôler la manière dont les déploiements d'applications sont initiés.
- Déploiement automatique
-
Utilisez le déploiement automatique lorsque vous souhaitez un comportement d'intégration et de déploiement continus (CI/CD) pour votre service. App Runner surveille les modifications apportées à votre référentiel d'images ou de code.
Référentiel d'images : chaque fois que vous publiez une nouvelle version d'image dans votre référentiel d'images ou une nouvelle validation dans votre référentiel de code, App Runner la déploie automatiquement sur votre service sans autre action de votre part.
Référentiel de code : chaque fois que vous envoyez un nouveau commit à votre dépôt de code qui apporte des modifications au répertoire source, App Runner déploie l'intégralité de votre référentiel. Étant donné que seules les modifications apportées au répertoire source déclenchent un déploiement automatique, il est important de comprendre comment l'emplacement du répertoire source affecte l'étendue d'un déploiement automatique.
-
Répertoire de premier niveau (racine du dépôt) : il s'agit de la valeur par défaut définie pour le répertoire source lorsque vous créez un service. Si votre répertoire source est défini sur cette valeur, cela signifie que l'ensemble du référentiel se trouve dans le répertoire source. Ainsi, tous les commits que vous envoyez au référentiel source déclencheront un déploiement dans ce cas.
-
Tout chemin de répertoire qui n'est pas la racine du référentiel (autre que celui par défaut) : étant donné que seules les modifications transmises dans le répertoire source déclencheront un déploiement automatique, les modifications transmises à votre référentiel qui ne se trouvent pas dans le répertoire source ne déclencheront pas de déploiement automatique. Par conséquent, vous devez utiliser un déploiement manuel pour déployer les modifications que vous envoyez en dehors du répertoire source.
Note
App Runner ne prend pas en charge le déploiement automatique pour les images Amazon ECR Public, ni pour les images d'un référentiel Amazon ECR appartenant à un AWS compte différent de celui dans lequel se trouve votre service.
-
- Déploiement manuel
-
Utilisez le déploiement manuel lorsque vous souhaitez lancer explicitement chaque déploiement sur votre service. Vous lancez un déploiement si le référentiel que vous avez configuré pour votre service contient une nouvelle version que vous souhaitez déployer. Pour de plus amples informations, veuillez consulter Déploiement manuel.
Note
Lorsque vous exécutez un déploiement manuel, App Runner déploie le code source à partir du référentiel complet.
Vous pouvez configurer la méthode de déploiement de votre service de la manière suivante :
-
Console : pour un nouveau service que vous créez ou pour un service existant, dans la section Paramètres de déploiement de la page Source et configuration du déploiement, choisissez Manuel ou Automatique.
-
API ou AWS CLI — Dans un appel à l'UpdateServiceaction CreateServiceou, définissez le
AutoDeploymentsEnabledmembre du SourceConfigurationparamètre surFalsepour un déploiement manuel ouTruepour un déploiement automatique.
Comparaison des déploiements automatiques et manuels
Les déploiements automatiques et manuels produisent le même résultat : les deux méthodes déploient le référentiel complet.
La différence entre les deux méthodes réside dans le mécanisme de déclenchement :
-
Les déploiements manuels sont déclenchés par un déploiement depuis la console, un appel ou un appel à l'API App Runner. AWS CLI La Déploiement manuel section qui suit décrit les procédures correspondantes.
-
Les déploiements automatiques sont déclenchés par une modification du contenu du répertoire source.
Déploiement manuel
Dans le cas d'un déploiement manuel, vous devez lancer explicitement chaque déploiement sur votre service. Lorsqu'une nouvelle version de l'image ou du code de votre application est prête à être déployée, vous pouvez consulter les sections suivantes pour savoir comment effectuer un déploiement à l'aide de la console et de l'API.
Note
Lorsque vous exécutez un déploiement manuel, App Runner déploie le code source à partir du référentiel complet.
Déployez une version de votre application à l'aide de l'une des méthodes suivantes :
Pour déployer à l'aide de la console App Runner
-
Ouvrez la console App Runner
, puis dans la liste des régions, sélectionnez votre Région AWS. -
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.
-
Choisissez Déployer.
Résultat : le déploiement de la nouvelle version démarre. 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.
-
Pour vérifier que le déploiement est réussi, sur la page du tableau de bord du service, choisissez la valeur de domaine par défaut, c'est-à-dire l'URL du site Web de votre service. Inspectez ou interagissez avec votre application Web et vérifiez votre changement de version.
Note
Pour renforcer la sécurité de vos applications App Runner, le domaine*.awsapprunner.com est enregistré dans la liste des suffixes publics (PSL).
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-Cookiedu Mozilla Developer Network.
