Tester et déployer une application

ID de la région

Le REGION_ID est un code abrégé que Google attribue en fonction de la région que vous sélectionnez lors de la création de votre application. Le code ne correspond pas à un pays ou une province, même si certains ID de région peuvent ressembler aux codes de pays et de province couramment utilisés. Pour les applications créées après février 2020, REGION_ID.r est inclus dans les URL App Engine. Pour les applications existantes créées avant cette date, l'ID de région est facultatif dans l'URL.

En savoir plus sur les ID de région

OK

Python|Java|Node.js|Go|Ruby|PHP|.NET

Découvrez comment exécuter votre application en local, et la déployer et la tester sur App Engine.

Exécuter l'application en local

Pour tester les fonctionnalités de votre application avant le déploiement, exécutez-la dans l'environnement local avec les outils de développement que vous utilisez habituellement.

Par exemple, vous pouvez généralement exécuter une application Flask avec le serveur de développement de Flask à l'aide de la commande :

python main.py

Vous pouvez lancer les applications Django à l'aide de la commande :

python manage.py runserver

Pour simuler un environnement App Engine de production, vous pouvez exécuter le serveur WSGI (Web Server Gateway Interface) complet en local. Pour ce faire, utilisez la même commande que celle spécifiée en tant que entrypoint dans le fichier app.yaml, par exemple :

gunicorn -b :$PORT main:app

Déployer l'application

Déployez votre application sur App Engine à l'aide de la commande gcloud app deploy. Cette commande crée automatiquement une image du conteneur à l'aide du service Cloud Build, puis déploie cette image dans l'environnement flexible App Engine. Le conteneur inclura toutes les modifications locales que vous avez déjà apportées à l'image de l'environnement d'exécution.

Pour déployer vos applications par programmation, utilisez l'API Admin.

Avant de commencer

Pour que vous puissiez déployer votre application, les conditions suivantes doivent être remplies :

• Le propriétaire du projet Cloud doit activer App Engine.

• Assurez-vous que votre compte utilisateur inclut les droits requis.

Garantir la réussite d'un déploiement

Si vous activez les vérifications de l'état mises à jour, les déploiements sont annulés si votre application n'atteint pas un état sain.

Lorsque vous déployez votre première application dans l'environnement flexible, un délai peut s'écouler lors de la configuration de votre machine virtuelle (VM) et des autres infrastructures. Une fois la configuration initiale terminée, les vérifications de l'état s'assurent que votre instance est opérationnelle et prête à recevoir du trafic. Si votre application n'est pas prête dans le délai indiqué par le champ initial_delay_sec de la section liveness_check du fichier app.yaml, votre déploiement échoue et est annulé.

Votre application a peut-être besoin de davantage de temps pour être prête. Par exemple, vous devrez peut-être télécharger des fichiers volumineux ou pré-charger des caches pour initialiser votre application. Si vous utilisez les vérifications d'état mises à jour, vous pouvez augmenter ce délai en modifiant le paramètre de configuration app_start_timeout_sec dans la section readiness_check du fichier app.yaml.

Si votre déploiement échoue, assurez-vous que l'API Cloud Build est activée dans votre projet. App Engine active automatiquement cette API la première fois que vous déployez une application, mais si quelqu'un l'a désactivée depuis, les déploiements échouent.

Déployer un service

Vous déployez votre application sur App Engine en mettant en œuvre des versions de ses services et de chacun de leurs fichiers de configuration.

Pour déployer le service de votre application, exécutez la commande suivante à partir du répertoire contenant le fichier app.yaml de votre service :

gcloud app deploy

Par défaut, la commande gcloud app deploy déploie uniquement le fichier app.yaml dans votre répertoire actuel. Chaque fois que vous exécutez cette commande, App Engine génère un ID unique pour la version que vous déployez, effectue le déploiement de la version dans le projet Cloud que vous avez configuré pour être utilisé par gcloud CLI, et achemine tout le trafic vers la nouvelle version. La nouvelle version devient la version par défaut.

Remarque : Il est recommandé de consulter la page Versions d'App Engine dans Google Cloud Console ou d'exécuter gcloud app versions list après avoir exécuté la commande gcloud app deploy pour vérifier la version qui reçoit le trafic.

Vous pouvez modifier le comportement par défaut de la commande gcloud app deploy en ciblant des fichiers spécifiques, en spécifiant des versions ou en incluant des paramètres supplémentaires :

• Vous pouvez déployer les autres fichiers de configuration de votre service en ciblant et en déployant chaque fichier séparément. Exemple :

  gcloud app deploy cron.yaml
  gcloud app deploy dispatch.yaml
  gcloud app deploy index.yaml
  

• Pour spécifier un ID de version personnalisé, utilisez l'option --version.

• Pour empêcher que le trafic ne soit automatiquement acheminé vers la nouvelle version, utilisez l'option --no-promote.

• Pour effectuer un déploiement dans un projet Cloud spécifique, utilisez l'option --project.

Par exemple, pour déployer le service défini par le fichier app.yaml dans un projet Cloud spécifique, attribuez-lui un ID de version personnalisé et empêchez que le trafic ne soit acheminé vers la nouvelle version :

gcloud app deploy --project PROJECT_ID --version VERSION_ID --no-promote

Pour en savoir plus sur cette commande, consultez la documentation de référence sur gcloud app deploy.

Remarque : Vous pouvez définir des propriétés pour gcloud CLI, et créer et gérer des configurations de SDK. Ainsi, vous n'avez pas besoin de spécifier des options telles que --project à chaque déploiement.

Déployer plusieurs services

La même commande de déploiement permet de déployer ou mettre à jour les différents services constituant votre application.

Pour déployer plusieurs services, vous devez déployer séparément le fichier app.yaml de chaque service. Exemple :

gcloud app deploy service1/app.yaml
gcloud app deploy service2/app.yaml

Vous pouvez spécifier plusieurs fichiers à l'aide d'une seule commande de déploiement :

gcloud app deploy service1/app.yaml service2/app.yaml

Conditions requises pour déployer plusieurs services

• Pour pouvoir créer et déployer des services supplémentaires, vous devez d'abord déployer une version de votre application sur le service default.

• L'ID de chacun de vos services doit être spécifié dans les fichiers de configuration app.yaml correspondants. Pour spécifier l'ID d'un service, incluez la définition de l'élément service dans chaque fichier de configuration. Par défaut, le fait d'exclure cette définition d'élément de votre fichier de configuration entraîne le déploiement de la version sur le service default.

Ignorer des fichiers

Vous pouvez utiliser un fichier .gcloudignore pour spécifier les fichiers et les répertoires à ne pas importer dans Google Cloud lorsque vous déployez vos services. Cette opération est utile pour ignorer les artefacts de compilation et d'autres fichiers qui n'ont pas besoin d'être importés lors du déploiement.

Remarque : Vous ne pouvez pas spécifier le champ skip_files dans votre fichier app.yaml si vous avez un fichier .gcloudignore

.

Pour en savoir plus sur la syntaxe du fichier .gcloudignore, consultez la documentation de référence gcloud.

Compiler manuellement un conteneur pour le déploiement

Si vous souhaitez créer vos images de conteneur en dehors de Google Cloud Platform, vous devez d'abord importer vos images dans un dépôt d'images de conteneur avant de déployer vos images dans App Engine à l'aide de la commande gcloud app deploy.

Par exemple, si vous créez vos images de conteneur en local avec Docker, vous pouvez les importer dans Google Container Registry, puis spécifier l'URL de l'image que vous souhaitez utiliser dans l'option --image-url de la commande :

gcloud app deploy --image-url gcr.io/YOUR_PROJECT_ID/YOUR_CONTAINER_IMAGE

Utiliser des pipelines de déploiement continu automatisé

Vous pouvez utiliser Cloud Build pour automatiser les déploiements dans des pipelines de déploiement continu. Pour en savoir plus, consultez la section Déployer des artefacts et la page Automatiser les compilations avec des déclencheurs de compilation dans la documentation Cloud Build.

Images Docker de base pour Python

Si vous souhaitez compiler entièrement une application d'exécution personnalisée Python, utilisez une image de base fournie dans le fichier Dockerfile :

Environnement d'exécution	Commande Docker	Équivalent Google runtime
Python (vous pouvez spécifier la version 2.7 ou 3.6 dans le fichier Dockerfile)	FROM gcr.io/google-appengine/python	runtime: python

Afficher votre application

Après avoir déployé votre application dans App Engine, vous pouvez exécuter la commande suivante pour lancer votre navigateur et l'afficher à l'adresse https://PROJECT_ID.REGION_ID.r.appspot.com :

gcloud app browse

Tester votre application sur App Engine

Avant de configurer une nouvelle version pour recevoir du trafic, vous pouvez la tester sur App Engine. Par exemple, pour tester une nouvelle version de votre service default :

1. Déployez votre nouvelle version et ajoutez l'indicateur --no-promote :

   gcloud app deploy --no-promote

2. Affichez la nouvelle version en accédant à l'URL suivante :

   https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com

   Remarque : Vous pouvez consulter l'ID de version dans la console Google Cloud, ou en spécifier un lors du déploiement à l'aide de l'option --version. gcloud CLI génère également l'ID de version lors du déploiement.

   Vous pouvez maintenant tester la nouvelle version dans l'environnement d'exécution App Engine. Vous pouvez déboguer votre application en affichant ses journaux dans l'explorateur de journaux de Google Cloud Console. Pour en savoir plus, consultez la page Écrire des journaux d'application.

   Les requêtes envoyées à l'adresse https://PROJECT_ID.REGION_ID.r.appspot.com sont toujours acheminées vers la version précédemment configurée pour recevoir du trafic.

3. Lorsque vous souhaitez envoyer du trafic vers la nouvelle version, utilisez la console Google Cloud pour migrer le trafic :

   Gérer les versions

   Sélectionnez la version que vous venez de déployer et cliquez sur Migrer le trafic.

Vous pouvez utiliser le même processus pour tester de nouvelles versions d'autres services en remplaçant default dans l'URL par le nom de votre service :

Pour en savoir plus sur le ciblage de services et de versions spécifiques, consultez la page Mode de routage des requêtes.

Dépannage

Voici des messages d'erreur courants que vous pouvez rencontrer lorsque vous déployez des applications :

PERMISSION_DENIED: Operation not allowed

The "appengine.applications.create" permission is required.

Si le projet Cloud n'inclut pas l'application App Engine requise, la commande gcloud app deploy risque d'échouer lorsqu'elle tente d'exécuter la commande gcloud app create. Seuls les comptes dotés du rôle Propriétaire disposent des autorisations nécessaires pour créer des applications App Engine.

502 Bad Gateway

Le projet Cloud risque de ne pas démarrer si app.yaml est mal configuré. Consultez les journaux de l'application pour obtenir des messages d'erreur plus détaillés.

[13] An internal error occurred while creating a Cloud Storage bucket.

App Engine crée un bucket multirégional Cloud Storage par défaut en votre nom, dans la même région que votre application. Ce bucket est nécessaire pour stocker le contenu de votre application. Cette erreur est renvoyée lorsque ce bucket ne peut pas être créé, dans les scénarios suivants :

• L'agent de service de l'environnement flexible App Engine par défaut n'est pas présent dans votre projet ou ne dispose pas du rôle App Engine flexible environment Service Agent. Vous pouvez rajouter le compte de service de l'agent dans votre projet en lui accordant les autorisations IAM appropriées.

• Le compte de service App Engine n'est pas présent dans votre projet. Si le compte de service App Engine a été supprimé il y a moins de 30 jours, vous pouvez le restaurer.

• Votre projet appartient à une organisation qui applique la règle constraints/gcp.resourceLocations et n'autorise pas la création de ressources dans la région où votre application App Engine a été créée. Vous devez ignorer la règle constraints/gcp.resourceLocations appliquée pour votre projet et autoriser les emplacements multirégionaux sur la même région où votre application App Engine est créée.

Remarque : Par exemple, si votre application App Engine est créée dans la région europe-west, même si cette région est mappée à l'l'emplacement europe-west1, vous devrez modifier la contrainte pour autoriser les ressources dans in:eu-locations, qui inclut toutes les régions EU. Cette étape est nécessaire, car les buckets créés par App Engine sont multirégionaux. Si votre application App Engine est créée dans les régions US et ASIA, vous devez autoriser respectivement in:us-locations ou in:asia-locations.

[13] An internal error occurred.

Cette erreur peut se produire si vous déployez votre service avec une configuration réseau utilisant une configuration de VPC partagé. Assurez-vous que votre environnement flexible App Engine répond à toutes les exigences pour cette configuration. Assurez-vous ensuite que les comptes de service configurés pour cette configuration sont bien présents dans votre projet. Si ce n'est pas le cas, vous devrez restaurer les comptes. Notez que la région du sous-réseau du projet hôte de VPC partagé doit correspondre à l'emplacement dans lequel votre environnement App Engine a été créé.

Si le problème persiste bien que la configuration de app.yaml soit valide, utilisez le SDK Google Cloud pour redéployer votre service, en ajoutant l'option --verbosity=debug, puis contactez l'assistance GCP en fournissant le résultat de la commande.

IP space of {USER_SUBNETWORK_NAME} is exhausted and needs to be expanded.

Si le déploiement échoue avec ce message d'erreur, cela signifie que le réseau configuré pour le service App Engine n'a plus d'adresses à allouer pour les nouvelles instances du service. Vous pouvez résoudre le problème en étendant les plages VPC sur le sous-réseau configuré pour votre service d'environnement flexible App Engine.