Créer une fonction Cloud Run de 2e génération à l'aide de Cloud Code pour Cloud Shell

Créer une fonction Cloud Run de 2e génération à l'aide de Cloud Code pour Cloud Shell

Découvrez comment créer, déployer, appeler et télécharger une fonction Cloud Run HTTP à l'aide de Cloud Code dans l'éditeur Cloud Shell.

Cloud Code est une extension qui intègre de nombreux services Google Cloud, tels que Google Kubernetes Engine et Cloud Run, directement dans votre IDE. Vous pouvez ainsi développer vos applications sans avoir à changer de contexte. Cloud Code est disponible par défaut dans l'éditeur Cloud Shell.

Vous pouvez installer l'extension Cloud Code dansVS Code, qui permet également de créer et déployer des fonctions et qui est compatible avec IntelliJ et autresIDE JetBrains compatibles, qui ne sont pas compatibles avec les fonctions Cloud Run.

---

Pour obtenir des instructions détaillées sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée :

Visite guidée

---

Avant de commencer

1. 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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

5. Make sure that billing is enabled for your Google Cloud project.

Se connecter à Google Cloud

Dans cette section, vous allez lancer l'éditeur Cloud Shell, vous connecter à Google Cloud et sélectionner un projet Google Cloud.

Pour vous connecter à Google Cloud, procédez comme suit:

1. Lancer l'éditeur Cloud Shell.

2. Si vous êtes invité à autoriser Cloud Code à utiliser vos identifiants pour effectuer un appel d'API Google Cloud, cliquez sur Autoriser si vous acceptez les conditions.

3. Si vous n'êtes pas déjà connecté à Google Cloud, dans la barre d'état Cloud Code, cliquez sur Connect to Google Cloud (Se connecter à Google Cloud).

   

4. Si vous êtes invité à autoriser Cloud Code à utiliser vos identifiants pour effectuer des appels d'API Google Cloud, cliquez sur Autoriser si vous acceptez ces conditions.

5. Si vous n'avez pas encore sélectionné de projet Google Cloud, dans la barre d'état Cloud Code, cliquez sur Select a Google Cloud Project (Sélectionner un projet Google Cloud).

   Si vous avez déjà sélectionné un projet Google Cloud, le nom du projet s'affiche dans la barre d'état Cloud Code et vous pouvez créer votre fonction.

6. Dans le menu rapide Sélectionner un projet Google Cloud qui s'affiche, sélectionnez votre projet Google Cloud.

   Le projet se charge et devient le projet actif dans l'éditeur Cloud Shell. Vous pouvez changer de projet à tout moment en cliquant sur le nom du projet actif dans la barre d'état Cloud Code et en sélectionnant un autre projet.

Créer une fonction

Utilisez l'éditeur Cloud Shell comme environnement de création et de déploiement de votre fonction. Les outils nécessaires au développement dans le cloud y sont préchargés.

Pour créer une fonction à l'aide d'un exemple, procédez comme suit :

1. Dans la barre d'état Cloud Code, cliquez sur Cloud Code.

   

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

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

4. Dans la liste d'exemples d'applications des fonctions Cloud Run, sélectionnez Node.js:Hello World.

5. Sélectionnez un dossier qui servira d'emplacement pour votre application, puis cliquez sur Créer une application.

   L'éditeur Cloud Shell charge votre application dans un nouvel espace de travail. Une fois que l'éditeur est actualisé, votre application s'affiche dans la vue de l'explorateur.

   Le fichier launch.json, situé dans le dossier .vscode, contient les configurations requises pour votre fonction :

   {
   "configurations": [
       {
       "name": "Deploy Cloud Function",
       "type": "cloudcode.cloudfunctions",
       "request": "launch",
       "functionName": "function-hello-world",
       "gen": "GEN_2",
       "entryPoint": "helloHttp",
       }
   ]
   }
   

Déployer la fonction

Maintenant que vous avez créé votre fonction, vous pouvez la déployer dans Cloud Shell en procédant comme suit :

1. Cliquez sur Cloud Code, puis développez l'explorateur Cloud Functions.

2. Cliquez sur une fonction, puis sur Déployer la fonction.

3. Dans le menu proposé, sélectionnez un projet Google Cloud sur lequel déployer votre fonction.

4. Sélectionnez la région dans laquelle la fonction sera déployée.

5. Sélectionnez Node.js 22.

   Le déploiement de la fonction peut prendre quelques minutes. Si elle est toujours en cours, une icône de progression s'affiche. Une fois l'opération terminée, l'icône de réussite s'affiche en cas de réussite, l'icône d'erreur s'affiche en cas d'échec, ou l'icône d'avertissement s'affiche si le déploiement échoue et est rétabli sur un déploiement précédent ayant réussi.

   Si le déploiement échoue, reportez-vous à la vue Sortie (Afficher > Sortie) pour le message d'erreur. Cliquez sur le lien pour accéder aux journaux de compilation dans la console Google Cloud et obtenir plus de détails sur l'erreur.

6. (Facultatif) Une fois la fonction déployée, vous pouvez effectuer les actions suivantes :

   • Pour afficher les fichiers en lecture seule de votre fonction déployée, développez la fonction, puis le dossier Code source. Vous pouvez alors afficher launch.json sous .vscode, le code déployé et package.json.

   • Pour afficher la fonction dans la console Google Cloud, effectuez un clic droit sur la fonction et sélectionnez Ouvrir dans la console Cloud. Si vous y êtes invité, sélectionnez Ouvrir.

   • Pour modifier les métadonnées de votre fonction, effectuez un clic droit sur la fonction et sélectionnez Modifier les métadonnées dans la console Cloud.

   • Pour afficher les journaux de la fonction déployée, effectuez un clic droit sur la fonction et sélectionnez Afficher les journaux.

Appeler votre fonction

L'appel d'une fonction vous permet d'exécuter la fonction déployée dans la console Google Cloud à partir du terminal de l'éditeur Cloud Shell. Pour appeler une fonction, procédez comme suit :

1. Effectuez un clic droit sur la fonction et sélectionnez Appeler la fonction via HTTP.

2. Dans le menu proposé Déclencher une fonction via HTTP qui s'affiche, sélectionnez Appeler sans arguments.

   Un terminal s'ouvre dans l'IDE et exécute une commande pour exécuter la fonction dans Google Cloud.

Facultatif : Télécharger une fonction existante dans un nouvel espace de travail

Pour télécharger une fonction existante dans un nouvel espace de travail, procédez comme suit :

1. Cliquez sur Cloud Code, puis développez l'explorateur Cloud Functions.

2. Développez l'extrait de votre projet Google Cloud, effectuez un clic droit sur la fonction que vous souhaitez télécharger, puis sélectionnez Télécharger dans un nouvel espace de travail.

3. Lorsque vous y êtes invité, saisissez un nom pour la nouvelle application, puis cliquez sur Créer une application.

   Cette opération télécharge votre fonction sur votre ordinateur local et l'ouvre dans un nouvel espace de travail dans l'éditeur Cloud Shell.

Effectuer un nettoyage

Pour ne supprimer que la fonction que vous avez créée pour ce démarrage rapide, procédez comme suit:

1. Dans l'explorateur Cloud Functions, effectuez un clic droit sur le nom de la fonction, puis sélectionnez Open in Cloud Console (Ouvrir dans la console Cloud).

2. Cliquez sur Supprimer et de nouveau sur Supprimer.

Pour supprimer votre projet (et les ressources associées), procédez comme suit :

1. Accédez à la page Projets de 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.

Étapes suivantes

• En savoir plus sur la gestion des fonctions dans votre espace de travail Cloud Shell ou sur l'exécution en local avec le framework des fonctions.
• En savoir plus sur l'écriture des fonctions Cloud Run
• Apprenez-en plus sur le déploiement des fonctions Cloud Run.
• En savoir plus sur l'appel des fonctions Cloud Run
• Apprenez à surveiller des fonctions Cloud Run.
• Apprenez à exécuter des fonctions Cloud Run localement.
• Explorez les tutoriels Cloud Run Functions plus avancés.