Configurer votre projet Google Cloud pour App Engine

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

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

Avant de pouvoir déployer des applications dans l'environnement standard App Engine, vous devez généralement créer ou configurer les éléments suivants :

1. Un Google Cloud projet
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 nouveau Google Cloud projet 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. Pour tous vos projets, vous devez activer la facturation pour utiliser App Engine, mais votre utilisation ne vous est facturée que si elle dépasse son quota sans frais.

Seul le rôle Propriétaire dispose de droits permettant de créer une application App Engine dans un Google Cloud projet, et cette application doit exister avant qu'un autre compte ne 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 : Chaqueprojet 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.

Google Cloud

gcloud

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

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

   gcloud projects create PROJECT_ID

   Remplacez PROJECT_ID par l'ID du Google Cloud projet.

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 Google Cloud console. 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 Google Cloud projet inclut une application App Engine et vous invite à sélectionner une région si nécessaire.
   • Pour vérifier qu'une application App Engine existe dans votre Google Cloud projet, vous pouvez exécuter la gcloud app describe commande.

API

Pour créer un Google Cloud projet 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 Google Cloud projet, 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 Google Cloud console. Pour plus d'informations, consultez la section Activer la facturation.

Console

Remarque : Cette méthode ne s'applique pas à Python.

Pour créer un Google Cloud projet 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 Google Cloud projet.

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 dans votre projet, la page Tableau de bord s'affiche.

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 Google Cloud produits et services 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 ses 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 la 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 Google Cloud console. 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 sans frais. 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 Google Cloud projet, la facturation est automatiquement activée pour ce projet.

Pour activer la facturation sur un Google Cloud projet :

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

   Accéder à la facturation

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

3. Selon qu'il existe un compte de facturation ou que le projet sélectionné Google Cloud 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 sélectionné Google Cloud , 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 sélectionné Google Cloud .

   • 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 Google Cloud console :

   Accéder à la 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

Vous pouvez créer un budget pour un Google Cloud projet afin d'éviter les mauvaises surprises sur votre facture et de surveiller tous vos Google Cloud frais à partir d'un seul 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 Google Cloud projet :

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

   Accéder à la 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 Google Cloud projet.

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 Google Cloud projet. Si vous avez plusieurs Google Cloud projets, vous devez définir des budgets et des alertes individuellement dans chaque projet.

Définir l'ID du projet pour un 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 du plug-in Google Cloud pour IntelliJ.

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 de facturation peuvent toujours s'appliquer aux autres services de votre Google Cloud projet. Par exemple, des frais de stockage peuvent toujours vous être facturés pour les données stockées.

Si votre application est en train de traiter activement une requête, elle continuera à effectuer cette tâche et peut nécessiter jusqu'à une heure avant d'être 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

Pour désactiver la facturation et libérer toutes les Google Cloud ressources utilisées dans votre Google Cloud projet, arrêtez ce dernier.

gcloud

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

gcloud projects delete PROJECT_ID

Remplacez PROJECT_ID par l'ID du Google Cloud projet.

API

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

Console

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

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

   Accéder à la page "Projets"

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

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