La compatibilité de Python 2 n'est plus assurée par la communauté. Nous vous recommandons de migrer les applications Python 2 vers Python 3.

Héberger un site Web statique sur Google App Engine

ID de la région

Le REGION_ID est un code abrégé que Google attribue en fonction de la région que vous sélectionnez lors de la création de votre application. Le code ne correspond pas à un pays ou une province, même si certains ID de région peuvent ressembler aux codes de pays et de province couramment utilisés. L'inclusion de REGION_ID.r dans les URL App Engine est facultative pour les applications existantes. Elle sera bientôt obligatoire pour toutes les nouvelles applications.

Pour assurer une transition en douceur, nous mettons lentement à jour App Engine afin d'utiliser les ID de région. Si nous n'avons pas encore mis à jour votre projet Google Cloud, vous ne verrez pas d'ID de région pour votre application. Étant donné que l'ID est facultatif pour les applications existantes, vous n'avez pas besoin de mettre à jour les URL ni d'effectuer d'autres modifications une fois l'ID de région disponible pour vos applications existantes.

En savoir plus sur les ID de région.

Vous pouvez faire appel à Google App Engine pour héberger un site Web statique. Les pages Web statiques peuvent contenir des technologies clientes telles que HTML, CSS et JavaScript. Il peut s'avérer moins coûteux d'héberger votre site statique sur App Engine que d'utiliser un fournisseur d'hébergement classique, car App Engine propose une version gratuite.

Les sites hébergés sur App Engine sont hébergés sur le sous-domaine REGION_ID.r.appspot.com, tel que [my-project-id].uc.r.appspot.com. Une fois que vous avez déployé votre site, vous pouvez mapper votre propre nom de domaine à votre site Web hébergé par App Engine.

Avant de commencer

Avant de pouvoir héberger votre site Web sur Google App Engine, vous devez effectuer les opérations suivantes :

  1. Créez un projet Cloud Console ou récupérez l'ID d'un projet existant que vous souhaitez utiliser :

    Accéder à la page Projets

    Conseil : Vous pouvez récupérer la liste de vos ID de projet existants avec l'outil de ligne de commande gcloud.

  2. Installez, puis initialisez le SDK Google Cloud :

    Télécharger le SDK

Créer un site Web à héberger sur Google App Engine

Structure de base du projet

Ce guide utilise la structure suivante pour le projet :

  • app.yaml : fichier permettant de configurer les paramètres de votre application App Engine
  • www/ : répertoire dans lequel stocker tous vos fichiers statiques (HTML, CSS, images et JavaScript)
    • css/ : répertoire dans lequel stocker des feuilles de style
      • style.css : feuille de style de base qui gère la mise en forme et l'apparence de votre site
    • images/ : répertoire facultatif dans lequel stocker des images
    • index.html : fichier HTML qui affiche le contenu de votre site Web
    • js/ : répertoire facultatif dans lequel stocker des fichiers JavaScript
    • Autres annuaires d'éléments

Créer le fichier app.yaml

Le fichier app.yaml est un fichier de configuration qui indique à App Engine comment mapper les URL aux fichiers statiques. Dans les étapes suivantes, vous allez ajouter des gestionnaires qui chargeront le fichier www/index.html lorsqu'un internaute visitera votre site Web. Tous les fichiers statiques seront stockés dans le répertoire www et appelés à partir de celui-ci.

Créez le fichier app.yaml dans le répertoire racine de votre application :

  1. Créez un répertoire portant le même nom que votre ID de projet. Vous trouverez celui-ci dans la console.
  2. Dans le répertoire que vous venez de créer, créez un fichier nommé app.yaml.
  3. Modifiez le fichier app.yaml et ajoutez-y le code suivant :

    runtime: python27
    api_version: 1
    threadsafe: true
    
    handlers:
    - url: /
      static_files: www/index.html
      upload: www/index.html
    
    - url: /(.*)
      static_files: www/\1
      upload: www/(.*)
    

Vous trouverez plus d'informations sur le fichier app.yaml dans la documentation de référence du fichier app.yaml.

Créer le fichier index.html

Créez un fichier HTML qui sera diffusé lorsque quelqu'un accédera à la page racine de votre site Web. Stockez ce fichier dans votre répertoire www.

<html>
  <head>
    <title>Hello, world!</title>
    <link rel="stylesheet" type="text/css" href="/css/style.css">
  </head>
  <body>
    <h1>Hello, world!</h1>
    <p>
      This is a simple static HTML file that will be served from Google App
      Engine.
    </p>
  </body>
</html>

Déployer l'application sur App Engine

Lorsque vous déployez les fichiers d'application, votre site Web est chargé sur App Engine. Pour déployer votre application, exécutez la commande suivante à partir du répertoire racine de l'application dans lequel se trouve le fichier app.yaml :

gcloud app deploy

Indicateurs facultatifs :

  • Incluez l'option --project pour spécifier un ID de projet Cloud Console différent de celui que vous avez initialisé par défaut dans l'outil gcloud. Exemple : --project [YOUR_PROJECT_ID]
  • Incluez l'option -v pour spécifier un ID de version. Si vous l'omettez, un ID est généré automatiquement. Exemple : -v [YOUR_VERSION_ID]

Pour en savoir plus sur le déploiement de l'application à partir de la ligne de commande, consultez la page Déployer une application Python 2.

Afficher votre application

Pour lancer votre navigateur et afficher l'application sur https://PROJECT_ID.REGION_ID.r.appspot.com, exécutez la commande suivante :

gcloud app browse

Étape suivante

Diffusez un site Web hébergé par App Engine à partir d'un domaine personnalisé.