Pour déployer votre application sur App Engine, vous devez créer un Google Cloud projet et les ressources de votre application App Engine.
Le Google Cloud projet est un conteneur de niveau supérieur qui comprend votre application App Engine et d'autres Google Cloud ressources.
L'application App Engine est une ressource que vous devez créer pour activer App Engine. La ressource d'application App Engine définit la région dans laquelle vous souhaitez exécuter votre service Web et stocker les paramètres, identifiants et métadonnées associés. Une seule ressource d'application App Engine peut être créée par Google Cloud projet et la région spécifiée ne peut plus être modifiée une fois ces ressources créées.
Si vous disposez déjà d'un Google Cloud projet avec App Engine et l' API Cloud Build activée, vous pouvez passer à la page Écrire un service Web.
Créez un Google Cloud projet
- Connectez-vous à votre Google Cloud compte. 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 sans frais 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.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Build API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Cloud Build API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Installez la Google Cloud CLI.
-
Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.
-
Pour initialiser la gcloud CLI, exécutez la commande suivante :
gcloud init -
Exécutez la commande
gcloudsuivante pour activer App Engine et créer les ressources d'application associées. Notez que l' emplacement que vous sélectionnez ne peut pas être modifié ultérieurement.gcloud app create
- En raison des modifications apportées au comportement par défaut concernant la façon dont Cloud Build utilise les comptes de service dans les nouveaux projets, et des modifications apportées aux règles d'administration sécurisées par défaut, vous devrez peut-être accorder des rôles supplémentaires à votre compte de service de déploiement. Pour en savoir plus sur l'attribution de rôles spécifiques, consultez le guide de dépannage.
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.
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.
Étapes suivantes
Maintenant que votre Google Cloud projet est configuré, vous êtes prêt à créer un service Web de base.