Créer une application Go 1.11 dans l'environnement standard App Engine

Créer une application Go 1.11 dans l'environnement standard 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. 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

OK

Dans cette page, vous allez apprendre à déployer une application de base App Engine qui affiche un message court. Pour une présentation plus détaillée de Go sur App Engine, consultez la page Créer une application.

La plate-forme App Engine représente-t-elle l'option de calcul qui vous correspond ? Découvrez d'autres options pour héberger votre application sur Google Cloud.

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.

Avant de commencer

1. 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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Build API.

   Enable the API

5. Install the Google Cloud CLI.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Make sure that billing is enabled for your Google Cloud project.

9. Enable the Cloud Build API.

   Enable the API

10. Install the Google Cloud CLI.

11. To initialize the gcloud CLI, run the following command:

    gcloud init

Conditions préalables supplémentaires

1. Initialisez votre application App Engine avec votre projet, puis choisissez sa région :

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Lorsque vous y êtes invité, sélectionnez la région dans laquelle vous souhaitez localiser votre application App Engine.

   Attention : Une fois la région d'une application définie, vous ne pouvez plus la modifier.

2. Installez les composants requis suivants :

   • Téléchargez et installez git.

• Exécutez la commande suivante pour installer le composant gcloud, qui inclut l'extension App Engine pour Go 1.11 :

  gcloud components install app-engine-go
  

Zones App Engine

App Engine est régional, ce qui signifie que l'infrastructure qui exécute vos applications est située dans une région spécifique, et que Google la gère de sorte qu'elle soit disponible de manière redondante dans toutes les zones de cette région.

Lors de la sélection d'une région dans laquelle exécuter vos applications, vous devez tout d'abord considérer vos exigences en matière de latence, de disponibilité et de durabilité. Vous pouvez généralement sélectionner la région la plus proche des utilisateurs de votre application, mais pensez aussi aux emplacements où App Engine est disponible ainsi qu'aux emplacements des autres produits et services Google Cloud que votre application utilise. L'utilisation de services situés dans des emplacements différents peut avoir des répercussions sur la latence de votre application, ainsi que sur les tarifs.

Une fois que vous avez défini la région d'une application, vous ne pouvez plus la modifier.

Remarque : Deux emplacements, appelés europe-west et us-central dans les commandes App Engine et dans Google Cloud Console, sont respectivement appelés europe-west1 et us-central1 dans les autres documentations de Google.

Si vous avez déjà créé une application App Engine, vous pouvez afficher sa région en effectuant l'une des opérations suivantes :

• Exécutez la commande gcloud app describe.

• Ouvrez le tableau de bord App Engine dans la console Google Cloud. La région apparaît en haut de la page.

OK

Ce guide de démarrage rapide part du principe que vous connaissez bien le langage de programmation Go et que vous avez installé Go.

Télécharger l'application Hello World

Nous avons créé une application Hello World simple pour Go afin d'illustrer rapidement la procédure de déploiement d'une application sur Google Cloud Platform. Pour télécharger Hello World sur votre ordinateur local, procédez comme suit :

Téléchargez l'exemple d'application et accédez au répertoire de l'application :

1. Clonez le dépôt de l'exemple d'application Hello World :

   git clone https://github.com/GoogleCloudPlatform/golang-samples
   

   Vous pouvez également télécharger l'exemple sous forme de fichier zip et l'extraire.

2. Accédez au répertoire qui contient l'exemple de code :

   cd golang-samples/appengine/go11x/helloworld/
   

Déployer Hello World sur App Engine

1. Pour déployer l'application Hello World sur App Engine, exécutez la commande suivante depuis le répertoire golang-samples/appengine/go11x/helloworld :

   gcloud app deploy
   

2. Affichez l'application en direct à l'adresse https://PROJECT_ID.REGION_ID.r.appspot.com :

   gcloud app browse
   

Le message Hello, World! est maintenant diffusé par un serveur Web s'exécutant sur une instance App Engine.

Félicitations ! Vous venez de déployer un service Web Go sur App Engine.

Effectuer un nettoyage

Si vous souhaitez continuer à vous familiariser avec App Engine, vous pouvez conserver votre projet Google Cloud et passer à la conception d'une application.

Vous pouvez également supprimer votre projet Google Cloud. La facturation de toutes les ressources qu'il utilise sera ainsi interrompue.

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.
1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Étapes suivantes

Maintenant que vous avez de l'expérience dans le déploiement d'un service Web sur App Engine, accédez à une présentation plus détaillée de Go sur App Engine en consultant la page Créer une application.