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

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

Ce document explique comment faire vos premiers pas avec Cloud Code.

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

Avant de commencer

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

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

Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

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 peut 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 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 un 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 code source de votre service dans le système de fichiers (ou modifiez-le si nécessaire), puis cliquez sur Create New Application (Créer une application).

   Un aperçu du fichier README.md pour le 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 Affichage > Palette de commandes), puis exécutez la commande Deploy to Cloud Run (Déployer sur Cloud Run).

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

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

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

4. Pour afficher le service en cours d'exécution, ouvrez l'URL affichée en haut de la boîte de dialogue 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 d'activité 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 d'activité 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 Afficher les journaux.

Effectuer un nettoyage

Pour supprimer votre projet :

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

   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 consoleGoogle Cloud à 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.