Apprenez à diffuser du contenu statique en toute sécurité, tel que des fichiers HTML, des feuilles de style CSS et des images à partir de l'environnement standard Google App Engine.
Avant de commencer
Configurez votre environnement de développement et créez un projet App Engine.
Si vous utilisez un nom de domaine personnalisé pour votre site Web, suivez les instructions pour ajouter un domaine personnalisé à votre projet.
Diffuser une page Web
App Engine peut diffuser du contenu statique comme les pages HTML et du contenu multimédia tel que les images. Le contenu statique est tout ce qui n'est pas exécuté en tant que fichier JSP ou servlet.
L'exemple suivant est une page HTML de base qui affiche un message de bienvenue.
<!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>
Où placer les fichiers statiques
Vous devez placer vos fichiers statiques diffusés dans le répertoire webapp de votre application. Vous pouvez utiliser des dossiers, mais n'oubliez pas que tous les chemins d'accès aux fichiers et tous les URI sont relatifs au répertoire webapp.
Après avoir choisi un emplacement pour les fichiers statiques, vous devez définir leur emplacement dans le fichier appengine-web.xml, à l'aide de l'élément <static-files>.
Dans l'exemple ci-dessous, une configuration appengine-web.xml de base traite tous les fichiers HTML du répertoire webapp comme des fichiers statiques.
<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>
Vous pouvez avoir plusieurs éléments <include path> faisant référence à différents répertoires et différents types de fichiers. Développons l'exemple précédent :
<static-files>
<include path="/**.html" >
</include>
<include path="/images/**.jpg" >
</include>
</static-files>
Désormais, tous les fichiers portant l'extension .jpg dans le répertoire webapp/images/ seront traités comme des fichiers statiques.
Dans l'exemple ci-dessus, si vous souhaitez afficher logo.jpg à partir du répertoire webapp/images, le tag <img> aura l'URI source <img src="/images/logo.jpg">.
Forcer HTTPS pour tous les contenus statiques
Bien que la diffusion de contenu via HTTP ou HTTPS soit possible avec App Engine, vous devez utiliser HTTPS. Pour configurer des URL sécurisées, vous devez ajouter un élément <security-constraint> au fichier web.xml de votre projet. Voici un exemple d'élément <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>
Si vous utilisez l'élément <transport-guarantee>CONFIDENTIAL</transport-guarantee>, toutes les requêtes sont automatiquement redirigées vers l'URI HTTPS du contenu statique.
Déployer sur App Engine
Vous pouvez déployer votre application sur App Engine à l'aide de Maven.
Accédez au répertoire racine de votre projet, puis saisissez la commande suivante :
mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID
Remplacez PROJECT_ID par l'ID de votre projet Google Cloud. Si votre ID de projet est déjà inclus dans le fichier pom.xml, vous n'avez pas besoin d'inclure la propriété -Dapp.deploy.projectId dans la commande que vous exécutez.
Lorsque Maven a déployé votre application, saisissez la commande ci-dessous pour ouvrir un onglet de navigateur Web automatiquement dans votre nouvelle application :
gcloud app browse
Étape suivante
Les fichiers statiques peuvent servir à diffuser des images, des feuilles de style CSS et du contenu HTML statique via App Engine. Pour approfondir vos connaissances, vous pouvez consulter la page sur la gestion des données utilisateur via des formulaires HTML.