Créer et déployer une fonction avec Cloud Code pour VS Code

Cette page explique comment créer, télécharger, déployer et appeler une fonction HTTP de 2e génération à l'aide de Cloud Functions avec Cloud Code.

Avant de commencer

  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.

    Accéder au sélecteur de projet

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

  4. Activer les API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

    Activer les API

    5.

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

    Accéder au sélecteur de projet

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

  7. Activer les API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

    Activer les API

    8.
  8. Installez Git. Git est nécessaire pour copier des exemples sur votre ordinateur.
  9. Si ce n'est pas déjà fait, installez le plug-in Cloud Code.

Créer une fonction

Si vous avez déjà créé une fonction, vous pouvez la télécharger dans un nouvel espace de travail et la modifier localement.

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

  1. Cliquez sur Cloud Code, puis développez la section Cloud Functions.

  2. Cliquez sur add Créer une fonction, puis sélectionnez un modèle.

  3. Accédez au chemin dans lequel vous souhaitez créer votre fonction, saisissez un nom pour la fonction, puis sélectionnez Create New Application (Créer une application).

    Si le dossier de votre application n'apparaît pas automatiquement dans l'Explorateur, cliquez sur Actualiser Actualiser.

    Le fichier launch.json 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 en savoir plus sur la création de plusieurs fonctions dans un seul espace de travail, consultez Gérer les fonctions dans l'espace de travail VS Code.

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

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

  1. Cliquez sur Cloud Code, puis développez la section 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 Create New Application (Créer une application).

    La fonction est alors téléchargée sur votre ordinateur local et s'ouvre dans un nouvel espace de travail de votre IDE.

Déployer une fonction

Pour déployer une fonction, procédez comme suit:

  1. Effectuez un clic droit sur une fonction, puis sélectionnez Déployer la fonction.

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

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

  4. Sélectionnez un environnement d'exécution.

    Le déploiement de la fonction peut prendre quelques minutes. Pendant l'opération, un indicateur de progression progress_activity s'affiche. Une fois l'opération terminée, une coche check_circle s'affiche. En cas d'échec, un symbole d'erreur error s'affiche.

    Si le déploiement échoue, reportez-vous au message d'erreur dans l'onglet Sortie. 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.

    Affichage du message d'erreur

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

    • Pour afficher les fichiers en lecture seule de la fonction déployée, développez la fonction, puis le dossier Source Code (Code source). Ici, vous pouvez 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 dessus et sélectionnez Ouvrir dans Cloud Console. 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 Cloud Console.

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

Appeler une fonction

Appeler une fonction vous permet d'exécuter la fonction déployée dans la console Google Cloud à partir du terminal intégré de l'IDE. 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 Quickpick Déclencher une fonction via HTTP qui s'affiche, sélectionnez l'une des deux options suivantes:

    • Par défaut: un terminal s'ouvre dans l'IDE et exécute une commande pour exécuter la fonction dans Google Cloud.

    • Import arguments from JSON file (Importer des arguments depuis un fichier JSON) : cette option prend le contenu du fichier JSON sélectionné, le transforme en chaîne et le transmet avec -d '{. Cette opération est utile lorsque vous avez une entrée dans vos fonctions et que vous souhaitez l'enregistrer, ce qui vous permet de l'exécuter sans avoir à la ressaisir à plusieurs reprises.

Étapes suivantes

Assistance

Pour envoyer vos commentaires, signalez tout problème sur GitHub ou posez une question sur Stack Overflow.