La compatibilité de la version 5.5 de PHP n'étant plus assurée par la communauté, nous vous recommandons vivement d'utiliser l'environnement d'exécution PHP 7 pour toute nouvelle application.

Fichiers de configuration

Chaque version d'un service est définie dans un fichier .yaml, qui donne le nom du service et sa version. Le fichier YAML porte généralement le même nom que le service qu'il définit, mais ce n'est pas obligatoire. Si vous déployez plusieurs versions d'un service, vous pouvez créer plusieurs fichiers YAML dans le même répertoire, à savoir un pour chaque version.

Généralement, vous créez pour chaque service un répertoire contenant les fichiers YAML du service et le code source associé. Des fichiers de configuration facultatifs au niveau de l'application (dispatch.yaml, cron.yaml, index.yaml et queue.yaml) sont inclus dans le répertoire de premier niveau de l'application. L'exemple ci-dessous décrit trois services. Dans service1 et service2, les fichiers source se trouvent au même niveau que le fichier YAML. Dans service3, il existe des fichiers YAML pour deux versions.

Graphique de la hiérarchie des services YAML

Pour les projets simples de petite taille, tous les fichiers de l'application peuvent se situer dans un même répertoire :

Graphique de la hiérarchie des petits services YAML

Chaque fichier YAML doit inclure un paramètre de version. Pour définir le service par défaut, vous pouvez explicitement inclure le paramètre service: default ou l'exclure du fichier.

Le fichier de configuration de chaque service définit le type de scaling et la classe d'instance pour un service ou une version spécifique. Différents paramètres de scaling sont utilisés selon le type de scaling que vous indiquez. Si vous ne spécifiez pas ce type, le scaling automatique est utilisé par défaut. Les paramètres de scaling et de classe d'instance sont décrits dans la documentation de référence sur le fichier app.yaml.

Pour chaque service, vous pouvez également spécifier des paramètres qui mappent les requêtes URL à des scripts spécifiques et identifient les fichiers statiques pour améliorer l'efficacité du serveur. Ces paramètres sont également inclus dans le fichier yaml et sont décrits dans la documentation de référence sur le fichier app.yaml.

Service par défaut

Chaque application possède un seul service par défaut. Vous pouvez définir le service par défaut dans le fichier app.yaml avec le paramètre service: default, mais ce n'est pas obligatoire. Tous les paramètres de configuration relatifs aux services peuvent s'appliquer au service par défaut.

Fichiers de configuration facultatifs

Ces fichiers de configuration contrôlent les fonctionnalités facultatives qui s'appliquent à tous les services d'une application :

  • dispatch.yaml
  • queue.yaml
  • index.yaml
  • cron.yaml
  • dos.yaml

Pour déployer les mises à jour de ces fichiers de configuration sur App Engine, exécutez la commande suivante à partir du répertoire où ils se trouvent :

    gcloud app deploy [CONFIG_FILE]

Exemple

Voici un exemple de configuration des fichiers YAML pour une application comportant trois services : un service par défaut qui traite les requêtes Web, ainsi que deux autres services qui gèrent les requêtes mobiles et le traitement backend.

Commencez par définir un fichier de configuration nommé app.yaml qui gérera toutes les requêtes Web :

runtime: php55
api_version: 1
threadsafe: true

Si l'ID de projet Cloud Console pour cette application est simple-sample, cette configuration crée un service par défaut avec scaling automatique et avec une adresse publique : https://simple-sample.uc.r.appspot.com.

Supposons ensuite que vous souhaitiez créer un service afin de traiter les requêtes Web mobiles. Dans l'intérêt des utilisateurs mobiles (dans cet exemple), le temps de latence maximal sera d'une seconde et nous aurons toujours au moins deux instances inactives. Pour ce faire, vous devez créer un fichier de configuration mobile-frontend.yaml avec le contenu suivant :

service: mobile-frontend
runtime: php55
api_version: 1
threadsafe: true

automatic_scaling:
  min_idle_instances: 2
  max_pending_latency: 1s

Le service créé par ce fichier sera alors accessible à l'adresse https://mobile-frontend-dot-simple-sample.uc.r.appspot.com.

Enfin, ajoutez un service appelé my-service pour gérer les tâches statiques liées au backend. Il peut par exemple s'agir d'une tâche continue exportant des données Datastore vers BigQuery. Comme la quantité de travail est relativement fixe, vous n'avez besoin que d'un service résident. En outre, ces tâches devront gérer un volume important de traitement en mémoire. Vous aurez donc besoin de services avec une configuration de mémoire accrue. Pour ce faire, vous devez créer un fichier de configuration my-service.yaml avec le contenu suivant.

service: my-service
runtime: php55
api_version: 1
threadsafe: true

instance_class: B8
manual_scaling:
  instances: 1

Le service créé par ce fichier sera alors accessible à l'adresse https://my-service-dot-simple-sample.uc.r.appspot.com.

Notez le paramètre manual_scaling:. Le paramètre instances: indique à App Engine le nombre d'instances à créer pour ce service.