Utilizzo del server di sviluppo locale

Go Java Node.js PHP Python Ruby

Nota: non puoi utilizzare l'ultima versione di dev_appserver.py per eseguire localmente le tue applicazioni per runtime che hanno raggiunto la fine del supporto. Per continuare a utilizzare una versione archiviata di dev_appserver.py, consulta Utilizzare il server di sviluppo locale dopo il termine del supporto dei runtime.

Google Cloud CLI include un server di sviluppo locale (dev_appserver.py). Puoi utilizzare il server di sviluppo locale per simulare l'esecuzione dell'applicazione App Engine in produzione, nonché per accedere ai servizi in bundle legacy di App Engine. L'ambiente simulato applica alcune limitazioni della sandbox, come le funzioni di sistema e le importazioni di moduli di linguaggio di runtime limitate, ma non altre, come i timeout delle richieste o le 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 attività localmente. Quando l'applicazione è in esecuzione nel server di sviluppo, puoi comunque effettuare chiamate API remote all'infrastruttura di produzione utilizzando gli endpoint HTTP delle API di Google.

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 3 compatibile con la versione di Python richiesta da gcloud CLI.

2. Verifica di aver installato il componente Google Cloud CLI che include l'estensione App Engine per Python 3 (app-engine-python):

   gcloud components list
   

   Se il componente app-engine-python non è installato, esegui il seguente comando:

   gcloud components install app-engine-python
   

3. Individua il percorso di installazione di Google Cloud SDK eseguendo il seguente comando:

   gcloud info
   

   Il comando restituisce la directory radice in cui hai installato Google Cloud SDK, ad esempio:

   Installation Root: [/Users/myname/google-cloud-sdk]

4. Individua lo strumento dev_appserver.py nella cartella /bin/ in cui hai installato Google Cloud CLI, ad esempio:

   CLOUD_SDK_ROOT/bin/dev_appserver.py
   

5. Prendi nota del percorso del dev_appserver.py per dopo.

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 l'app in locale.

Per avviare il server di sviluppo locale:

Ora il server di sviluppo locale è in esecuzione e rimane in attesa delle richieste. Puoi visitare http://localhost:8080/ nel browser web per vedere l'app in azione.

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

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

• macOS o Linux: Control+C
• Windows: Control+Interrompi

Specifica gli ID applicazione

Rilevare l'ambiente di runtime dell'applicazione

Utilizzare il servizio Mail

Il server di sviluppo locale può inviare email per le chiamate al servizio di posta 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, richiama dev_appserver.py come segue:

python3 [CLOUD_SDK_ROOT]/bin/dev_appserver.py --smtp_host=smtp.example.com --smtp_port=25 \
    --smtp_user=ajohnson --smtp_password=k1tt3ns [PATH_TO_YOUR_APP]

dove imposti le opzioni --smtp_host, --smtp_port, --smtp_user e --smtp_password con i tuoi valori.

Utilizzo di Sendmail

Per abilitare il supporto della posta con Sendmail, richiama dev_appserver.py come segue:

python3 [CLOUD_SDK_ROOT]/bin/dev_appserver.py --enable_sendmail=yes [PATH_TO_YOUR_APP]

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

Nota: se non richiami dev_appserver.py con SMTP o Sendmail come descritto, i tentativi di invio di email dalla tua applicazione non avranno effetto, ma l'operazione verrà visualizzata come riuscita nell'applicazione.

Utilizzare il servizio di recupero URL

Quando l'applicazione utilizza l'API URL Fetch per effettuare una richiesta HTTP, il server di sviluppo locale effettua la richiesta direttamente dal computer. Il comportamento di recupero URL sul server locale potrebbe differire da quello di produzione di App Engine se utilizzi un server proxy per accedere ai siti web.

Utilizzare il servizio utenti

App Engine fornisce un servizio Users 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 disconnessione.

Argomenti della riga di comando

Per le opzioni del comando del server di sviluppo locale, vedi Opzioni del server di sviluppo locale.