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.

Si Python 2 n'est pas l'interpréteur par défaut sur votre système, vous devez exécuter python2 dev_appserver.py pour vous assurer que l'interpréteur Python 2 est utilisé, comme suit :

dev_appserver.py [options] yaml_path [files...]

L'argument positionnel yaml_path spécifie un ou plusieurs fichiers app.yaml, un par service.

Pour obtenir la liste complète des options, saisissez la commande suivante :

dev_appserver.py -h

Les options les plus courantes sont décrites ici.

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