Scopri come pubblicare in modo sicuro contenuti statici come file HTML, CSS e immagini dell'ambiente standard di Google App Engine.
Prima di iniziare
Configura l'ambiente di sviluppo e crea il progetto App Engine.
Se utilizzi un nome di dominio personalizzato per il tuo sito web, segui le istruzioni per aggiungere un dominio personalizzato al tuo progetto.
Pubblicazione di una pagina web
App Engine può pubblicare contenuti statici come pagine HTML e contenuti multimediali come immagini. I contenuti statici sono tutti i contenuti che non verranno eseguiti come JSP o Servlet.
L'esempio seguente è una pagina HTML di base in cui viene visualizzato un messaggio di benvenuto.
<!DOCTYPE html>
<html>
<head>
<title>The App Engine Blog</title>
</head>
<body>
<h1>Welcome to the App Engine Blog</h1>
<p>This is being served by App Engine!</p>
</body>
</html>
Dove posizionare i file statici
Devi inserire i file statici pubblicati nella directory webapp
dell'app. Tu
possono utilizzare le cartelle, ma ricorda che tutti i percorsi e gli URI dei file sono relativi
Directory webapp
.
Dopo aver scelto una posizione per i file statici, devi definirne la posizione nel file appengine-web.xml
utilizzando l'elemento <static-files>
.
Nell'esempio seguente, una configurazione appengine-web.xml
di base tratta tutti i file HTML nella directory webapp
come file statici.
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
<threadsafe>true</threadsafe>
<runtime>java8</runtime>
<static-files>
<include path="/**.html" >
</include>
</static-files>
</appengine-web-app>
Puoi avere più elementi <include path>
che fanno riferimento a directory e tipi di file diversi. Espansione dell'esempio precedente:
<static-files>
<include path="/**.html" >
</include>
<include path="/images/**.jpg" >
</include>
</static-files>
Ora tutti i file con estensione .jpg
nella directory webapp/images/
verranno trattati come file statici.
Nell'esempio precedente, se vogliamo visualizzare logo.jpg
dal
webapp/images
, il tag <img>
avrà l'URI di origine
<img src="/images/logo.jpg">
.
Imposizione di HTTPS per tutti i contenuti statici
Sebbene App Engine supporti la distribuzione di contenuti tramite HTTP o HTTPS,
dovresti utilizzare HTTPS. Per configurare
URL protetti,
devi aggiungere un elemento <security-constraint>
alla classe
web.xml
. Ecco un esempio di <security-constraint>
:
<security-constraint>
<web-resource-collection>
<web-resource-name>blog</web-resource-name>
<url-pattern>/*</url-pattern>
</web-resource-collection>
<user-data-constraint>
<transport-guarantee>CONFIDENTIAL</transport-guarantee>
</user-data-constraint>
</security-constraint>
Utilizzando <transport-guarantee>CONFIDENTIAL</transport-guarantee>
, tutte le richieste
vengono reindirizzati automaticamente all'URI HTTPS dei contenuti statici.
Deployment in App Engine
Puoi eseguire il deployment della tua app in App Engine utilizzando Maven.
Vai alla directory root del progetto e digita:
mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID
Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud. Se il tuo file pom.xml
specifica già il tuo ID progetto, non devi includere la proprietà -Dapp.deploy.projectId
nel comando eseguito.
Dopo che Maven ha implementato la tua app, apri automaticamente una scheda del browser web nella nuova app digitando:
gcloud app browse
Passaggi successivi
I file statici possono essere utilizzati per pubblicare immagini, fogli di stile CSS e contenuti HTML statici tramite App Engine. Per ampliare le tue conoscenze, ti consigliamo di Scopri come gestire i dati utente tramite moduli HTML.