Suggerimenti ed esempi di siti web statici

Questa pagina mostra esempi e suggerimenti per utilizzare i bucket per ospitare un sito web statico.

Pagine di specialità

Pagine dell'indice

Una pagina indice (chiamata anche indice della directory del server web) è un file che viene mostrato ai visitatori quando richiedono un URL a cui non è associato un file. Quando assegni una proprietà MainPageSuffix, Cloud Storage cerca un file con quel nome il cui prefisso corrisponde all'URL richiesto dal visitatore.

Ad esempio, supponiamo di impostare il MainPageSuffix del tuo sito web statico su index.html. Inoltre, supponiamo che non sia presente alcun file denominato directory nel bucket www.example.com. In questa situazione, se un utente richiede l'URLhttp://www.example.com/directory, Cloud Storage tenta di pubblicare il filewww.example.com/directory/index.html. Se anche questo file non esiste, Cloud Storage restituisce una pagina di errore.

MainPageSuffix controlla anche il file pubblicato quando gli utenti richiedono il sito di primo livello. Continuando con l'esempio precedente, se un utente richiede http://www.example.com, Cloud Storage tenta di pubblicare il file www.example.com/index.html.

Quando provi ad accedere a un URL con una barra finale, ad esempio http://www.example.com/dir/, consulta la sezione Risoluzione dei problemi.

Pagina di errore

La pagina di errore è il file restituito ai visitatori del tuo sito statico che richiedi un URL che non corrisponde a un file esistente. Se hai assegnato un MainPageSuffix, Cloud Storage restituisce la pagina di errore solo se non esiste un file con il nome richiesto né una pagina di indice applicabile.

Quando viene restituita una pagina di errore, il codice di risposta HTTP è 404. La proprietà che controlla quale file funge da pagina di errore è NotFoundPage. Se non impostate NotFoundPage, gli utenti riceveranno una pagina di errore generica.

Esempi di configurazione del sito web

Bucket di tre oggetti

Supponiamo che un bucket denominato www.example.com sia stato configurato come sito web con le seguenti impostazioni e file:

  • MainPageSuffix = "index.html"
  • NotFoundPage = "404.html"
  • Il bucket contiene tre oggetti condivisi pubblicamente: "index.html", "404.html" e "dir/index.html".

La seguente tabella mostra i contenuti pubblicati per gli URL selezionati:

URL richiesto Contenuti pubblicati Codice di risposta HTTP
http://www.example.com
http://www.example.com/
http://www.example.com/index.html
L'oggetto "index.html". 200
http://www.example.com/hello L'oggetto "404.html". 404
http://www.example.com/dir/index.html L'oggetto "dir/index.html". 200
http://www.example.com/dir L'oggetto "dir/index.html". 301
http://www.example.com/dir/ L'oggetto "dir/index.html", supponendo che non esista un oggetto di zero byte per /dir/ 200
Un oggetto vuoto di zero byte, se esistente per /dir/. Consulta l'argomento Risoluzione dei problemi per la rimozione di questo oggetto di zero byte. 301

Bucket con due oggetti

Supponiamo che un bucket denominato www.example.com sia stato configurato come sito web con le seguenti impostazioni e file:

  • MainPageSuffix = "main.html"
  • NotFoundPage = "404.html"
  • Il bucket contiene due oggetti condivisi pubblicamente: "main.html" e "404.html".

La seguente tabella mostra i contenuti pubblicati per gli URL selezionati:

URL richiesto Contenuti pubblicati Codice di risposta HTTP
http://www.example.com
http://www.example.com/
L'oggetto "main.html". 200
http://www.example.com/index.html L'oggetto "404.html". 404

Se un oggetto è condiviso pubblicamente, puoi anche visualizzarlo con l'URL:

http://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME

Ad esempio, l'URL di un oggetto index.html è:

http://storage.googleapis.com/www.example.com/index.html

Per ulteriori informazioni sull'utilizzo dei dati accessibili pubblicamente, consulta Accedere ai dati pubblici.

Suggerimenti per lavorare con un bucket configurato come sito web

Di seguito sono riportati alcuni suggerimenti da tenere a mente quando utilizzi un bucket per ospitare un sito web statico.

Aggiungere sottodomini

Supponiamo che tu voglia pubblicare contenuti anche all'URL test.example.com, da un bucket diverso da quello che pubblica contenuti all'URL www.example.com. Ecco come fare:

  1. Crea un nuovo bucket per pubblicare i contenuti aggiuntivi.

  2. Se hai seguito il tutorial Hosting a static website (Hospita un sito web statico) per pubblicare i contenuti tramite HTTPS, modifica il bilanciatore del carico nella console Google Cloud come segue:

    1. Per Configurazione del backend, crea un nuovo bucket di backend test-bucket selezionando il nuovo bucket che hai creato.
    2. Per Regole host e percorso, aggiungi una nuova regola come segue:
      Hosts                  Paths     Backends
      test.example.com       /*        test-bucket
      
    3. Per Configurazione frontend, aggiungi un nuovo IP e una nuova porta frontend con gli stessi valori della prima configurazione, con le seguenti eccezioni:

      • In Indirizzo IP, crea e prenota un nuovo indirizzo IP.
      • Per Certificato, crea un nuovo certificato SSL per test.example.com.
  3. Dopo aver aggiornato il bilanciatore del carico, aggiungi un nuovo record A al servizio di registrazione del dominio utilizzando l'indirizzo IP della nuova configurazione frontend:

    NAME                  TYPE     DATA
    test                  A        IP_ADDRESS
    

Comportamento dell'API

Le configurazioni dei siti web MainPageSuffix e NotFoundPage vengono utilizzate solo per le richieste che arrivano a Cloud Storage tramite un reindirizzamento CNAME o A. Ad esempio, una richiesta a www.example.com mostra la pagina dell'indice, ma una richiesta equivalente a storage.googleapis.com/www.example.com no.

Pertanto, il comportamento dell'API per le richieste ai domini Cloud Storage, comestorage.googleapis.com/www.example.com, viene mantenuto. Ad esempio, puoi continuare a elencare gli oggetti nel bucket www.example.com come faresti per qualsiasi altro bucket. Nel caso del bucket www.example.com, l'elenco di oggetti che ricevi include 404.html e index.html.

Ospitare asset statici per un sito web dinamico

Puoi utilizzare Cloud Storage per ospitare asset statici per un sito web dinamico ospitato, ad esempio, in Google App Engine o in Google Compute Engine. Ecco alcuni vantaggi dell'hosting degli asset statici, come immagini o file JavaScript, in un bucket:

  • Cloud Storage si comporta come una Content Delivery Network (CDN) perché gli oggetti leggibili pubblicamente vengono memorizzati nella cache nella rete Cloud Storage per impostazione predefinita.

  • I costi di banda per l'accesso ai contenuti in genere sono inferiori con Cloud Storage.

  • Il carico sui server web viene ridotto quando vengono pubblicati i contenuti statici da Cloud Storage.

Quando ospiti asset statici per un sito web dinamico, non devi creare record DNS e fare riferimento a un bucket o a un bilanciatore del carico come faresti per un sito web statico. Ad esempio, potresti avere un bucket denominato www_example_com_assets con asset appropriati configurati come condivisi pubblicamente e poi accedere a questi asset utilizzando il dominio Cloud Storage. Ad esempio, supponiamo che tu abbia il file JavaScript library.js nel bucket www_example_com_assets condiviso pubblicamente, quindi puoi accedervi come http://storage.googleapis.com/www_example_com_assets/library.js.

Imposta i parametri della cache

Puoi controllare in che modo o se le risorse del tuo sito web vengono memorizzate nella cache configurando i metadati Cache-Control. In genere, imposta i metadati di controllo della cache solo per gli oggetti accessibili a tutti gli utenti anonimi, un requisito per qualsiasi oggetto pubblicato da un bucket Cloud Storage all'interno di un sito web statico.

Cloud Storage applica un'impostazione di controllo della cache di 3600 secondi agli oggetti accessibili a tutti gli utenti anonimi, a meno che non vengano specificate impostazioni di controllo della cache esplicite. Per istruzioni su come impostare i metadati degli oggetti, come Cache-Control, consulta Visualizzazione e modifica dei metadati.

Puoi anche utilizzare Cloud CDN per memorizzare nella cache i contenuti HTTP(S) esterni bilanciati in base al carico vicino ai tuoi utenti, il che spesso riduce i costi di pubblicazione. Per ulteriori informazioni, consulta la sezione Memorizzazione nella cache.

Monitorare gli addebiti

Se pubblichi asset da un bucket configurato come sito web statico o se pubblichi asset statici da un bucket per un sito web dinamico ospitato al di fuori di Cloud Storage, devi monitorare gli addebiti al tuo progetto contenente il bucket. La pubblicazione di contenuti comporta costi di Cloud Storage per l'archiviazione dei contenuti, l'utilizzo della rete ed esecuzione di operazioni di recupero. Per maggiori dettagli, consulta la pagina dei prezzi di Cloud Storage.

Potresti anche sostenere costi di rete se utilizzi un bilanciatore del carico delle applicazioni esterno per configurare HTTPS. Per ulteriori dettagli, consulta la sezione Prezzi di utilizzo della rete.

L'esempio di prezzi semplice nella pagina degli esempi di prezzi può essere utilizzato come approssimazione per il caso d'uso di un sito web statico con traffico ridotto. Tieni presente, tuttavia, che l'esempio non tiene conto degli addebiti associati al bilanciatore del carico delle applicazioni esterno, che spesso può essere l'addebito più elevato per l'hosting di siti web statici. Puoi utilizzare il Calcolatore prezzi per generare una stima dei costi in base all'utilizzo previsto.

I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Se sei già un utente Google Cloud, puoi visualizzare una suddivisione dettagliata dei costi del tuo progetto nella pagina di fatturazione.

Risoluzione dei problemi

Consulta la sezione Risoluzione dei problemi per i problemi comuni associati all'utilizzo di un bucket configurato per la pubblicazione di contenuti di siti web statici.

Passaggi successivi

Provalo

Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud Storage in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Cloud Storage gratuitamente