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 ulteriori informazioni sui test locali, consulta Utilizzo del server di sviluppo locale.
Configurazione dello 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 root
da 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 questo comando:
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 (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).
--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à attività push. --help
- Stampa un messaggio utile, poi si chiude.
--host=...
- L'indirizzo host da utilizzare per il server. Potrebbe essere necessario impostarlo per accedere al server di sviluppo da un altro computer sulla rete. Un indirizzo
0.0.0.0
consente sia l'accesso localhost sia l'accesso IP o nome host. Il valore predefinito èlocalhost
. --log_level=...
- Il livello di logging inferiore a cui i messaggi di logging verranno scritti nella console; verranno generati messaggi con il 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 le porte successive, ad esempio8081
e8082
. --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 i log siano disponibili durante i riavvii del server.
Devi specificare il percorso e il nome della directory a 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
. Invece, quando l'applicazione esegue una query che richiede la definizione del suo indice nel file e la definizione dell'indice non viene trovata, viene generata un'eccezione, simile a ciò che accadrebbe durante l'esecuzione su App Engine. Il valore predefinito èno
. --runtime_python_path=...
- Il percorso del programma binario Python 3. Per eseguire un'app Python 3 su
dev_appserver
, specifica questo flag.
--smtp_host=...
- Il nome host del server SMTP da utilizzare per inviare i 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 inviare 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, come Datastore, Blobstore, file e log di Cloud Storage, a meno che non venga sostituito da
--datastore_path
,--blobstore_path
o--logs_path
. --support_datastore_emulator=yes|no
- Utilizza l'emulatore di Cloud Datastore (beta) per l'emulazione del datastore locale.
--datastore_emulator_port=...
- Il numero di porta da utilizzare per l'emulatore di 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_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