Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
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 :
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.
--runtime_python_path=...
Chemin d'accès à votre binaire Python 3. Pour exécuter une application Python 3 sur dev_appserver, spécifiez cette option.
--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.
Par exemple, --env_var KEY_1=val1 --env_var KEY_2=val2
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThe \u003ccode\u003edev_appserver.py\u003c/code\u003e is a local development server tool within the App Engine components of the gcloud CLI, providing advanced options for local development.\u003c/p\u003e\n"],["\u003cp\u003eBefore running \u003ccode\u003edev_appserver.py\u003c/code\u003e, users must ensure they have followed the setup instructions and use Python 3, while also setting the \u003ccode\u003eCLOUDSDK_DEVAPPSERVER_PYTHON\u003c/code\u003e environment variable to their Python 2 interpreter's path.\u003c/p\u003e\n"],["\u003cp\u003eA typical \u003ccode\u003edev_appserver.py\u003c/code\u003e command includes specifying the path to the tool, any desired options, and the \u003ccode\u003eapp.yaml\u003c/code\u003e file(s) for the service(s).\u003c/p\u003e\n"],["\u003cp\u003eCommon options for \u003ccode\u003edev_appserver.py\u003c/code\u003e include configuring admin and server hosts and ports, enabling email and task sending, setting log levels, specifying storage paths for local files, and using the Cloud Datastore Emulator.\u003c/p\u003e\n"],["\u003cp\u003eRunning the \u003ccode\u003edev_appserver.py -h\u003c/code\u003e command will display a complete list of options.\u003c/p\u003e\n"]]],[],null,["# Local Development Server Options\n\nThe local development server (`dev_appserver.py`) is part of the App Engine\ncomponents of the [gcloud CLI](/sdk/docs). This topic provides advanced\ninformation about the `dev_appserver.py` usage.\n\n\nSee [Using the Local Development Server](/appengine/docs/legacy/standard/python/tools/using-local-server)\nfor more information about local testing.\n\n\nSet up the local development server tool\n----------------------------------------\n\n| **Important:**\n| - Before running the local development server, follow the [setup instructions](/appengine/docs/legacy/standard/python/tools/using-local-server#set-up). Regardless of your app's runtime or language version, you must run `dev_appserver.py` with Python 3 and set the `CLOUDSDK_DEVAPPSERVER_PYTHON` environment variable in your shell to the path of your Python 2 interpreter.\n| - The `dev_appserver` tool does not support development of Python 3 apps on Windows.\n\nA sample `dev_appserver.py` command might look as follows: \n\n python2 \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eDEVAPPSERVER_ROOT\u003c/span\u003e\u003c/var\u003e/google_appengine/dev_appserver.py \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eOPTION\u003c/span\u003e\u003c/var\u003e yaml_path \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eFILES\u003c/span\u003e\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eDEVAPPSERVER_ROOT\u003c/var\u003e with the path to the root directory where you extract the archived version of `devapp_server.py`. For more information about downloading and using the archived version of `dev_appserver.py`, see [Using the local development server](/appengine/docs/legacy/standard/python/tools/using-local-server#before_you_begin).\n- \u003cvar translate=\"no\"\u003eOPTION\u003c/var\u003e with a flag supported by the local development server.\n- \u003cvar translate=\"no\"\u003eFILES\u003c/var\u003e specifies one or more `app.yaml` files, one per service, for the positional argument `yaml_path`.\n\nFor a complete list of options, run the following:\n\n\u003cvar translate=\"no\"\u003eDEVAPPSERVER_ROOT\u003c/var\u003e/google_appengine/dev_appserver.py -h\n\nCommon options\n--------------\n\nThe most common options are as follows:\n\n`--admin_host=ADMIN_HOST`\n: Host name to which the local development server's administration console\n should bind (default: localhost).\n\n`--admin_port=ADMIN_PORT`\n: Port to which the local development server's administration console should\n bind (default: 8000).\n\n`--enable_sendmail=yes|no`\n: Uses the local computer's Sendmail installation for\n sending email messages.\n\n`--enable_task_running=yes|no`\n: Enables the development server to run push tasks. The default is `yes`.\n If you specify `no`, the server will not run push tasks.\n\n`--help`\n: Prints a helpful message then quits.\n\n`--host=...`\n: The host address to use for the server. You may need to set this to be able\n to access the development server from another computer on your network. An\n address of `0.0.0.0` allows both localhost access and IP or hostname access.\n Default is `localhost`.\n\n`--log_level=...`\n: The lowest logging level at which logging messages will be written to the\n console; messages of the specified logging level or higher will be output.\n Possible values are `debug`, `info`, `warning`, `error`, and `critical`.\n\n`--port=...`\n: The port number to use for the server. Default is `8080`. If multiple servers\n are launched such as for services, they will be assigned subsequent ports,\n such as `8081`, `8082`.\n\n`--logs_path=...`\n: By default, the logs for the local development server are stored in memory\n only. Specify this option when you run the local development server to store\n the logs into a file, which makes the logs available across server restarts.\n You must specify the directory path and name to a SQLite database file. A\n SQLite database file is created with the specified name if the file does not\n already exist. For example: `--logs_path=/home/logs/boglogs.db`\n\n`--require_indexes=yes|no`\n: Disables automatic generation of entries in the `index.yaml` file. Instead,\n when the application makes a query that requires that its index be defined in\n the file and the index definition is not found, an exception will be raised,\n similar to what would happen when running on App Engine. The default value is\n `no`.\n\n`--runtime_python_path=...`\n: The path to your Python 3 binary. To run a Python 3 app on the\n `dev_appserver`, specify this flag.\n\n`--smtp_host=...`\n: The hostname of the SMTP server to use for sending email messages.\n\n`--smtp_port=...`\n: The port number of the SMTP server to use for sending email messages.\n\n`--smtp_user=...`\n: The username to use with the SMTP server for sending email messages.\n\n`--smtp_password=...`\n: The password to use with the SMTP server for sending email messages.\n\n`--storage_path=...`\n: Path at which all local files, such as the Datastore,\n Blobstore, Cloud Storage files and logs, will be stored, unless\n overridden by `--datastore_path`, `--blobstore_path`, or `--logs_path`.\n\n`--support_datastore_emulator=yes|no`\n: Use the Cloud Datastore Emulator (beta) for local datastore emulation.\n\n`--datastore_emulator_port=...`\n: The port number to use for Cloud Datastore Emulator (beta).\n\n`--env_var=...`\n: User defined environment variable for the local runtime process. Each\n `env_var` is in the format of key=value, and you can define multiple\n environment variables. In addition to `env_variables` in the `app.yaml`, this\n flag allows setting extra environment variables for local processes.\n For example:`--env_var KEY_1=val1 --env_var KEY_2=val2`"]]
