Options du serveur de développement local

Le serveur de développement local (dev_appserver.py) fait partie des composants App Engine de gcloud CLI. Cet article fournit des informations avancées sur l'utilisation de dev_appserver.py. Pour en savoir plus sur les tests en local, consultez la section Utiliser le serveur de développement local.

Configurer l'outil de serveur de développement local

Voici un exemple de commande dev_appserver.py :

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py OPTION yaml_path FILES

Remplacez les éléments suivants :

  • DEVAPPSERVER_ROOT par le chemin d'accès au répertoire racine dans lequel vous extrayez la version archivée de devapp_server.py. Pour en savoir plus sur le téléchargement et l'utilisation de la version archivée de dev_appserver.py, consultez la page Utiliser le serveur de développement local.
  • OPTION par une option compatible avec le serveur de développement local.
  • FILES par un ou plusieurs fichiers app.yaml, un par service, pour l'argument positionnel yaml_path.

Pour obtenir la liste complète des options, exécutez la commande suivante :

DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py -h

Options courantes

Les options les plus courantes sont les suivantes :

--admin_host=ADMIN_HOST
Nom d'hôte auquel la console d'administration du serveur de développement local doit être liée (par défaut : localhost).
--admin_port=ADMIN_PORT
Port auquel la console d'administration du serveur de développement local doit être liée (par défaut : 8000).
--enable_sendmail=yes|no
Utilise l'installation Sendmail de l'ordinateur local pour envoyer des e-mails.
--enable_task_running=yes|no
Permet au serveur de développement d'exécuter des tâches d'envoi. La valeur par défaut est yes. Si vous spécifiez no, le serveur n'exécute aucune tâche d'envoi.
--help
Affiche un message utile, puis la fenêtre se ferme.
--host=...
Adresse hôte à utiliser pour le serveur. Si vous souhaitez accéder au serveur de développement à partir d'un autre ordinateur de votre réseau, nous vous recommandons de définir cette option. L'adresse 0.0.0.0 autorise les accès à partir de localhost et à partir d'un nom d'hôte ou d'une adresse IP. La valeur par défaut est localhost.
--log_level=...
Niveau de journalisation le plus bas auquel des messages de journalisation sont écrits dans la console. Les messages correspondant au niveau de journalisation spécifié ou à un niveau supérieur sont disponibles en sortie. Les valeurs possibles sont debug, info, warning, error et critical.
--port=...
Numéro de port à utiliser pour le serveur. La valeur par défaut est 8080. Si plusieurs serveurs sont lancés (pour des services, par exemple), les ports qui suivent leur sont attribués, tels que 8081 et 8082.
--logs_path=...
Par défaut, les journaux du serveur de développement local sont uniquement stockés en mémoire. Spécifiez cette option si vous exécutez le serveur de développement local pour stocker les journaux dans un fichier, ce qui les rend disponibles lors du redémarrage du serveur. Vous devez spécifier le chemin et le nom du répertoire dans un fichier de base de données SQLite. S'il n'en existe aucun, un fichier de base de données SQLite est créé avec le nom spécifié. Par exemple, --logs_path=/home/logs/boglogs.db
--require_indexes=yes|no
Désactive la génération automatique des entrées dans le fichier index.yaml. Ainsi, lorsque l'application effectue une requête nécessitant que son index soit défini dans le fichier et que la définition d'index est introuvable, une exception est générée, comme cela se produit pour une exécution sur App Engine. La valeur par défaut est no.
--smtp_host=...
Nom d'hôte du serveur SMTP à utiliser pour envoyer des e-mails.
--smtp_port=...
Numéro de port du serveur SMTP à utiliser pour envoyer des e-mails.
--smtp_user=...
Nom d'utilisateur à utiliser avec le serveur SMTP pour envoyer des e-mails.
--smtp_password=...
Mot de passe à utiliser avec le serveur SMTP pour envoyer des e-mails.
--storage_path=...
Chemin d'accès à tous les fichiers locaux, tels que les journaux et les fichiers Datastore, Blobstore, Cloud Storage, sauf s'ils sont remplacés par --datastore_path, --blobstore_path ou --logs_path.
--support_datastore_emulator=yes|no
Utilisez l'émulateur Cloud Datastore (bêta) pour l'émulation du datastore local.
--datastore_emulator_port=...
Numéro de port à utiliser pour l'émulateur Cloud Datastore (bêta).
--env_var=...
Variable d'environnement définie par l'utilisateur pour le processus d'exécution local. Chaque env_var est au format "clé=valeur" et vous pouvez définir plusieurs variables d'environnement. En plus de env_variables dans le fichier app.yaml, cette option permet de définir des variables d'environnement supplémentaires pour les processus locaux. Exemple : --env_var KEY_1=val1 --env_var KEY_2=val2
--go_debugging=yes|no
Définissez cette option sur "yes" (oui) pour activer le débogage avec delve ou gdb. Cette action permettra de créer le fichier binaire de l'application avec tous les symboles nécessaires au débogage. Vous pouvez l'associer normalement au processus en cours d'exécution, par exemple : sudo dlv attach <pid>.