Nota: Go 1.11 ha raggiunto la fine del supporto il 30 gennaio 2024. Le applicazioni Go 1.11 esistenti continueranno a essere eseguite e a ricevere traffico. Tuttavia, App Engine potrebbe bloccare il ri deployment di applicazioni che utilizzano runtime dopo la data di fine del supporto. Ti consigliamo di eseguire la migrazione all'ultima versione supportata di Go.

Archiviazione e pubblicazione di file statici

Le applicazioni spesso devono pubblicare file statici come JavaScript, immagini e CSS, oltre a gestire le richieste dinamiche. Le app nell'ambiente standard possono pubblicare file statici da un'opzione di Google Cloud come Cloud Storage, pubblicarli direttamente o utilizzare una rete CDN (Content Delivery Network) di terze parti.

L'hosting del tuo sito statico su Google Cloud può costare meno rispetto all'utilizzo di un provider host tradizionale, poiché Google Cloud offre un livello gratuito.

File per la pubblicazione da Cloud Storage

Cloud Storage può ospitare asset statici per app web dinamiche. I vantaggi dell'utilizzo di Cloud Storage invece di pubblicare direttamente dall'app includono:

Cloud Storage funziona essenzialmente come una rete CDN (Content Delivery Network). Ciò non richiede alcuna configurazione speciale perché, per impostazione predefinita, qualsiasi oggetto leggibile viene memorizzato nella cache della rete globale di Cloud Storage.
Il carico della tua app verrà ridotto riducendo il carico di lavoro degli asset statici in Cloud Storage. A seconda del numero di asset statici di cui disponi e della frequenza degli accessi, questo può ridurre notevolmente i costi di esecuzione dell'app.
I costi per la larghezza di banda per l'accesso ai contenuti spesso sono inferiori con Cloud Storage.

Puoi caricare gli asset in Cloud Storage utilizzando lo strumento a riga di comando gsutil o l'API Cloud Storage.

La libreria client di Google Cloud fornisce un client Go 1.11 idiomatico per Cloud Storage, per l'archiviazione e il recupero dei dati con Cloud Storage in un'app App Engine.

Esempio di gestione da un bucket Cloud Storage

Questo semplice esempio crea un bucket Cloud Storage e carica asset statici utilizzando Google Cloud CLI:

Creare un bucket. È comune, ma non obbligatorio, denominare il bucket in base all'ID progetto. Il nome del bucket deve essere univoco a livello globale.
```
gsutil mb gs://<your-bucket-name>
```
Imposta l'ACL per concedere l'accesso in lettura agli elementi nel bucket.
```
gsutil defacl set public-read gs://<your-bucket-name>
```
Caricare elementi nel bucket. Il comando rsync è in genere il modo più semplice e veloce per caricare e aggiornare gli asset. Puoi anche utilizzare cp.
```
gsutil -m rsync -r ./static gs://<your-bucket-name>/static
```

Ora puoi accedere alle tue risorse statiche tramite https://storage.googleapis.com/<your-bucket-name>/static/....

Per maggiori dettagli su come utilizzare Cloud Storage per pubblicare asset statici, incluso come pubblicare da un nome di dominio personalizzato, consulta Come ospitare un sito web statico.

File per la pubblicazione da altri servizi Google Cloud

Hai inoltre la possibilità di utilizzare Cloud CDN o altri servizi di archiviazione di Google Cloud.

Pubblicazione dei file direttamente dall'app

Per pubblicare file statici per Go 1.11 nell'ambiente standard, devi definire i gestori nel file app.yaml utilizzando gli elementi static_dir o static_files.

I contenuti dei file statici o delle directory statiche non sono interessati dalle impostazioni di scalabilità del file app.yaml. Le richieste a file o directory statiche vengono gestite direttamente dall'infrastruttura App Engine e non raggiungono il runtime del linguaggio dell'applicazione.

Configurazione dei gestori di file statici

Per configurare la tua app in modo che gestisca la directory ./public dall'URL /static, definisci un gestore nel file app.yaml.

Di seguito viene illustrato come gestire i file statici della directory ./public di un'app di esempio. Il modello per la pagina index.html di questa app indica al browser di caricare il file main.css, ad esempio:

<link type="text/css" rel="stylesheet" href="/static/css/main.css">

La directory ./public è definita nell'elemento static_dir del file app.yaml del progetto:

handlers:
  - url: /favicon\.ico
    static_files: favicon.ico
    upload: favicon\.ico

  - url: /static
    static_dir: public

  - url: /.*
    secure: always
    redirect_http_response_code: 301
    script: auto

La sezione handlers dell'esempio sopra riportato gestisce tre pattern URL:

Il gestore /favicon.ico mappa una richiesta specifica per /favicon.ico a un file denominato favicon.ico nella directory root dell'app.
Il gestore /static mappa le richieste di URL che iniziano con /static. Quando App Engine riceve una richiesta per un URL che inizia con /static, mappa il resto del percorso ai file nella directory ./public. Se nella directory viene individuato un file appropriato, i contenuti di tale file vengono restituiti al client.
Il gestore /.* corrisponde a tutti gli altri URL e li indirizza alla tua app.

I pattern dei percorsi degli URL vengono testati nell'ordine in cui appaiono in app.yaml, pertanto il pattern per i file statici deve essere definito prima del pattern /.*. Per ulteriori informazioni, consulta il riferimento app.yaml.

Pubblicazione da una rete CDN (Content Delivery Network) di terze parti

Puoi utilizzare qualsiasi CDN di terze parti esterna per gestire i file statici e memorizzare nella cache le richieste dinamiche, ma la tua app potrebbe riscontrare latenza e costi maggiori.

Per migliorare le prestazioni, devi utilizzare una CDN di terze parti che supporta CDN Interconnect.