Configurer votre projet Google Cloud pour App Engine

Un projet Google Cloud contient votre application App Engine ainsi que d'autres ressources Google Cloud.

Vous pouvez effectuer toutes vos tâches d'administration, y compris les tâches courantes mentionnées dans cet article, à partir de la console Google Cloud, de Google Cloud CLI et de l'API App Engine Admin.

Avant de pouvoir déployer vos applications dans l'environnement flexible App Engine, vous devez en général créer ou configurer les éléments suivants :

1. Un projet Google Cloud
2. Une application App Engine
3. Un compte de facturation

Créer un projet et une application

Vous pouvez sélectionner ou créer un projet Google Cloud et une application App Engine pour créer et gérer un ensemble de paramètres, des identifiants et les métadonnées de votre application.

Seul le rôle Propriétaire dispose de droits permettant de créer une application App Engine dans un projet Google Cloud, et cette application doit exister pour que tout autre compte puisse y effectuer des tâches. Par exemple, l'application App Engine doit d'abord avoir été créée pour qu'un compte doté du rôle "Déployeur App Engine" puisse déployer une application à l'aide d'un compte de service.

Important : Chaque projet Google Cloud ne peut contenir qu'une seule application App Engine. Une fois l'application créée, vous ne pouvez plus modifier l'emplacement de votre application App Engine.

gcloud

Une fois Google Cloud CLI installé, un compte doté du rôle de propriétaire de projet Google Cloud peut exécuter les commandes gcloud suivantes afin de créer un projet Google Cloud et une application App Engine :

1. Exécutez la commande suivante pour créer un projet Google Cloud :

   gcloud projects create PROJECT_ID

   Remplacez PROJECT_ID par l'ID du projet Google Cloud.

2. Exécutez la commande suivante pour sélectionner une région et créer une application App Engine :

   gcloud app create

   En savoir plus sur les emplacements App Engine

3. Activez la facturation sur la page "Facturation" de la console Google Cloud. Pour plus d'informations, consultez la section Activer la facturation.

   Conseils :

   • Si vous déployez vos applications à l'aide de la commande gcloud app deploy, gcloud CLI s'assure que votre projet Google Cloud inclut une application App Engine et vous invite à sélectionner une région si nécessaire.
   • Pour vérifier si une application App Engine existe dans votre projet Google Cloud, vous pouvez exécuter la commande gcloud app describe.

API

Pour créer un projet Google Cloud et une application App Engine de manière automatisée, servez-vous de l'API Cloud Resource Manager et de l'API App Engine Admin :

1. Pour créer un projet Google Cloud, consultez la section Créer un projet.

2. Pour créer une application App Engine, consultez la page Créer des applications App Engine.

3. Activez la facturation sur la page "Facturation" de la console Google Cloud. Pour plus d'informations, consultez la section Activer la facturation.

Console

Pour créer un projet Google Cloud et une application App Engine avec la facturation activée, procédez comme suit :

1. Accédez à la page App Engine.

   Accéder à App Engine

2. Sélectionnez ou créez un projet Google Cloud.

3. Sur la page Créer une application, sélectionnez une région et un compte de service, et activez la facturation :

   1. Sélectionnez une région pour spécifier l'emplacement de votre application App Engine.
      En savoir plus sur les emplacements App Engine 
   2. Sélectionnez un compte de service pour votre application dans Identité et accès à l'API.
   3. Sélectionnez ou créez un compte de facturation pour activer la facturation dans votre projet.

Une fois l'application App Engine créée et la facturation activée dans votre projet, la page Tableau de bord s'ouvre.

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

Activer la facturation

Pour déployer vos applications, vous devez activer la facturation. Aucuns frais ne vous seront facturés si vous restez dans les limites de votre quota gratuit. Si votre application nécessite des ressources qui dépassent ce quota, les ressources supplémentaires utilisées vous seront facturées.

Si vous disposez d'un compte de facturation lorsque vous créez un projet Google Cloud, la facturation est automatiquement activée pour ce projet.

Pour activer la facturation sur un projet Google Cloud, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page "Facturation" :

   Accéder à Facturation

2. Sélectionnez ou créez un projet Google Cloud.

3. Selon qu'il existe un compte de facturation ou que le projet Google Cloud sélectionné est associé à un compte, la page "Facturation" affiche l'un des éléments suivants :

   • Si la facturation est déjà activée pour le projet Google Cloud sélectionné, les informations sur le compte de facturation sont affichées.

   • Si aucun compte de facturation n'existe, vous êtes invité à en créer un et à l'associer au projet Google Cloud sélectionné.

   • Si un compte de facturation existe, vous êtes invité à activer la facturation si le projet Google Cloud sélectionné n'est pas déjà associé à un compte de facturation. Vous pouvez également cliquer sur Annuler, puis sur Créer un compte pour créer et associer un autre compte de facturation.

Une fois la facturation activée, le montant qui peut vous être facturé est illimité. Pour mieux contrôler les coûts de votre application, vous pouvez créer un budget et définir des alertes.

Gérer la facturation

Utilisez la page "Facturation" pour gérer vos comptes de facturation :

1. Accédez à la page "Facturation" dans la console Google Cloud :

   Accéder à Facturation

2. Sélectionnez le compte que vous souhaitez gérer, puis accédez à la page correspondante pour effectuer les tâches de gestion suivantes :

   • Consultez l'aperçu du compte de facturation, effectuez des paiements et ajoutez des administrateurs de compte de facturation depuis la page Vue d'ensemble.
   • Créez des budgets et des alertes sur la page Budgets et alertes.
   • Affichez l'historique des transactions et téléchargez les factures à partir de la page Transactions.
   • Exportez les données de facturation vers un ensemble de données BigQuery depuis la page Exportation de la facturation.
   • Configurez votre compte de paiement et vos contacts sur la page Paramètres de paiement.
   • Définissez le mode de paiement sur la page Mode de paiement.

Pour en savoir plus sur la facturation, consultez la page relative aux tarifs.

Créer des budgets et définir des alertes

Évitez les mauvaises surprises sur votre facture en créant un budget pour un projet Google Cloud et en surveillant tous les frais associés à Google Cloud depuis un seul et même endroit. Avec un budget, vous pouvez créer des alertes qui envoient des e-mails à vos administrateurs de facturation lorsque les frais dépassent un certain montant.

Pour créer un budget et définir des alertes dans un projet Google Cloud, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page "Facturation" :

   Accéder à Facturation

2. Cliquez sur le compte de facturation pour lequel vous souhaitez créer un budget.

3. Cliquez sur Budgets et alertes, puis sur Créer un budget pour commencer à créer un budget pour votre projet Google Cloud.

4. Définissez le budget dans la section Définir le budget, puis spécifiez les pourcentages pour lesquels vous souhaitez recevoir des alertes par e-mail dans la section Définir des alertes de budget.

5. Cliquez sur Enregistrer pour définir le budget et activer les alertes pour votre projet Google Cloud. Si vous avez plusieurs projets Google Cloud, vous devez définir des budgets et des alertes pour chaque projet.

Définir l'ID de projet pour un projet

Dans certains environnements d'exécution standards App Engine, il se peut que vous ayez spécifié l'ID du projet Google Cloud (parfois appelé "ID d'application") dans le fichier app.yaml du projet.

Vous pouvez spécifier l'ID de projet de différentes manières :

• En utilisant gcloud init lorsque vous installez Google Cloud CLI. Pour afficher l'ID de projet par défaut de gcloud CLI, exécutez la commande gcloud config list.
• En utilisant la commande gcloud config set project [YOUR_PROJECT_ID] pour définir l'ID de projet par défaut de gcloud CLI.
• En utilisant l'option --project lorsque vous déployez votre application, par exemple : gcloud app deploy --project [YOUR_PROJECT_ID]

Si vous utilisez l'environnement d'exécution Java, vous pouvez spécifier l'ID du projet lors du déploiement à l'aide de la commandePlug-in Google Cloud pour IntelliJ ouPlug-in Google Cloud pour Eclipse.

Désactiver une application

Désactivez une application App Engine pour empêcher votre application d'exécuter des instances et de répondre aux requêtes. La désactivation de l'application n'entraîne aucune perte de données ni aucune modification des paramètres de configuration. Pour démarrer des instances et continuer à diffuser le trafic vers votre application, vous devez simplement réactiver votre application App Engine.

Les ressources de votre application, tant dans l'environnement standard que flexible, sont désactivées et ne génèrent donc aucuns frais. Toutefois, des frais peuvent toujours vous être facturés pour les autres services de votre projet Google Cloud. Par exemple, des frais de stockage peuvent vous être facturés pour vos données stockées.

Si votre application est en train de traiter activement une requête, elle continuera à effectuer cette tâche et il peut s'écouler jusqu'à une heure avant qu'elle ne soit complètement désactivée.

Pour désactiver une application App Engine, procédez comme suit :

1. Accédez à la page "Paramètres des applications" :

   Accéder à la page "Paramètres de l'application"

2. Cliquez sur Désactiver l'application et suivez les instructions.

Si vous souhaitez que votre application continue à diffuser des requêtes, activez l'application App Engine en revenant sur la page Paramètres des applications, puis en cliquant sur Activer l'application.

La désactivation de votre application arrête toutes les requêtes de service, mais vos données et votre état sont conservés. Les frais applicables déjà engagés ou ceux des autres services exécutés dans votre projet, tels que Cloud SQL, vous seront toujours facturés. Pour libérer toutes les ressources utilisées dans le projet, arrêtez votre projet.

Arrêter un projet

Vous pouvez désactiver la facturation et libérer toutes les ressources Google Cloud utilisées dans votre projet Google Cloud en arrêtant ce projet.

gcloud

Après avoir installé Google Cloud CLI, exécutez la commande gcloud suivante pour arrêter un projet Google Cloud :

gcloud projects delete PROJECT_ID

Remplacez PROJECT_ID par l'ID du projet Google Cloud.

API

Pour arrêter votre projet Google Cloud de manière automatisée, consultez la section Arrêter un projet dans l'API Cloud Resource Manager.

Console

Pour arrêter un projet Google Cloud à l'aide de la console Google Cloud, procédez comme suit :

1. Accédez à la page "Projets" :

   Accéder à la page "Projets"

2. Sélectionnez le projet Google Cloud que vous souhaitez arrêter, puis cliquez sur .

Pour en savoir plus sur la gestion de vos projets Google Cloud, consultez la page Cloud Resource Manager : créer, arrêter et restaurer des projets.