Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O servidor de desenvolvimento local (dev_appserver.py) faz parte dos componentes
do App Engine da CLI gcloud. Neste tópico, fornecemos informações avançadas
sobre o uso de dev_appserver.py.
Saiba mais sobre testes locais em Como usar o servidor de desenvolvimento
local.
Configurar a ferramenta de servidor de desenvolvimento local
Um exemplo de comando dev_appserver.py pode ter a seguinte aparência:
DEVAPPSERVER_ROOT pelo caminho para o diretório raiz
em que você extrai a versão arquivada de devapp_server.py. Para mais informações sobre
como fazer o download e usar a versão arquivada de dev_appserver.py, consulte Como usar o servidor de desenvolvimento local.
OPTION por uma sinalização compatível com o servidor de desenvolvimento local.
FILES especifica um ou mais arquivos app.yaml, um por
serviço, para o argumento posicional yaml_path.
Para ver uma lista completa de opções, execute o seguinte:
Obsoleto. Como o armazenamento de dados local atribui IDs automáticos. As opções são
sequential ou scattered. O padrão é scattered.
--admin_host=ADMIN_HOST
Nome do host a que o console de administração do servidor de desenvolvimento
local precisa se vincular (padrão: localhost).
--admin_port=ADMIN_PORT
Porta a que o console de administração do servidor de desenvolvimento local precisa
se vincular (padrão: 8000).
--clear_datastore=yes|no
Limpa os arquivos de histórico e dados do armazenamento de dados antes de iniciar o servidor da Web.
O padrão é no.
--datastore_path=...
O caminho a ser usado para o arquivo de dados do armazenamento de dados local. O servidor cria esse arquivo se ele não existir.
--enable_sendmail=yes|no
Usa a instalação Sendmail do computador local para
enviar mensagens de e-mail.
--enable_task_running=yes|no
Permite que o servidor de desenvolvimento execute tarefas push. O padrão é yes.
Se você especificar no, o servidor não executará tarefas push.
--help
Imprime uma mensagem útil e é encerrado.
--host=...
O endereço de host a ser usado com o servidor. É preciso configurá-lo para acessar o servidor de desenvolvimento a partir de outro computador da rede. Um
endereço de 0.0.0.0 permite acesso ao localhost e ao IP ou nome do host.
O padrão é localhost.
--log_level=...
O nível de registro mais baixo em que as mensagens de registro serão escritas no
console. As mensagens do nível de registro especificado ou superior serão exibidas.
Os valores possíveis são debug, info, warning, error e critical.
--port=...
O número da porta a ser usada com o servidor. O padrão é 8080. Se vários servidores
forem iniciados, por exemplo, para serviços, serão atribuídas portas subsequentes,
como 8081 e 8082.
--logs_path=...
Por padrão, os registros do servidor de desenvolvimento local são armazenados somente na
memória. Especifique esta opção ao executar o servidor de desenvolvimento local para armazenar os registros em um arquivo, o que disponibiliza os registros nas reinicializações do servidor.
É preciso especificar o caminho do diretório e o nome de um arquivo de banco de dados SQLite. Se ainda não existir, um arquivo SQLite será criado com o nome especificado. Exemplo: --logs_path=/home/logs/boglogs.db
--require_indexes=yes|no
Desativa a geração automática de entradas no arquivo index.yaml. Em vez disso, quando o aplicativo realizar uma consulta que exija a definição do índice no arquivo e esta não for encontrada, uma exceção será emitida como aconteceria durante a execução no App Engine. O valor padrão é no.
--smtp_host=...
O nome do host do servidor SMTP a ser usado para enviar mensagens de e-mail.
--smtp_port=...
O número da porta do servidor SMTP a ser usada para enviar mensagens de e-mail.
--smtp_user=...
O nome de usuário a ser usado com o servidor SMTP para enviar mensagens de e-mail.
--smtp_password=...
A senha a ser usada com o servidor SMTP para enviar mensagens de e-mail.
--storage_path=...
O caminho em que todos os arquivos locais, como o Datastore,
o Blobstore, os arquivos e registros do Cloud Storage, serão armazenados, a menos que
sejam substituídos por --datastore_path, --blobstore_path ou --logs_path.
--support_datastore_emulator=yes|no
Usa o emulador do Cloud Datastore (Beta) para a emulação de armazenamento de dados local.
--datastore_emulator_port=...
O número da porta a ser usada para o emulador do Cloud Datastore (Beta).
--env_var=...
Variável de ambiente definida pelo usuário para o processo do ambiente de execução local. Cada
env_var está no formato key=value, e é possível definir diversas
variáveis de ambiente. Além de env_variables no app.yaml, essa
sinalização permite definir variáveis de ambiente extras para processos locais.
Exemplo:--env_var KEY_1=val1 --env_var KEY_2=val2
--php_executable_path=...
Caminho para o binário php-cgi.
--php_gae_extension_path=...
Caminho para o binário gae_runtime_module.so.
--php_remote_debugging=yes|no
Defina como “yes” (sim) para ativar a depuração remota com o XDebug.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 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, used for testing applications locally.\u003c/p\u003e\n"],["\u003cp\u003eBefore running \u003ccode\u003edev_appserver.py\u003c/code\u003e, it is required to use Python 3 and set the \u003ccode\u003eCLOUDSDK_DEVAPPSERVER_PYTHON\u003c/code\u003e environment variable to the path of your Python 2 interpreter.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edev_appserver.py\u003c/code\u003e command utilizes flags like \u003ccode\u003e--admin_port\u003c/code\u003e, \u003ccode\u003e--host\u003c/code\u003e, and \u003ccode\u003e--port\u003c/code\u003e to configure the local development server, among others, and can also leverage various other options as displayed by the \u003ccode\u003e-h\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe local server can use different features like sending email, or push task by setting up different flags like \u003ccode\u003e--enable_sendmail\u003c/code\u003e and \u003ccode\u003e--enable_task_running\u003c/code\u003e to yes.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e--storage_path\u003c/code\u003e flag can be used to specify the location of local files such as Datastore, Blobstore, Cloud Storage files and logs, that will be stored unless the more specific datastore, blobstore, or logs flag is used instead.\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/php/tools/using-local-server)\nfor more information about local testing.\n\n\nSet up the local development server tool\n----------------------------------------\n\n| **Important:** Before running the local development server, follow the [setup instructions](/appengine/docs/legacy/standard/php/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\nA sample `dev_appserver.py` command might look as follows: \n\n python2 \u003cvar translate=\"no\"\u003eDEVAPPSERVER_ROOT\u003c/var\u003e/google_appengine/dev_appserver.py \u003cvar translate=\"no\"\u003eOPTION\u003c/var\u003e yaml_path \u003cvar translate=\"no\"\u003eFILES\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/php/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`--auto_id_policy=...`\n: Deprecated. How the local datastore assigns automatic IDs. Options are\n `sequential` or `scattered`. The default is `scattered`.\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`--clear_datastore=yes|no`\n: Clears the datastore data and history files before starting the web server.\n The default is `no`.\n\n`--datastore_path=...`\n: The path to use for the local datastore data file. The server creates this\n file if it does not exist.\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\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`\n\n\n`--php_executable_path=...`\n: Path to the php-cgi binary.\n\n`--php_gae_extension_path=...`\n: Path to the gae_runtime_module.so binary.\n\n`--php_remote_debugging=yes|no`\n: Set to yes to enable remote debugging with XDebug"]]
