Il server di sviluppo locale (dev_appserver.py) fa parte dei componenti di App Engine dell'interfaccia a riga di comando gcloud. Questo argomento fornisce informazioni avanzate sull'utilizzo di dev_appserver.py.
Per ulteriori informazioni sui test locali, consulta la sezione Utilizzare il server di sviluppo locale.
Configurare lo strumento del server di sviluppo locale
Un comando dev_appserver.py di esempio potrebbe avere il seguente aspetto:
python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py OPTION yaml_path FILES
Sostituisci quanto segue:
- DEVAPPSERVER_ROOT con il percorso della directory principale
in cui estrai la versione archiviata di
devapp_server.py. Per ulteriori informazioni sul download e sull'utilizzo della versione archiviata didev_appserver.py, consulta Utilizzare il server di sviluppo locale. - OPTION con un flag supportato dal server di sviluppo locale.
- FILES specifica uno o più file
app.yaml, uno per servizio, per l'argomento posizionaleyaml_path.
Per un elenco completo delle opzioni, esegui il seguente comando:
DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py -h
Opzioni comuni
Le opzioni più comuni sono le seguenti:
--auto_id_policy=...- Ritirata. Come il data store locale assegna gli ID automatici. Le opzioni sono
sequentialoscattered. Il valore predefinito èscattered.
--admin_host=ADMIN_HOST- Nome host a cui deve essere associata la console di amministrazione del server di sviluppo locale (valore predefinito: localhost).
--admin_port=ADMIN_PORT- Porta a cui deve essere associata la console di amministrazione del server di sviluppo locale (valore predefinito: 8000).
--clear_datastore=yes|no- Svuota i dati e i file di cronologia del data store prima di avviare il server web.
Il valore predefinito è
no. --datastore_path=...- Il percorso da utilizzare per il file di dati del datastore locale. Il server crea questo file se non esiste.
--enable_sendmail=yes|no- Utilizza l'installazione di Sendmail del computer locale per inviare messaggi email.
--enable_task_running=yes|no- Consente al server di sviluppo di eseguire attività push. Il valore predefinito è
yes. Se specifichino, il server non eseguirà le attività push. --help- Stampa un messaggio utile e poi esce.
--host=...- L'indirizzo host da utilizzare per il server. Potresti dover impostare questa opzione per poter accedere al server di sviluppo da un altro computer della rete. Un
indirizzo
0.0.0.0consente sia l'accesso a localhost sia l'accesso all'IP o al nome host. Il valore predefinito èlocalhost. --log_level=...- Il livello di logging più basso a cui i messaggi di logging verranno scritti nella console. Verranno visualizzati i messaggi del livello di logging specificato o superiore.
I valori possibili sono
debug,info,warning,errorecritical. --port=...- Il numero di porta da utilizzare per il server. Il valore predefinito è
8080. Se vengono avviati più server, ad esempio per i servizi, verranno assegnate porte successive, ad esempio8081,8082. --logs_path=...- Per impostazione predefinita, i log del server di sviluppo locale vengono archiviati solo in memoria. Specifica questa opzione quando esegui il server di sviluppo locale per archiviare
i log in un file, in modo che siano disponibili durante i riavvii del server.
Devi specificare il percorso della directory e il nome di un file del database SQLite. Se il file non esiste già, viene creato un file del database SQLite con il nome specificato. Ad esempio:
--logs_path=/home/logs/boglogs.db --require_indexes=yes|no- Disattiva la generazione automatica delle voci nel file
index.yaml. Al contrario, quando l'applicazione esegue una query che richiede che l'indice sia definito nel file e la definizione dell'indice non viene trovata, viene sollevata un'eccezione, simile a quanto accadrebbe durante l'esecuzione su App Engine. Il valore predefinito èno. --smtp_host=...- Il nome host del server SMTP da utilizzare per l'invio di messaggi email.
--smtp_port=...- Il numero di porta del server SMTP da utilizzare per l'invio dei messaggi email.
--smtp_user=...- Il nome utente da utilizzare con il server SMTP per l'invio di messaggi email.
--smtp_password=...- La password da utilizzare con il server SMTP per l'invio di messaggi email.
--storage_path=...- Percorso in cui verranno archiviati tutti i file locali, ad esempio i file e i log di Datastore, Blobstore e Cloud Storage, a meno che non vengano sostituiti da
--datastore_path,--blobstore_patho--logs_path. --support_datastore_emulator=yes|no- Utilizza l'emulatore Cloud Datastore (beta) per l'emulazione del datastore locale.
--datastore_emulator_port=...- Il numero di porta da utilizzare per l'emulatore Cloud Datastore (beta).
--env_var=...- Variabile di ambiente definita dall'utente per il processo di runtime locale. Ogni
env_varha il formato chiave=valore e puoi definire più variabili di ambiente. Oltre aenv_variablesinapp.yaml, questo flag consente di impostare variabili di ambiente aggiuntive per i processi locali. Ad esempio:--env_var KEY_1=val1 --env_var KEY_2=val2 --php_executable_path=...- Percorso del file binario php-cgi.
--php_gae_extension_path=...- Percorso del file binario gae_runtime_module.so.
--php_remote_debugging=yes|no- Imposta su yes per attivare il debug remoto con XDebug