Suggerimenti ed esempi di siti web statici

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

Pagine di specialità

Pagine 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, supponi di impostare MainPageSuffix del tuo sito web statico su index.html. Inoltre, supponiamo che tu non abbia file con il nome directory nel tuo 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 primo di livello del sito. Continuando con l'esempio precedente, se un utente richiede http://www.example.com, Cloud Storage tenta di gestire 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à determina quale file agisce perché la pagina di errore è NotFoundPage. In caso contrario imposta NotFoundPage, gli utenti ricevono 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 impostazioni e i file seguenti:

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

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 con 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 visualizza quell'oggetto 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 di dati pubblicamente accessibili, vedi Accesso ai dati pubblici.

Suggerimenti per utilizzare un bucket configurato come sito web

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

Aggiungi 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 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 stessi valori della prima configurazione, con le seguenti eccezioni:

      • In Indirizzo IP, crea e prenota un nuovo indirizzo IP.
      • In Certificato, crea un nuovo certificato SSL per test.example.com.
  3. Dopo aver aggiornato il bilanciatore del carico, aggiungi un nuovo record A al tuo dominio servizio di registrazione 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 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. Alcuni vantaggi dell'hosting di asset statici come immagini o file JavaScript, in un bucket includono:

  • 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 larghezza di banda per l'accesso ai contenuti in genere sono inferiori con Cloud Storage.

  • Il carico sui server web viene ridotto quando si offrono contenuti statici da di archiviazione ideale in 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 che è condiviso pubblicamente, potrai accedervi come http://storage.googleapis.com/www_example_com_assets/library.js.

Imposta parametri 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, impostano solo i metadati di controllo della cache per gli oggetti accessibili a tutti gli utenti anonimi, che è un requisito per qualsiasi oggetto gestito da un bucket Cloud Storage come parte di un sito web.

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.

Potrebbero esserti addebitati costi di rete anche se utilizzi un bilanciatore del carico delle applicazioni esterno per configurare HTTPS. Per ulteriori dettagli, consulta i prezzi della rete.

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

I nuovi utenti Google Cloud potrebbero hai diritto a 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