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 quanto segue:
DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py -h
Opzioni comuni
Le opzioni più comuni sono le seguenti:
--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).
--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
0.0.0.0
consente 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
,error
ecritical
. --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_path
o--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_var
ha il formato chiave=valore e puoi definire più variabili di ambiente. Oltre aenv_variables
inapp.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
--go_debugging=yes|no
- Imposta su yes per attivare il debug con delve o gdb. Verrà creato il file binario dell'app con tutti i simboli necessari per il debug. Puoi collegarti normalmente al processo in esecuzione, ad esempio
sudo dlv attach <pid>
.