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 plus d’informations, consultez 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 AutoDeploymentsEnabled membre du SourceConfigurationparamètre sur False pour un déploiement manuel ou True pour 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 :

App Runner console

Pour déployer à l'aide de la console App Runner

1. Ouvrez la console App Runner, puis dans la liste des régions, sélectionnez votre Région AWS.

2. 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.

   

3. Choisissez Deploy (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.

4. 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.

5. 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-Cookie du Mozilla Developer Network.

App Runner API or AWS CLI

Pour effectuer un déploiement à l'aide de l'API App Runner AWS CLI, ou appelez l'action StartDeploymentAPI. Le seul paramètre à transmettre est l'ARN de votre service. Vous avez déjà configuré l'emplacement de la source de votre application lorsque vous avez créé le service, et App Runner peut trouver la nouvelle version. Votre déploiement démarre si l'appel renvoie une réponse positive.