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

Découvrez comment créer, déployer, appeler et télécharger une fonction Cloud Run HTTP à l'aide de fonctions Cloud Run 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. 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.

    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.

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

    Bouton "Se connecter à Google Cloud" dans la barre d'état

  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.

    Bouton de la barre d'état 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",
    }
]
}

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 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 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, Icône de réussite de Si l'opération réussit, la une icône d'erreur en cas d'échec, ou l'icône Icône d'avertissement si le déploiement échoue et revient à un déploiement précédemment 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

Appeler une fonction vous permet d'exécuter la fonction déployée la console Google Cloud depuis le 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.

Étape suivante