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

Cette page vous explique comment créer, télécharger, déployer et appeler un objet 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  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. installer le plug-in Cloud Code ; si ce n'est pas déjà fait.

Créer une fonction

Si vous avez déjà créé une fonction, vous pouvez télécharger une fonction existante dans un Nouvel espace de travail et le 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 Section Cloud Functions.

  2. Cliquez sur add (ajouter). Créez une fonction, puis sélectionnez un modèle.

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

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

    Le fichier launch.json contient les configurations requises pour votre :

    {
  "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 même 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 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 une nouvelle dans votre IDE.

Déployer une fonction

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

  1. Effectuez un clic droit sur une fonction et 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, une activité progress_activity l'indicateur de progression s'affiche. Une fois l'opération terminée, Coche check_circle s'affiche. En cas d'échec, une error s'affiche.

    Si le déploiement échoue, consultez l'onglet Résultat pour consulter le message d'erreur. Cliquez sur le lien pour accéder aux journaux de compilation dans la console Google Cloud et plus de détails sur l'erreur.

    Message d'erreur généré

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

    • Pour afficher les fichiers en lecture seule de votre fonction déployée, développez la fonction puis développez le dossier Source Code (Code source). Ici, vous pouvez voir 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 l'icône 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 Edit metadata in Cloud Console (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 une fonction

Appeler une fonction vous permet de l'exécuter dans console Google Cloud depuis le 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 la fenêtre Quickpick Trigger function via HTTP (Déclencher une fonction via HTTP) qui s'affiche, sélectionnez l'une des les deux options:

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

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

Étape suivante

Obtenir de l'aide

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