Créer et déployer une fonction avec Cloud Shell

Découvrez comment créer, déployer, appeler et télécharger une fonction HTTP de 2e génération à l'aide de Cloud Functions avec Cloud Code dans l'éditeur Cloud Shell.

---

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

---

1. Connectez-vous à votre compte Google Cloud. 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 gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

5. Vérifiez que la facturation est activée pour votre projet Google Cloud.

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 Cloud Functions, 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",
       }
   ]
   }
   

Pour savoir comment créer plusieurs fonctions dans un même espace de travail, consultez Gérer les fonctions dans l'espace de travail Shell.

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

   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

• Consultez la présentation Utiliser Cloud Functions pour savoir comment gérer votre espace de travail ou configurer un environnement de développement local.