Déployer un service Cloud Run avec Cloud Code pour VS Code

Déployer un service Cloud Run avec Cloud Code pour VS Code

Cette page explique comment faire vos premiers pas avec Cloud Code.

Vous allez créer un service à partir d'un exemple d'application "Hello, world", le déployer publiquement avec Cloud Code et afficher l'état des ressources de votre service active.

Avant de commencer

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 the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Run API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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 the resourcemanager.projects.create permission. Learn how to grant roles.

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Run API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.
2. Installez Docker. Docker est nécessaire pour compiler l'exemple de code. Assurez-vous que votre compte utilisateur local est en mesure de créer des conteneurs.
3. Installez le plug-in Cloud Code si ce n'est pas déjà fait.

Rôles requis

Pour obtenir les autorisations nécessaires pour suivre ce guide de démarrage rapide, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet :

• Administrateur Cloud Run (roles/run.admin)
• Compilateur Cloud Run (roles/run.builder)
• Lecteur de journaux (roles/logging.viewer)
• Utilisateur du compte de service (roles/iam.serviceAccountUser)

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.

Créer un service

Pour créer un exemple d'application de service, procédez comme suit :

1. Dans la barre d'état de Cloud Code, cliquez sur le nom du projet actif.

   

2. Dans le menu "Démarrage rapide" qui s'affiche, sélectionnez Nouvelle application.

3. Sélectionnez Application Cloud Run comme type d'application.

4. Dans la liste des exemples d'applications, sélectionnez-en une pour la langue de votre choix.

   Par exemple, si vous choisissez Node.js: Cloud Run , vous créez une application de service "Hello, world" en Node.js.

5. Confirmez l'emplacement du système de fichiers du code source de votre service (ou modifiez-le si nécessaire), puis cliquez sur Create New Application (Créer une application).

   Un aperçu du fichier README.md de votre service sélectionné s'ouvre dans VS Code.

Déployer dans Cloud Run

Pour déployer votre service sur Cloud Run, procédez comme suit :

1. Ouvrez la palette de commandes (appuyez sur Ctrl/Cmd+Shift+P ou cliquez sur View > Command Palette (Afficher > Palette de commandes)), puis exécutez la commande Deploy to Cloud Run (Déployer sur Cloud Run).

2. Dans le volet Deploy to Cloud Run (Déployer sur Cloud Run), définissez votre Google Cloud projet.

3. Acceptez les autres paramètres par défaut, puis cliquez sur Deploy (Déployer).

   Cloud Code crée votre image, la transfère dans le registre et déploie votre service dans Cloud Run.

4. Pour visualiser le service en cours d'exécution, ouvrez l'URL affichée en haut de la boîte de dialogue Deploy to Cloud Run (Déployer sur Cloud Run).

Afficher l'état des ressources

Vous pouvez afficher l'état de vos services Cloud Run à l'aide du navigateur de service Cloud Run :

1. Cliquez sur Cloud Code dans la barre des tâches de VS Code.
2. Développez la section Cloud Run pour afficher votre service Cloud Run.
3. Cliquez sur le service pour afficher ses propriétés.

Afficher les journaux

Vous pouvez également afficher les journaux de votre service déployée avec la visionneuse de journaux fournie avec Cloud Code.

Pour afficher les journaux, procédez comme suit :

1. Cliquez sur Cloud Code dans la barre des tâches de VS Code.
2. Développez la section Cloud Run pour afficher votre service Cloud Run.
3. Faites un clic droit sur votre service Cloud Run, puis cliquez sur View logs (Afficher les journaux).

Effectuer un nettoyage

Pour supprimer votre projet :

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

   Accéder à la page Projets

2. Sélectionnez le projet que vous avez créé dans ce guide de démarrage rapide, puis cliquez sur Supprimer.

3. Saisissez l'ID du projet pour confirmer, puis cliquez sur Arrêter.

   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 du conteneur : bien que Cloud Run ne facture pas lorsque le service n'est pas utilisé, il se peut que des frais vous soient facturés pour le stockage de l'image de conteneur dans Artifact Registry. Pour découvrir les étapes à suivre pour supprimer votre image, consultez la page Supprimer des images.

• Service Cloud Run : pour supprimer un service Cloud Run, accédez à Cloud Run dans la Google Cloud console à l'aide du menu de navigation. Sélectionnez le service que vous souhaitez supprimer, puis cliquez sur Supprimer.

Étape suivante

• Découvrez l'assistance au débogage spécifique au langage fournie par Cloud Code.
• Personnalisez votre expérience Cloud Code en configurant des paramètres pertinents.
• Essayez de créer et d'exécuter une application Kubernetes avec Cloud Code.