Organiser les fichiers de configuration .yaml

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. L'ajout de REGION_ID.r dans les URL App Engine est facultatif pour les applications existantes. Il sera bientôt obligatoire pour toutes les applications nouvelles.

Pour assurer une transition en douceur, nous mettons lentement à jour App Engine afin d'utiliser les ID de région. Si nous n'avons pas encore mis à jour votre projet Google Cloud, vous ne verrez pas d'ID de région pour votre application. Étant donné que l'ID est facultatif pour les applications existantes, vous n'avez pas besoin de mettre à jour les URL ni d'effectuer d'autres modifications une fois l'ID de région disponible pour vos applications existantes.

En savoir plus sur les ID de région

Le présent document vous explique comment structurer les services et les ressources associées de votre application pour App Engine.

Structure des répertoires

Chaque version de votre service App Engine est définie dans un fichier de configuration app.yaml. Pour les applications simples, l'exigence minimale requise pour le déploiement consiste à définir le fichier app.yaml. Le fichier app.yaml sert de descripteur de déploiement. Il définit le type de scaling, ainsi que les ressources (processeur, disque et mémoire) à utiliser pour une version spécifique d'un service. Si vous déployez plusieurs versions d'un service, vous pouvez créer différents fichiers YAML dans le même répertoire pour représenter la configuration de chaque version.

Les fichiers de configuration au format YAML sont utilisés pour les environnements d'exécution Eclipse Jetty 9 et Java 8.

L'organisation des fichiers dépend du moteur d'exécution Java que vous utilisez. Vous avez peut-être besoin d'un fichier WAR ou JAR, correspondant à chaque service de votre application. Pour plus d'informations, consultez le guide du développeur d'exécution Java approprié.

Conseils pour optimiser le temps d'activité d'une instance

Les pannes matérielles ou logicielles qui entraînent un arrêt anticipé ou des redémarrages fréquents des instances peuvent se produire sans avertissement. Par ailleurs, leur résolution peut prendre beaucoup de temps. Votre application doit pouvoir gérer ces défaillances.

Voici quelques stratégies efficaces à mettre en place pour éviter les temps d'arrêt dus aux redémarrages des instances :

  • Réduisez le temps nécessaire au redémarrage des instances existantes ou au démarrage des nouvelles instances.
  • Pour les calculs de longue durée, créez régulièrement des points de contrôle afin de pouvoir reprendre l'activité à partir de ces derniers.
  • Votre application doit être "sans état" pour que rien ne soit stocké sur l'instance.
  • Servez-vous de files d'attente pour exécuter des tâches asynchrones.
  • Si vous configurez vos instances pour le scaling manuel , procédez comme suit :
    • Utilisez l'équilibrage de charge sur plusieurs instances.
    • Configurez plus d'instances que nécessaire pour gérer le trafic normal.
    • Mettez en place une logique de secours qui utilise les résultats mis en cache lorsqu'une instance avec scaling manuel n'est pas disponible.

Pour en savoir plus sur les instances, consultez la page Mode de gestion des instances.

Le service default

Toutes les applications App Engine comprennent un service default. Pour pouvoir créer et déployer des services supplémentaires sur votre application, vous devez déployer une version initiale de votre application sur le service default.

Ce service par défaut peut éventuellement être spécifié dans le fichier app.yaml avec le paramètre service: default.

Les requêtes adressées à votre application en utilisant votre projet Cloud sont envoyées au service default, par exemple, https://PROJECT_ID.REGION_ID.r.appspot.com. Pour savoir comment cibler vos autres services, consultez la page Assurer la communication entre les services.

Fichiers de configuration facultatifs

Les fichiers de configuration suivants contrôlent les fonctionnalités facultatives qui s'appliquent à tous les services d'une application donnée. Consultez les rubriques suivantes pour en savoir plus sur chacune des fonctionnalités facultatives :

Considérations relatives au stockage de données et de fichiers

À partir d'App Engine, vous pouvez facilement accéder à d'autres services Google Cloud tels que Datastore, Cloud SQL et Cloud Storage.

Vous avez également la possibilité d'utiliser une base de données externe ou tierce compatible avec votre langage et accessible à partir de votre instance App Engine.

Pour en savoir plus sur le stockage de fichiers dans Google Cloud ou en externe, consultez la page Comprendre le stockage des données et des fichiers.

Vous avez aussi la possibilité de choisir le mode de diffusion du contenu statique. Vous pouvez diffuser le contenu statique de votre application directement depuis cette application dans App Engine, héberger votre contenu statique sur une solution Google Cloud telle que Cloud Storage, ou utiliser un réseau de diffusion de contenu (CDN) tiers. Pour plus d'informations sur la diffusion de contenu statique, consultez la page Diffuser des fichiers statiques.