Il server di sviluppo locale (dev_appserver.py) fa parte dei componenti App Engine di gcloud CLI. Questo argomento fornisce informazioni avanzate sull'utilizzo di dev_appserver.py.
Per saperne di più sui test locali, consulta la sezione Utilizzo del 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 Utilizzo del 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 comando seguente:
DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py -h
Opzioni comuni
Le opzioni più comuni sono le seguenti:
--auto_id_policy=...- Deprecato. Come l'archivio dati 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 (impostazione predefinita: localhost).
--admin_port=ADMIN_PORT- Porta a cui deve essere associata la console di amministrazione del server di sviluppo locale (impostazione predefinita: 8000).
--clear_datastore=yes|no- Cancella i dati del datastore e i file della cronologia 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 le attività push. Il valore predefinito è
yes. Se specifichino, il server non eseguirà 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 l'accesso sia a localhost sia tramite IP o nome host. Il valore predefinito èlocalhost. --log_level=...- Il livello di logging più basso in cui i messaggi di logging verranno scritti nella
console; verranno generati 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 anche dopo il riavvio del server.
Devi specificare il percorso e il nome della directory di un file di database SQLite. Se il file non esiste già, viene creato un file di database SQLite con il nome specificato. Ad esempio:
--logs_path=/home/logs/boglogs.db --require_indexes=yes|no- Disattiva la generazione automatica di voci nel file
index.yaml. Al contrario, quando l'applicazione esegue una query che richiede che il suo indice sia definito nel file e la definizione dell'indice non viene trovata, viene generata un'eccezione, in modo 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=...- Il percorso in cui verranno archiviati tutti i file locali, come Datastore, Blobstore, i file e i log di Cloud Storage, a meno che non venga sostituito da
--datastore_path,--blobstore_patho--logs_path. --support_datastore_emulator=yes|no- Utilizza l'emulatore Cloud Datastore (beta) per l'emulazione locale di Datastore.
--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_varè nel 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 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