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. Pour les applications créées après février 2020, REGION_ID.r
est inclus dans les URL App Engine. Pour les applications existantes créées avant cette date, l'ID de région est facultatif dans l'URL.
En savoir plus sur les ID de région
Ce guide vous aide à démarrer avec App Engine et à vous familiariser avec le développement, le déploiement et la gestion d'une application Go.
Coûts
Les procédures de ce guide n'engendrent aucun coût. L'exécution seule de cet exemple d'application ne dépasse pas votre quota gratuit.
Configurer votre environnement de développement
Vous pouvez soit utiliser des outils qui vous sont familiers sur votre ordinateur local, soit employer Cloud Shell. Cloud Shell comprend Google Cloud CLI, votre environnement déjà configuré et de nombreuses autres fonctionnalités.
Ordinateur local
Installez Go et configurez gcloud CLI.
Cloud Shell
Lancez Cloud Shell. Tous les outils dont vous aurez besoin y sont pré-installés.
Créer un projet Google Cloud
Un projet est requis pour utiliser Google Cloud et constitue la base de l'utilisation de tous les services Google Cloud.
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
- Créez votre application App Engine et ses ressources associées. Vous devez sélectionner un emplacement, qui ne pourra pas être modifié ultérieurement.
gcloud app create
Créer un service Web de base pour App Engine
Découvrez comment créer un service Web et comment déclarer les paramètres d'exécution.
Structurer les fichiers
Votre service utilisera la structure de fichiers suivante :
go-app/
: répertoire de votre service Go 1.11app.yaml
: paramètres de configuration du servicemain.go
: code de votre application
Créer le fichier app.yaml
Chaque projet App Engine dispose d'un fichier de configuration app.yaml
qui spécifie les paramètres d'environnement d'exécution du service. Le déploiement de ce dernier est impossible sans ce fichier.
Créez un dossier nommé
go-app
pour votre service Go 1.11 :mkdir go-app
Dans votre dossier
go-app/
, créez un fichier appeléapp.yaml
et ajoutez le contenu suivant :Il s'agit de la configuration la plus simple pour une application App Engine. Elle indique à App Engine que vous utilisez l'environnement d'exécution Go 1.11. Le fichier
app.yaml
peut également spécifier des paramètres réseau, des paramètres de scaling, etc. Pour en savoir plus, consultez la documentation de référence surapp.yaml
.
Créer le fichier main.go
Cet exemple utilise le package net/http
pour créer un serveur HTTP qui affiche "Hello world".
Pour configurer votre fichier main.go
:
Dans votre dossier
go-app/
, créez un fichier appelémain.go
.Ajoutez l'instruction
package main
pour traiter votre code en tant que programme exécutable :package main
Pour déployer correctement un service dans l'environnement d'exécution Go 1.11, une instruction
package main
doit être définie au début d'au moins un de vos fichiers source Go dans le même répertoire que le fichierapp.yaml
de votre service.Importez les packages suivants :
Définissez votre gestionnaire HTTP :
L'objet
http.ResponseWriter
assemble la réponse du serveur HTTP. Lorsque vous écrivez sur celle-ci, vous envoyez des données au navigateur. L'objethttp.Request
est une structure de données qui représente la requête HTTP entrante.Enregistrez votre gestionnaire HTTP :
La fonction
main
est le point d'entrée de votre programme exécutable, et démarre donc l'application. Elle commence par appeler la fonctionhttp.HandleFunc
qui indique au packagehttp
de traiter toutes les requêtes dans la racine Web ("/"
) avec la fonctionindexHandler
.Si la variable d'environnement
PORT
n'est pas définie, le port8080
est utilisé par défaut. Lorsque votre application s'exécute sur App Engine, la variable d'environnementPORT
est définie pour vous, mais lorsque vous testez votre application localement, vous pouvez définirPORT
sur n'importe quelle valeur préférée.
Déployer votre service Web sur App Engine
Dans le répertoire
go-app
où se trouve votre fichierapp.yaml
, déployez votre service Web dans App Engine à l'aide de la commande suivante :gcloud app deploy
Pour lancer votre navigateur et afficher le service Web à l'adresse
https://PROJECT_ID.REGION_ID.r.appspot.com
, exécutez la commande suivante :gcloud app browse
Félicitations ! Vous venez de créer et de déployer un service sur App Engine.
Services et versions
Le premier service que vous déployez est le service par défaut.
Vous pouvez spécifier le nom de votre service dans le fichier app.yaml
, mais si le nom est omis, le service est traité en tant que default
. Vous pouvez déployer plusieurs services autres que le service par défaut.
Vous pouvez mettre à jour votre service à tout moment en exécutant la commande gcloud app deploy
. Chaque fois que vous déployez votre application, une version est créée et le trafic est automatiquement acheminé vers la dernière version.
Pour confirmer la création du service et le déploiement de la version, procédez comme suit :
Affichez vos services App Engine dans la console Google Cloud:
Un service nommé
default
doit s'afficher. Le service par défaut est accessible au public depuis l'URL suivante :https://PROJECT_ID.REGION_ID.r.appspot.com
Affichez vos versions :
Une version horodatée correspondant à votre déploiement doit s'afficher dans la liste.
Pour savoir comment envoyer des requêtes à des services et à des versions spécifiques, consultez la page Mode de routage des requêtes.
Étapes suivantes
Félicitations ! Vous venez de configurer et de déployer votre application Web sur App Engine.
Pour savoir comment ajouter d'autres fonctionnalités à votre application, consultez les pages suivantes :
- Pour en savoir plus sur l'écriture des journaux d'application et l'interprétation des journaux système, consultez la page Lire et écrire des journaux d'application.
- Apprenez-en davantage sur le fonctionnement d'App Engine en consultant la page Environnement d'exécution Go.
- Documentez-vous sur la gestion des requêtes et le routage des requêtes.