Eseguire Django nell'ambiente standard di App Engine

---

Le app Django in esecuzione su App Engine standard si adattano in modo dinamico in base al traffico.

Questo tutorial presuppone che tu abbia familiarità con lo sviluppo web di Django. Se non hai mai sviluppato con Django, ti consigliamo di leggere la sezione su come scrivere la tua prima app Django prima di continuare.

Sebbene questo tutorial mostri Django in modo specifico, puoi utilizzare questa procedura di deployment con altri framework basati su Django, come Wagtail e Django CMS.

Questo tutorial utilizza Django 4, che richiede almeno Python 3.8. App Engine standard supporta Python 3.7 e versioni successive, incluso Python 3.8.

Obiettivi

In questo tutorial, imparerai a:

• Crea e connetti un database Cloud SQL.
• Crea e utilizza i valori dei secret di Secret Manager.
• Esegui il deployment di un'app Django in App Engine standard.

Costi

In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:

• App Engine
• Cloud SQL
• Secret Manager

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud SQL Admin API, Secret Manager, and Cloud Build APIs.

   Enable the APIs

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

   Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud SQL Admin API, Secret Manager, and Cloud Build APIs.

   Enable the APIs

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

    Note: You can run the gcloud CLI in the Google Cloud console without installing the Google Cloud CLI. To run the gcloud CLI in the Google Cloud console, use Cloud Shell.
12. Se non l'hai ancora fatto, inizializza App Engine e seleziona la regione che preferisci:

    gcloud app create
    

prepara l'ambiente

Clona un'app di esempio

Il codice dell'app di esempio Django si trova nel repository GoogleCloudPlatform/python-docs-samples su GitHub.

1. Puoi scaricare l'esempio come file ZIP ed estrarlo o clonare il repository sulla tua macchina locale:

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
   

2. Vai alla directory che contiene il codice di esempio:

   Linux/macOS

   cd python-docs-samples/appengine/standard_python3/django
   

   Windows

   cd python-docs-samples\appengine\standard_python3\django
   

Verifica la configurazione di Python

Questo tutorial si basa su Python per eseguire l'applicazione di esempio sulla tua macchina. Il codice campione richiede anche l'installazione di dipendenze

Per maggiori dettagli, consulta la guida all'ambiente di sviluppo Python.

1. Verifica di avere almeno la versione 3.8 di Python.

    python -V
   

   Dovresti visualizzare Python 3.8.0 o una versione successiva.

   Nota: se vedi un numero di versione che inizia con "2", potrebbe essere necessario eseguire python3 anziché python. In questo caso, ricordati di fare riferimento all'installazione di Python scelta quando esegui i comandi python.

2. Crea un ambiente virtuale Python e installa le dipendenze:

   Linux/macOS

   python -m venv venv
   source venv/bin/activate
   pip install --upgrade pip
   pip install -r requirements.txt
   

   Windows

   python -m venv venv
   venv\scripts\activate
   pip install --upgrade pip
   pip install -r requirements.txt
   

Scarica il proxy di autenticazione Cloud SQL per connetterti a Cloud SQL dal computer locale

Nota: se stai completando questo tutorial da Cloud Shell, questa sezione non è obbligatoria.

Quando viene eseguita il deployment, l'app utilizza il proxy di autenticazione Cloud SQL integrato nell'ambiente standard di App Engine per comunicare con l'istanza Cloud SQL. Tuttavia, per testare l'app localmente, devi installare e utilizzare una copia locale del proxy nell'ambiente di sviluppo. Per ulteriori dettagli, consulta la guida al proxy di autenticazione Cloud SQL.

Il proxy di autenticazione Cloud SQL utilizza l'API Cloud SQL per interagire con l'istanza SQL. Per farlo, è necessaria l'autenticazione dell'applicazione tramite la CLI gcloud.

1. Autentica e acquisisci le credenziali per l'API:

   gcloud auth application-default login
   

2. Scarica e installa il proxy di autenticazione Cloud SQL sulla tua macchina locale.

   Linux a 64 bit

   1. Scarica il proxy di autenticazione Cloud SQL:

      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.linux.amd64
      

   2. Rendi eseguibile il proxy di autenticazione Cloud SQL:

      chmod +x cloud-sql-proxy
      

   Linux a 32 bit

   1. Scarica il proxy di autenticazione Cloud SQL:

      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.linux.386
      

   2. Se il comando curl non viene trovato, esegui sudo apt install curl e ripeti il comando di download.
   3. Rendi eseguibile il proxy di autenticazione Cloud SQL:

      chmod +x cloud-sql-proxy
      

   macOS a 64 bit

   1. Scarica il proxy di autenticazione Cloud SQL:

      curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.darwin.amd64
      

   2. Rendi eseguibile il proxy di autenticazione Cloud SQL:

      chmod +x cloud-sql-proxy
      

   Mac M1

   1. Scarica il proxy di autenticazione Cloud SQL:

        curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.darwin.arm64
        

   2. Rendi eseguibile il proxy di autenticazione Cloud SQL:

        chmod +x cloud-sql-proxy
        

   Windows a 64 bit

   Fai clic con il tasto destro del mouse su https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.x64.exe e seleziona Salva link come per scaricare il proxy di autenticazione Cloud SQL. Rinomina il file in cloud-sql-proxy.exe.

   Windows a 32 bit

   Fai clic con il tasto destro del mouse su https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.14.1/cloud-sql-proxy.x86.exe e seleziona Salva link come per scaricare il proxy di autenticazione Cloud SQL. Rinomina il file in cloud-sql-proxy.exe.

   Immagine Docker del proxy di autenticazione Cloud SQL

   Il proxy di autenticazione Cloud SQL ha immagini contenitore diverse, ad esempio distroless, alpine e buster. L'immagine del contenitore del proxy di autenticazione Cloud SQL predefinita utilizza distroless, che non contiene shell. Se hai bisogno di una shell o di strumenti correlati, scarica un'immagine basata su alpine o buster. Per ulteriori informazioni, consulta Immagini del contenitore del proxy di autenticazione Cloud SQL.

   Puoi eseguire il pull dell'immagine più recente sulla tua macchina locale utilizzando Docker con il seguente comando:

   docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.14.1
   

   Nota: il proxy di autenticazione Cloud SQL utilizza un repository che supporta il dominio gcr.io, ma pubblica le immagini da Artifact Registry. Per ulteriori informazioni, consulta la sezione Eseguire la transizione da Container Registry.

   Altro sistema operativo

   Per altri sistemi operativi non inclusi qui, puoi compilare il proxy di autenticazione Cloud SQL dal codice sorgente.

   Puoi scegliere di spostare il download in una posizione comune, ad esempio una posizione su PATH o nella home directory. Se scegli di farlo, quando avvii il proxy di autenticazione Cloud SQL più avanti nel tutorial, ricordati di fare riferimento alla posizione scelta quando utilizzi i comandi cloud-sql-proxy.

Crea servizi di supporto

Questo tutorial utilizza diversi servizi Google Cloud per fornire il database, lo spazio di archiviazione multimediale e lo spazio di archiviazione delle chiavi segrete che supportano il progetto Django di cui è stato eseguito il deployment. Questi servizi vengono implementati in una regione specifica. Per l'efficienza tra i servizi, tutti i servizi devono essere di cui viene eseguito il deployment nella stessa regione. Per ulteriori informazioni sulla regione più vicina a te, consulta Prodotti disponibili per regione.

Questo tutorial utilizza i meccanismi di hosting di asset statici integrati in App Engine standard.

Configura un'istanza Cloud SQL per PostgreSQL

Django supporta ufficialmente più database relazionali, ma offre il supporto più completo per PostgreSQL. PostgreSQL è supportato da Cloud SQL, pertanto questo tutorial sceglie di utilizzare questo tipo di database.

La sezione seguente descrive la creazione di un'istanza, un database e un utente di database PostgreSQL per l'app.

1. Crea l'istanza PostgreSQL:

   Console

   1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

      Vai alla pagina Istanze Cloud SQL

   2. Fai clic su Crea istanza.

   3. Fai clic su Scegli PostgreSQL.

   4. Per Versione SQL, scegli "Enterprise".

   5. Per Preimpostazione di modifica, scegli "Sandbox".

   6. Nel campo ID istanza, inserisci INSTANCE_NAME.

   7. Inserisci una password per l'utente postgres.

   8. Mantieni i valori predefiniti per gli altri campi.

   9. Fai clic su Crea istanza.

   L'istanza sarà pronta per l'uso dopo alcuni minuti.

   gcloud

   • Crea l'istanza PostgreSQL:

     gcloud sql instances create INSTANCE_NAME \
         --project PROJECT_ID \
         --database-version POSTGRES_16 \
         --tier db-n1-standard-2 \
         --region REGION
     

   Sostituisci quanto segue:

   • INSTANCE_NAME: il nome dell'istanza Cloud SQL
   • PROJECT_ID: l'ID progetto Google Cloud
   • REGION: la regione Google Cloud

   La creazione dell'istanza e la sua disponibilità sono operazioni che richiedono alcuni minuti.

2. All'interno dell'istanza creata, crea un database:

   Console

   1. Nella pagina dell'istanza, vai alla scheda Database.
   2. Fai clic su Crea database.
   3. Nella finestra di dialogo Nome database, inserisci DATABASE_NAME.
   4. Fai clic su Crea.

   gcloud

   • Crea il database nell'istanza creata di recente:

     gcloud sql databases create DATABASE_NAME \
         --instance INSTANCE_NAME
     

     Sostituisci DATABASE_NAME con un nome per il database all'interno dell'istanza.

3. Crea un utente di database:

   Nota: gli utenti creati in questo modo ottengono diritti aggiuntivi sul database. Per un metodo alternativo, consulta Limitare i privilegi degli utenti del database.

   Console

   1. Nella pagina dell'istanza, vai alla scheda Utenti.
   2. Fai clic su Aggiungi account utente.
   3. Nella finestra di dialogo Scegli la modalità di autenticazione, in "Autenticazione integrata":
   4. Inserisci il nome utente DATABASE_USERNAME.
   5. Inserisci la password DATABASE_PASSWORD
   6. Fai clic su Aggiungi.

   gcloud

   • Crea l'utente nell'istanza creata di recente:

     gcloud sql users create DATABASE_USERNAME \
         --instance INSTANCE_NAME \
         --password DATABASE_PASSWORD
     

     Sostituisci PASSWORD con una password sicura.

Memorizzare i valori dei secret in Secret Manager

Ora che i servizi di supporto sono configurati, Django ha bisogno di informazioni su questi servizi. Invece di inserire questi valori direttamente nel codice sorgente di Django, questo tutorial utilizza Secret Manager per archiviare queste informazioni in modo sicuro.

Crea il file di ambiente Django come secret di Secret Manager

Memorizza le impostazioni necessarie per avviare Django in un file env protetto. L'app di esempio utilizza l'API Secret Manager per recuperare il valore del segreto e il pacchetto django-environ per caricare i valori nell'ambiente Django. Il secret è configurato per essere accessibile da App Engine standard.

1. Crea un file denominato .env, che definisce la stringa di connessione al database, il nome del bucket multimediale e un nuovo valore SECRET_KEY:

   echo DATABASE_URL=postgres://DATABASE_USERNAME:DATABASE_PASSWORD@//cloudsql/PROJECT_ID:REGION:INSTANCE_NAME/DATABASE_NAME > .env
   echo GS_BUCKET_NAME=PROJECT_ID_MEDIA_BUCKET >> .env
   echo SECRET_KEY=$(cat /dev/urandom | LC_ALL=C tr -dc '[:alpha:]'| fold -w 50 | head -n1) >> .env
   

2. Archivia il secret in Secret Manager:

   Console

   1. Nella console Google Cloud, vai alla pagina Secret Manager.

      Vai alla pagina Secret Manager

   2. Fai clic su Crea secret.

   3. Nel campo Nome, inserisci django_settings.

   4. Nella finestra di dialogo Valore secret, incolla i contenuti del file .env.

   5. Fai clic su Crea secret.

   6. Elimina il file locale per evitare le sostituzione delle impostazioni locali.

   gcloud

   1. Crea un nuovo secret, django_settings, con il valore del file .env:

      gcloud secrets create django_settings --data-file .env
      

   2. Elimina il file locale per impedire le sostituzione delle impostazioni locali:

      rm .env
      

3. Configura l'accesso al secret:

   Console

4. Fai clic sulla scheda Autorizzazioni.

5. Fai clic su Concedi accesso.

6. Nel campo Nuovi membri, inserisci [e-mail] e premi Enter.

7. Nel menu a discesa Ruolo, seleziona Accesso ai segreti di Secret Manager.

8. Fai clic su Salva.

gcloud

1. Concedi l'accesso al secret al account di servizio standard di App Engine:

   gcloud secrets add-iam-policy-binding django_settings \
       --member serviceAccount:[e-mail] \
       --role roles/secretmanager.secretAccessor
   

Nell'output, verifica che bindings elenchi il nuovo account di servizio.

Esecuzione dell'applicazione nel computer locale

Con i servizi di supporto configurati, ora puoi eseguire l'app sul computer. Questa configurazione consente lo sviluppo locale, la creazione di un superutente e l'applicazione di migrazioni del database.

1. In un terminale separato, avvia il proxy di autenticazione Cloud SQL:

   Linux/macOS

   ./cloud-sql-proxy PROJECT_ID:REGION:INSTANCE_NAME
   

   Windows

   cloud-sql-proxy.exe PROJECT_ID:REGION:INSTANCE_NAME
   

   Questo passaggio stabilisce una connessione dal computer locale all'istanza Cloud SQL per scopi di test locale. Mantieni in esecuzione il proxy di autenticazione Cloud SQL per tutto il tempo in cui testi l'app in locale. L'esecuzione di questo processo in un terminale separato ti consente di continuare a lavorare durante l'esecuzione.

2. Nel terminale originale, imposta l'ID progetto localmente (utilizzato dall'API Secret Manager):

   Linux/macOS

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID
   

   Windows

   set GOOGLE_CLOUD_PROJECT=PROJECT_ID
   

3. Imposta una variabile di ambiente per indicare che utilizzi il proxy di autenticazione Cloud SQL (questo valore è riconosciuto nel codice):

   Linux/macOS

   export USE_CLOUD_SQL_AUTH_PROXY=true
   

   Windows

   set USE_CLOUD_SQL_AUTH_PROXY=true
   

4. Esegui le migrazioni di Django per configurare i modelli e gli asset:

   python manage.py makemigrations
   python manage.py makemigrations polls
   python manage.py migrate
   python manage.py collectstatic
   

5. Avvia il server web Django:

   python manage.py runserver 8080
   

6. Nel browser, vai alla pagina http://localhost:8080.

   Se sei in Cloud Shell, fai clic sul pulsante Anteprima web e seleziona Anteprima sulla porta 8080.

   La pagina mostra il seguente testo: "Hello, world. Ti trovi nell'indice dei sondaggi." Il server web Django in esecuzione sul computer carica le pagine dell'app di esempio.

7. Premi Ctrl/Cmd+C per interrompere il server web locale.

Utilizzare la Console di amministrazione di Django

Per accedere alla Console di amministrazione di Django, devi creare un superutente. Poiché hai una connessione accessibile localmente al database, puoi eseguire i comandi di gestione:

1. Crea un superutente. Ti verrà chiesto di inserire un nome utente, un indirizzo email e una password.

   python manage.py createsuperuser
   

2. Avvia un server web locale:

   python manage.py runserver
   

3. Nel browser, vai all'indirizzo http://localhost:8000/admin.

4. Accedi al sito di amministrazione utilizzando il nome utente e la password che hai utilizzato quando hai eseguito createsuperuser.

Nota: poiché sei connesso al tuo database Cloud SQL, accederai all'applicazione Django di cui è stato eseguito il deployment con le stesse credenziali.

Esegui il deployment dell'app nell'ambiente standard di App Engine

Dopo aver configurato tutti i servizi di supporto e aver testato l'applicazione localmente, ora puoi eseguire il deployment dell'app in App Engine standard:

1. Carica l'app eseguendo il seguente comando, che esegue il deployment dell'app come descritto in app.yaml e imposta la versione appena di cui è stato eseguito il deployment come predefinita, in modo che venga utilizzato per tutto il nuovo traffico:

   gcloud app deploy

2. Conferma le impostazioni digitando "yes" quando richiesto.
3. Attendi il messaggio che ti informa del completamento dell'aggiornamento.
4. Apri app.yaml e aggiorna il valore di APPENGINE_URL con l'URL di cui è stato eseguito il deployment:

   ...
   env_variables:
       APPENGINE_URL: https://PROJECT_ID.uc.r.appspot.com
   

5. Carica le modifiche alla configurazione:

   gcloud app deploy

Eseguire l'app di cui è stato eseguito il deployment

L'app è stata dispiata ed è ora accessibile:

• Apri il sito web di cui è stato eseguito il deployment:

  gcloud app browse
  

• In alternativa, visualizza l'URL e apri manualmente:

  gcloud app describe --format "value(defaultHostname)"
  

La richiesta viene gestita da un server web in esecuzione nell'ambiente standard di App Engine.

Aggiornamento dell'applicazione

Per aggiornare l'applicazione, apporta le modifiche al codice, quindi esegui di nuovo il comando gcloud app deploy.

Il deployment crea una nuova versione della tua app e la promuove a versione predefinita. Le versioni precedenti dell'app rimangono invariate. Tutte queste versioni dell'app sono risorse fatturabili. Per ridurre i costi, elimina le versioni non predefinite dell'app.

Configurazione per la produzione

Ora hai un deployment di Django funzionante, ma puoi eseguire ulteriori passaggi per assicurarti che la tua applicazione sia pronta per la produzione.

Disattivare il debug

Verifica che la variabile DEBUG in mysite/settings.py sia impostata su False. In questo modo, viene impedita la visualizzazione all'utente di pagine di errore dettagliate, che potrebbero rivelare informazioni sulle configurazioni.

Limita i privilegi degli utenti del database

Tutti gli utenti creati utilizzando Cloud SQL dispongono dei privilegi associati al ruolo cloudsqlsuperuser: CREATEROLE, CREATEDB e LOGIN.

Per impedire all'utente del database Django di disporre di queste autorizzazioni, crealo manualmente in PostgreSQL. Devi avere installato il psql terminale interattivo o utilizzare Cloud Shell, su cui questo strumento è preinstallato.

Console

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. In Cloud Shell, utilizza il terminale integrato per connetterti all'istanza INSTANCE_NAME:

   gcloud sql connect INSTANCE_NAME --user postgres
   

3. Inserisci la password dell'utente postgres.

   Al momento stai utilizzando psql. Dovresti visualizzare il prompt postgres=>.

4. Crea un utente:

   CREATE USER DATABASE_USERNAME WITH PASSWORD 'DATABASE_PASSWORD';
   

   Sostituisci PASSWORD con una password casuale e univoca.

5. Concedi i diritti completi sul nuovo database al nuovo utente:

   GRANT ALL PRIVILEGES ON DATABASE DATABASE_NAME TO DATABASE_USERNAME;
   

6. Uscita psql:

   \q
   

gcloud

Nota: tutti gli utenti creati utilizzando Cloud SQL dispongono dei privilegi associati al ruolo cloudsqlsuperuser:CREATEROLE, CREATEDB e LOGIN. Questo tutorial crea l'utente direttamente in PostgreSQL.

1. Avvia una connessione all'istanza SQL:

   gcloud sql connect INSTANCE_NAME --user postgres
   

   Sostituisci INSTANCE_NAME con l'istanza Cloud SQL creata.

2. Inserisci la password dell'utente postgres.

   Al momento stai utilizzando psql. Dovresti visualizzare il prompt postgres=>.

3. Crea un utente:

   CREATE USER DATABASE_USERNAME WITH PASSWORD 'DATABASE_PASSWORD';
   

4. Concedi i diritti completi sul nuovo database al nuovo utente:

   GRANT ALL PRIVILEGES ON DATABASE DATABASE_NAME TO DATABASE_USERNAME;
   

5. Uscita psql:

   \q
   

comprendi il codice

Applicazione di esempio

L'app di esempio Django è stata creata utilizzando gli strumenti Django standard. I seguenti comandi creano il progetto e l'app per i sondaggi:

django-admin startproject mysite
python manage.py startapp polls

Le visualizzazioni di base, i modelli e le configurazioni dei percorsi sono stati copiati da Scrivere la tua prima app Django (Parte 1 e Parte 2).

Secret di Secret Manager

Il file settings.py contiene il codice che utilizza l'API Python di Secret Manager per recuperare la versione più recente del segreto denominato e importarlo nell'ambiente (utilizzando django-environ):

env = environ.Env(DEBUG=(bool, False))
env_file = os.path.join(BASE_DIR, ".env")

if os.path.isfile(env_file):
    # Use a local secret file, if provided

    env.read_env(env_file)
# ...
elif os.environ.get("GOOGLE_CLOUD_PROJECT", None):
    # Pull secrets from Secret Manager
    project_id = os.environ.get("GOOGLE_CLOUD_PROJECT")

    client = secretmanager.SecretManagerServiceClient()
    settings_name = os.environ.get("SETTINGS_NAME", "django_settings")
    name = f"projects/{project_id}/secrets/{settings_name}/versions/latest"
    payload = client.access_secret_version(name=name).payload.data.decode("UTF-8")

    env.read_env(io.StringIO(payload))
else:
    raise Exception("No local .env or GOOGLE_CLOUD_PROJECT detected. No secrets found.")

Il segreto viene utilizzato per archiviare più valori segreti al fine di ridurre il numero di segreti diversi da configurare.

Configurazioni CSRF

Django ha una protezione integrata contro la falsificazione delle richieste tra siti (CSRF). A partire da Django 4.0, le modifiche al funzionamento di questa funzionalità rendono importante indicare a Django qual è l'URL in cui è ospitato, in modo che possa offrire le migliori protezioni per gli utenti che inviano dati.

Fornisci l'URL dell'app come variabile di ambiente nel file settings.py. Si tratta del valore utilizzato da Django per le impostazioni pertinenti.

# SECURITY WARNING: It's recommended that you use this when
# running in production. The URL will be known once you first deploy
# to App Engine. This code takes the URL and converts it to both these settings formats.
APPENGINE_URL = env("APPENGINE_URL", default=None)
if APPENGINE_URL:
    # Ensure a scheme is present in the URL before it's processed.
    if not urlparse(APPENGINE_URL).scheme:
        APPENGINE_URL = f"https://{APPENGINE_URL}"

    ALLOWED_HOSTS = [urlparse(APPENGINE_URL).netloc]
    CSRF_TRUSTED_ORIGINS = [APPENGINE_URL]
    SECURE_SSL_REDIRECT = True
else:
    ALLOWED_HOSTS = ["*"]

Sostituzioni di secret locali

Se nel file system locale viene trovato un file .env, viene utilizzato al posto del valore di Secret Manager. La creazione di un file .env localmente può essere utile per i test locali (ad es. lo sviluppo locale in un database SQLite o altre impostazioni locali).

Connessione al database

Il file settings.py contiene la configurazione del database SQL. Utilizza l'helper env.db() da django-environ per caricare la stringa di connessione impostata in DATABASE_URL nell'impostazione DATABASES.

Quando l'applicazione viene eseguita localmente e utilizzi il proxy di autenticazione Cloud SQL per accedere al database ospitato, il flag USE_CLOUD_SQL_AUTH_PROXY regola le impostazioni del database in modo da utilizzare il proxy.

# Use django-environ to parse the connection string
DATABASES = {"default": env.db()}

# If the flag as been set, configure to use proxy
if os.getenv("USE_CLOUD_SQL_AUTH_PROXY", None):
    DATABASES["default"]["HOST"] = "127.0.0.1"
    DATABASES["default"]["PORT"] = 5432

Contenuti statici ospitati

Il file app.yaml contiene informazioni di configurazione per il deployment in App Engine. Questo file app.yaml specifica che App Engine serve file statici dalla directory static/:

runtime: python39

env_variables:
  # This setting is used in settings.py to configure your ALLOWED_HOSTS
  # APPENGINE_URL: PROJECT_ID.uc.r.appspot.com

handlers:
# This configures Google App Engine to serve the files in the app's static
# directory.
- url: /static
  static_dir: static/

# This handler routes all requests not caught above to your main app. It is
# required when static routes are defined, but can be omitted (along with
# the entire handlers section) when there are no static files defined.
- url: /.*
  script: auto

Quando l'app viene eseguita localmente con DEBUG abilitato, questi file vengono pubblicati localmente da Django:

from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path("", include("polls.urls")),
    path("admin/", admin.site.urls),
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il progetto

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività descritte in questo documento, quando lo elimini elimini anche tutto il lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, il riuso dei progetti può aiutarti a non superare i limiti di quota.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi

• Scopri come configurare PostgreSQL per la produzione
• Scopri di più su Django su Google Cloud