Utilizzo del server di sviluppo locale

Puoi utilizzare il server di sviluppo locale per simulare per eseguire l'applicazione App Engine in produzione e per utilizzarla per accedere ai servizi in bundle di App Engine.

L'ambiente simulato applica alcune limitazioni della sandbox, ad esempio di funzioni di sistema e di moduli Go 1.11, ma non per altri, come timeout delle richieste o quote.

Il server di sviluppo locale simula anche i servizi forniti dalle librerie nell'SDK per App Engine, tra cui Datastore, Memcache e Task Queues, eseguendo le relative attività localmente. Quando l'applicazione è in esecuzione sul server di sviluppo, puoi comunque effettuare chiamate API remote all'infrastruttura di produzione utilizzando gli endpoint HTTP delle API Google.

Prima di iniziare

Poiché Go 1.11 è arrivato alla fine del supporto, non puoi più utilizzare l'ultima versione di dev_appserver.py per eseguire localmente diverse applicazioni. Per scaricare una versione archiviata di devapp_server.py: passaggi:

  1. Dall'archivio, scarica la cartella compressa contenente il dev_appserver.py server per i runtime che hanno raggiunto il termine del supporto.

  2. Estrai il contenuto della directory nel file system locale, ad esempio nella directory /home. Puoi trovare dev_appserver.py nella directory google_appengine/.

Configura il server di sviluppo locale

Per eseguire lo strumento del server di sviluppo locale, devi configurare quanto segue:

  1. Verifica di aver installato un interprete Python 2 della versione 2.7.12 o successiva.

  2. Imposta la variabile di ambiente DEVAPPSERVER_ROOT nella shell sul percorso dell'interprete Python 2.

Esegui il server di sviluppo locale

Dopo aver configurato il server di sviluppo locale e creato il file di configurazione app.yaml per la tua app, puoi utilizzare il comando dev_appserver.py per eseguire la tua app localmente.

Per avviare il server di sviluppo locale:

  1. Nella directory che contiene il file di configurazione app.yaml, esegui il comando dev_appserver.py.

    dev_appserver.py

    Specifica il percorso della directory dell'app, ad esempio:

    python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py PATH_TO_YOUR_APP

    In alternativa, puoi specificare il file di configurazione di una ad esempio:

    python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py app.yaml

    Per cambiare la porta, includi l'opzione --port:

    python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --port=9999 PATH_TO_YOUR_APP

    Sostituisci DEVAPPSERVER_ROOT con il percorso della cartella in cui estrarre la versione archiviata di devapp_server.py.

    servizio goapp

    Il comando goapp serve è incluso nell'SDK App Engine per Go originale e racchiude lo strumento Python dev_appserver.py sottostante. Per avviare il server di sviluppo locale, esegui:

      goapp serve

    Per scoprire di più sulle opzioni del comando dev_appserver.py, consulta Opzioni del server di sviluppo locale.

  2. Il server di sviluppo locale è ora in esecuzione e rimane in ascolto delle richieste. Puoi visitare la pagina http://localhost:8080/ nel tuo browser web per vedere l'app in azione.

    Se hai specificato una porta personalizzata con l'opzione --port, ricordati di aprire il browser su quella porta.

Per arrestare il server locale dalla riga di comando, premi quanto segue:

  • macOS o Linux: Ctrl+C
  • Windows: Ctrl+Interruzione

Specifica gli ID applicazione

Per accedere al tuo ID app nel server locale, ad esempio per eseguire lo spoofing di un'email , utilizza appengine.AppID personalizzata. Per trovare il nome host dell'app in esecuzione, usa la appengine.DefaultVersionHostname personalizzata.

Rilevamento dell'ambiente di runtime dell'applicazione in corso...

Per determinare se il codice viene eseguito in produzione o nel server di sviluppo locale, puoi chiamare il metodo IsDevAppServer(). Se il valore è true, il codice viene eseguito nell'ambiente di sviluppo locale. In caso contrario, l'esecuzione avviene in produzione.


package devserver

import (
	"fmt"
	"net/http"

	"google.golang.org/appengine"
)

func init() {
	http.HandleFunc("/", handler)
}

func handler(w http.ResponseWriter, r *http.Request) {
	fmt.Fprintf(w, "IsDevAppServer: %v", appengine.IsDevAppServer())
}

Utilizzo di Datastore locale

Il server di sviluppo locale simula il datastore di App Engine utilizzando un file locale che persiste tra le invocazioni del server locale.

Per saperne di più sugli indici e sui index.yaml, consulta Indici datastore e Indice Datastore Configurazione.

Sfogliare il Datastore locale

Se la tua app ha scritto dati nel tuo Datastore locale utilizzando lo sviluppo locale puoi consultarlo nella console di sviluppo locale.

Per sfogliare Datastore locale:

  1. Avvia il server di sviluppo.

  2. Accedi a Visualizzatore Datastore nella console di sviluppo locale. L'URL è http://localhost:8000/datastore.

  3. Visualizzare i contenuti locali di Datastore.

Specifica il criterio di allocazione degli ID

Per App Engine di produzione, puoi impostare Datastore su generare automaticamente gli ID entità.

Sebbene i criteri di assegnazione automatica degli ID per il server di produzione completamente diverse da quelle usate dal server di sviluppo, puoi anche il criterio di allocazione automatica degli ID per il server locale.

Per specificare il criterio di assegnazione automatica degli ID, utilizza l'--auto_id_policy :

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --auto_id_policy=sequential

Sostituisci:

  • DEVAPPSERVER_ROOT con il percorso della cartella in cui estrarre la versione archiviata di devapp_server.py.

  • --auto_id_policy con uno dei seguenti dispositivi:

    • scattered quando gli ID (predefinito) vengono assegnati da una sequenza non ripetuta di numeri interi distribuiti approssimativamente in modo uniforme.
    • sequential quando gli ID vengono assegnati dalla sequenza di numeri interi consecutivi.

Cancellare il datastore locale

Per cancellare il datastore locale di un'applicazione, invoca il server di sviluppo locale come segue:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --clear_datastore=yes app.yaml

Sostituisci DEVAPPSERVER_ROOT con il percorso della cartella in cui estrarre la versione archiviata di devapp_server.py.

Modifica la località Datastore locale

Per modificare la posizione utilizzata per il file del data store, utilizza l'opzione --datastore_path:

python2 DEVAPPSERVER_ROOT/google_appengine/dev_appserver.py --datastore_path=/tmp/myapp_datastore app.yaml

Sostituisci DEVAPPSERVER_ROOT con il percorso della cartella in cui Estrai la versione archiviata di devapp_server.py.

Utilizzare il servizio Utenti

App Engine fornisce un servizio Utenti per semplificare l'autenticazione e l'autorizzazione per la tua applicazione. Il server di sviluppo locale simula il comportamento degli Account Google con le proprie pagine di accesso e di uscita. Mentre corri con di sviluppo software, LoginURL e LogoutURL restituiscono URL per /_ah/login e /_ah/logout sul server locale.

Utilizza Mail

Il server di sviluppo locale può inviare email per le chiamate al servizio email di App Engine utilizzando un server SMTP o un'installazione locale di Sendmail.

Utilizzo di SMTP

Per attivare il supporto della posta con un server SMTP, invoca dev_appserver.py come segue:

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --smtp_host=smtp.example.com --smtp_port=25 \
    --smtp_user=ajohnson --smtp_password=k1tt3ns [PATH_TO_YOUR_APP]

Sostituisci:

  • [DEVAPPSERVER_ROOT] con il percorso della cartella in cui estrarre la versione archiviata di devapp_server.py.
  • Opzioni --smtp_host, --smtp_port, --smtp_user e --smtp_password con i tuoi valori di configurazione.

Utilizzo di Sendmail

Per attivare il supporto della posta con Sendmail, invoca dev_appserver.py come segue:

   python2 [DEVAPPSERVER_ROOT]/google_appengine/dev_appserver.py --enable_sendmail=yes [PATH_TO_YOUR_APP]

Sostituisci [DEVAPPSERVER_ROOT] con il percorso della cartella in cui Estrai la versione archiviata di devapp_server.py.

Il server locale utilizzerà il comando sendmail per inviare messaggi email con configurazione predefinita dell'installazione.

Utilizzare il recupero URL

Quando la tua applicazione utilizza l'API di recupero URL per effettuare una richiesta HTTP, il server di sviluppo locale effettua la richiesta direttamente dal tuo computer. La Il comportamento di recupero dell'URL sul server locale potrebbe essere diverso dall'ambiente di produzione App Engine se utilizzi un server proxy per accedere ai siti web.