Déployer une application Cloud Run à l'aide de Cloud Shell
Pour faire vos premiers pas avec Cloud Run, vous pouvez déployer un exemple d'application Hello World et inspecter les ressources de votre service actif. Dans ce guide de démarrage rapide, vous allez utiliser Cloud Shell pour configurer un service Cloud Run et afficher ses journaux.
Avant de commencer
-
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.
Rôles requis
Pour obtenir les autorisations nécessaires pour déployer une application Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :
- Administrateur Cloud Run (
roles/run.admin) - Développeur de source Cloud Run (
roles/run.sourceDeveloper) -
Utilisateur du compte de service (
roles/iam.serviceAccountUser) - Administrateur Service Usage (
roles/serviceusage.serviceUsageAdmin) - Administrateur de projet IAM (
roles/resourcemanager.projectIamAdmin) - Visionneuse de journaux (
roles/logging.viewer)
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Accorder au compte de service Cloud Build l'accès à votre projet
Cloud Build utilise automatiquement le compte de service Compute Engine par défaut comme compte de service Cloud Build par défaut pour compiler votre code source et votre ressource Cloud Run, sauf si vous remplacez ce comportement.
Pour que Cloud Build puisse créer vos sources, attribuez au compte de service Cloud Build le rôle Compte de service Cloud Run (roles/run.builder) sur votre projet :
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS \ --role=roles/run.builder
Remplacez PROJECT_ID par l'ID de votre projet Google Cloudet SERVICE_ACCOUNT_EMAIL_ADDRESS par l'adresse e-mail du compte de service Cloud Build. Si vous utilisez le compte de service Compute Engine par défaut comme compte de service Cloud Build, utilisez le format suivant pour l'adresse e-mail du compte de service :
PROJECT_NUMBER-compute@
Remplacez PROJECT_NUMBER par votre numéro de projet Google Cloud.
Pour obtenir des instructions détaillées sur la recherche de votre ID et de votre numéro de projet, consultez Créer et gérer des projets.
L'attribution du rôle de compilateur Cloud Run prend quelques minutes à se propager.
Créer une application
- Lancer l'éditeur de code Cloud Shell
- Dans la barre d'état Cloud Code, sélectionnez New Application (Nouvelle application).
- Sélectionnez Application Cloud Run comme type d'application préféré.
Dans la liste des exemples d'applications (Node.js, Python avec frameworks Flask et Django, Java, Go), choisissez une application Hello World.
Par exemple, si vous sélectionnez
Python (Flask): Hello World, une application Hello World de démarrage en langage Python (Flask) est créée.Sélectionnez un dossier comme emplacement pour l'application, puis cliquez sur Créer une application.
L'éditeur Cloud Shell charge l'application dans un nouvel espace de travail. Une fois l'espace de travail chargé, votre application est accessible dans la vue de l'explorateur.
Déployer dans Cloud Run
Pour déployer votre application sur Cloud Run, procédez comme suit :
- Ouvrez la palette de commandes (appuyez sur
Ctrl/Cmd+Shift+Pou cliquez sur Affichage > Palette de commandes), puis exécutez la commande Déployer sur Cloud Run. L'UI de déploiement Cloud Run s'affiche. - Si vous y êtes invité, autorisez Cloud Code à effectuer les appels d'API Google Cloud .
- Définissez votre projet Google Cloud .
- Si vous y êtes invité, activez l'API Cloud Run en cliquant sur Enable APIs (Activer les API).
- Dans la boîte de dialogue "Deploy to Cloud Run" (Déployer sur Cloud Run), sélectionnez un service préexistant ou créez-en un.
- Si vous créez un service, sélectionnez Cloud Run (entièrement géré) sous "Plate-forme de déploiement".
- Choisissez une région dans laquelle effectuer le déploiement.
- Pour l'authentification, sélectionnez Allow unauthenticated invocations (Autoriser les appels non authentifiés) pour rendre ce service public.
Après avoir défini vos préférences, vous pouvez cliquer sur Déployer.
Cloud Code crée ensuite votre image, la transfère dans le registre et déploie votre application dans Cloud Run. Votre service est désormais actif !
Affichez le service en cours d'exécution en suivant l'URL affichée dans la boîte de dialogue "Cloud Run: Deploy" (Cloud Run : Déployer).
Modifier votre service
Pour modifier votre application, procédez comme suit :
- Dans la vue de l'explorateur, recherchez le fichier
app.pyqui implémente le comportement du service. - Remplacez le message "It's running!" (En cours d'exécution) par le message de votre choix.
- Une fois cette modification effectuée, choisissez la commande Deploy to Cloud Run (Déployer sur Cloud Run) à l'aide de la palette de commandes.
- Vérifiez que le service que vous venez de créer est sélectionné dans "Service Settings" (Paramètres du service).
- Cliquez sur Déployer.
- Une fois votre application créée et déployée, vous pouvez actualiser votre service pour afficher le message mis à jour.
Afficher les journaux
Vous pouvez également afficher les journaux de votre application déployée avec la visionneuse de journaux fournie avec Cloud Code.
Pour afficher les journaux, procédez comme suit :
- Cliquez sur
Cloud Code, puis développez la section Cloud Run. Effectuez un clic droit sur votre service Cloud Run, puis cliquez sur Afficher les journaux.
Actualisez votre application dans le navigateur, puis cliquez sur le bouton d'actualisation des journaux afin de consulter les nouveaux journaux générés.
Effectuer un nettoyage
Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :
Pour supprimer votre projet :
Accédez à la page "Projets" dans la console Google Cloud :
Sélectionnez le projet que vous avez créé dans ce guide de démarrage rapide, puis cliquez sur Supprimer.
Cette opération ferme le projet et programme sa suppression.
Si vous utilisez un projet préexistant et que vous souhaitez supprimer les ressources que vous avez créées pour ce démarrage rapide :
Image de conteneur : bien que Cloud Run ne facture pas un service inutilisé, il se peut que des frais vous soient toujours facturés pour le stockage de l'image de conteneur dans Artifact Registry. Pour supprimer votre image, ouvrez la page Artifact Registry, sélectionnez le dépôt qui contient votre image, sélectionnez votre image, cliquez sur Supprimer, puis sur Supprimer.
Service Cloud Run : pour supprimer un service Cloud Run, accédez à la page Cloud Run de la consoleGoogle Cloud , sélectionnez le service que vous souhaitez supprimer, cliquez sur Supprimer, puis sur Supprimer.
Étapes suivantes
- Découvrez les différentes fonctionnalités de l'interface de l'éditeur Cloud Shell.
- Découvrez comment configurer Cloud Shell pour personnaliser votre expérience.