Guide de démarrage rapide pour Ruby

Cloud Functions est un environnement d'exécution sans serveur permettant de créer et de connecter des services cloud. Avec Cloud Functions, vous pouvez écrire des fonctions simples à application unique qui sont associées à des événements émis par votre infrastructure et vos services cloud. Une fonction est déclenchée lorsqu'une requête HTTP est reçue en externe ou qu'un événement surveillé est lancé.

Cette page vous explique comment créer et déployer une fonction Cloud Ruby à l'aide de Cloud Console. Lorsque cette fonction Ruby est déclenchée par une requête HTTP, elle renvoie un message :

require "functions_framework"
require "json"

# This function receives an HTTP request of type Rack::Request
# and interprets the body as JSON. It prints the contents of
# the "message" field, or "Hello World!" if there isn't one.
FunctionsFramework.http "hello_world" do |request|
  input = JSON.parse request.body.read rescue {}
  msg = input["message"].to_s
  msg.empty? ? "Hello World!" : msg
end

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. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activer les API Cloud Functions and Cloud Build.

    Activer les API

Créer une fonction

  1. Ouvrez la page de présentation de Cloud Functions dans Cloud Console :

    Accéder à la page de présentation de Cloud Functions

    Vérifiez que le projet pour lequel vous avez activé Cloud Functions est sélectionné.

  2. Cliquez sur Create function.

  3. Attribuez un nom à votre fonction.

  4. Dans le champ Trigger (Déclencheur), sélectionnez HTTP.

  5. Dans le champ Authentication (Authentification), cochez Allow unauthenticated invocations (Autoriser les appels non authentifiés).

  6. Cliquez sur Save (Enregistrer) pour enregistrer vos modifications, puis sur Next (Suivant).

  7. Dans le champ Source code (Code source), sélectionnez Inline editor (Éditeur intégré). Dans cet exercice, vous utiliserez la fonction fournie par défaut dans l'éditeur.

  8. Dans le menu déroulant Runtime (Environnement d'exécution), sélectionnez l'environnement d'exécution Ruby souhaité.

Déployer la fonction

  1. Au bas de la page, cliquez sur Deploy (Déployer).

  2. Une fois que vous avez cliqué sur Deploy, Cloud Console vous redirige vers la page de présentation de Cloud Functions.

    Pendant le déploiement de la fonction, une icône de chargement s'affiche juste à côté. Une fois le déploiement terminé, l'icône se transforme en coche verte :

    Capture d'écran montrant le processus de déploiement d'une fonction

Tester la fonction

  1. Affichez le menu de votre fonction et cliquez sur Tester la fonction.

    Capture d'écran montrant le processus de test d'une fonction

  2. Sur la page de test, cliquez sur Tester la fonction.

    L'écran Résultat affiche le texte "Hello World!".

  3. Modifiez désormais le message. Dans le champ Événement déclencheur, saisissez le texte {"message":"Hello, YOUR_NAME!"}, en remplaçant YOUR_NAME par un nom, puis cliquez sur Tester la fonction.

    Par exemple, supposons que vous ayez saisi le nom "Rowan". Dans le champ Résultat, le message Hello, Rowan! apparaît.

    Dans le champ Journaux, le code d'état 200 indique que la fonction a bien été exécutée.

    Capture d'écran montrant le champ "Journaux" avec le code 200, signe de succès

Afficher les journaux

Consultez les journaux pour afficher vos actions dans l'historique :

  • De retour sur la page de présentation de Cloud Functions, affichez le menu correspondant à votre fonction et cliquez sur Afficher les journaux.

Votre historique de journal apparaît.

Capture d'écran montrant le champ "Journaux" avec le code 200, signe de succès

Étapes suivantes