Démarrage rapide – Utiliser l'outil de ligne de commande gcloud

Cette page explique comment créer et déployer une fonction Cloud à l'aide de l'outil de ligne de commande gcloud.

Avant de commencer

1. Connectez-vous à votre compte Google.

   Si vous n'en possédez pas déjà un, vous devez en créer un.

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 à la page de sélection du 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

5. Installez et initialisez le SDK Cloud.
6. Mettez à jour les composants gcloud :

   gcloud components update

Vous avez besoin d'une invite de commande ? Vous pouvez utiliser Google Cloud Shell. Google Cloud Shell est un environnement de ligne de commande qui inclut le SDK Google Cloud. Vous n'avez donc pas besoin de l'installer. Le SDK Google Cloud est également préinstallé sur les machines virtuelles Google Compute Engine.

7. Préparez votre environnement de développement.

   Node.js

   Accéder au guide de configuration Node.js

   Python

   Accéder au guide de configuration Python

   Go

   Accéder au guide de configuration Go

   Java

   Accéder au guide de configuration Java

   C#

   Accéder au guide de configuration .NET

   Ruby

   Accéder au guide de configuration Ruby

Obtenir l'exemple de code

1. Clonez l'exemple de dépôt sur votre ordinateur local :

   Node.js

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

   Python

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

   Go

   git clone https://github.com/GoogleCloudPlatform/golang-samples.git

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

   Java

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

   C#

   git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

   Ruby

   git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

2. Accédez au répertoire qui contient l'exemple de code de Cloud Functions :

   Node.js

   cd nodejs-docs-samples/functions/helloworld/

   Python

   cd python-docs-samples/functions/helloworld/

   Go

   cd golang-samples/functions/helloworld/

   Java

   cd java-docs-samples/functions/helloworld/helloworld/

   C#

   cd dotnet-docs-samples/functions/helloworld/HelloWorld/

   Ruby

   cd ruby-docs-samples/functions/helloworld/get/

3. Consultez l'exemple de code :

   Node.js

   functions/helloworld/index.js

   Afficher sur GitHub Commentaires

   /**
    * HTTP Cloud Function.
    * This function is exported by index.js, and is executed when
    * you make an HTTP request to the deployed function's endpoint.
    *
    * @param {Object} req Cloud Function request context.
    *                     More info: https://expressjs.com/en/api.html#req
    * @param {Object} res Cloud Function response context.
    *                     More info: https://expressjs.com/en/api.html#res
    */
   exports.helloGET = (req, res) => {
     res.send('Hello World!');
   };

   Python

   functions/helloworld/main.py

   Afficher sur GitHub Commentaires

   def hello_get(request):
       """HTTP Cloud Function.
       Args:
           request (flask.Request): The request object.
           <https://flask.palletsprojects.com/en/1.1.x/api/#incoming-request-data>
       Returns:
           The response text, or any set of values that can be turned into a
           Response object using `make_response`
           <https://flask.palletsprojects.com/en/1.1.x/api/#flask.make_response>.
       """
       return 'Hello World!'

   Go

   functions/helloworld/hello_world.go

   Afficher sur GitHub Commentaires

   
   // Package helloworld provides a set of Cloud Functions samples.
   package helloworld
   
   import (
   	"fmt"
   	"net/http"
   )
   
   // HelloGet is an HTTP Cloud Function.
   func HelloGet(w http.ResponseWriter, r *http.Request) {
   	fmt.Fprint(w, "Hello, World!")
   }
   

   Java

   functions/helloworld/helloworld/src/main/java/functions/HelloWorld.java

   Afficher sur GitHub Commentaires

   
   package functions;
   
   import com.google.cloud.functions.HttpFunction;
   import com.google.cloud.functions.HttpRequest;
   import com.google.cloud.functions.HttpResponse;
   import java.io.BufferedWriter;
   import java.io.IOException;
   
   public class HelloWorld implements HttpFunction {
     // Simple function to return "Hello World"
     @Override
     public void service(HttpRequest request, HttpResponse response)
         throws IOException {
       BufferedWriter writer = response.getWriter();
       writer.write("Hello World!");
     }
   }

   C#

   functions/helloworld/HelloWorld/Function.cs

   Afficher sur GitHub Commentaires

   using Google.Cloud.Functions.Framework;
   using Microsoft.AspNetCore.Http;
   using System.Threading.Tasks;
   
   namespace HelloWorld
   {
       public class Function : IHttpFunction
       {
           public async Task HandleAsync(HttpContext context)
           {
               await context.Response.WriteAsync("Hello World!");
           }
       }
   }

   Ruby

   functions/helloworld/get/app.rb

   Afficher sur GitHub Commentaires

   require "functions_framework"
   
   FunctionsFramework.http "hello_get" do |_request|
     # The request parameter is a Rack::Request object.
     # See https://www.rubydoc.info/gems/rack/Rack/Request
   
     # Return the response body as a string.
     # You can also return a Rack::Response object, a Rack response array, or
     # a hash which will be JSON-encoded into a response.
     "Hello World!"
   end

Déployer une fonction

Pour déployer la fonction avec un déclencheur HTTP, exécutez la commande suivante dans le répertoire contenant votre fonction :

Node.js

gcloud functions deploy helloGET \
--runtime nodejs10 --trigger-http --allow-unauthenticated

Vous pouvez attribuer les valeurs suivantes à l'option --runtime, afin de spécifier votre version préférée de Node.js :

• nodejs10
• nodejs12

Python

gcloud functions deploy hello_get \
--runtime python37 --trigger-http --allow-unauthenticated

Vous pouvez attribuer les valeurs suivantes à l'option --runtime, afin de spécifier votre version préférée de Python :

• python37
• python38

Go

gcloud functions deploy HelloGet \
--runtime go111 --trigger-http --allow-unauthenticated

Vous pouvez attribuer les valeurs suivantes à l'option --runtime, afin de spécifier votre version préférée de Go :

• go111
• go113

Java

gcloud functions deploy java-helloworld \
--entry-point functions.HelloWorld \
--runtime java11 \
--memory 512MB --trigger-http --allow-unauthenticated

C#

gcloud functions deploy csharp-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet3 --trigger-http --allow-unauthenticated

Ruby

gcloud functions deploy hello_get --runtime ruby26 --trigger-http --allow-unauthenticated

Vous pouvez attribuer les valeurs suivantes à l'option --runtime, afin de spécifier votre version préférée de Ruby :

• ruby26
• ruby27

L'option --allow-unauthenticated vous permet d'accéder à la fonction sans authentification. Pour exiger une authentification, omettez cette option.

Tester la fonction

1. Une fois le déploiement de la fonction terminé, notez la propriété url de httpsTrigger ou recherchez-la à l'aide de la commande suivante :

   Node.js

   gcloud functions describe helloGET

   Python

   gcloud functions describe hello_get

   Go

   gcloud functions describe HelloGet

   Java

   gcloud functions describe java-helloworld

   C#

   gcloud functions describe csharp-helloworld

   Ruby

   functions/helloworld/get/app.rb

   Afficher sur GitHub Commentaires

   require "functions_framework"
   
   FunctionsFramework.http "hello_get" do |_request|
     # The request parameter is a Rack::Request object.
     # See https://www.rubydoc.info/gems/rack/Rack/Request
   
     # Return the response body as a string.
     # You can also return a Rack::Response object, a Rack response array, or
     # a hash which will be JSON-encoded into a response.
     "Hello World!"
   end

   Elle doit se présenter comme ceci :

   Node.js

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/helloGET

   Python

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_get

   Go

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloGet

   Java

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/java-helloworld

   C#

   https://GCP_REGION-PROJECT_ID.cloudfunctions.net/csharp-helloworld

   Ruby

   gcloud functions describe hello_get

2. Accédez à cette URL dans votre navigateur. Le message suivant devrait s'afficher : Hello World!.

Supprimer la fonction

Pour supprimer la fonction, exécutez la commande suivante :

Pour supprimer la fonction, exécutez la commande suivante :

Node.js

gcloud functions delete helloGET --trigger-http --allow-unauthenticated

Python

gcloud functions delete hello_get --trigger-http --allow-unauthenticated

Go

gcloud functions delete HelloGet --trigger-http --allow-unauthenticated

Java

gcloud functions delete java-helloworld --trigger-http --allow-unauthenticated

C#

gcloud functions delete csharp-helloworld --trigger-http --allow-unauthenticated

Ruby

gcloud functions delete hello_get --trigger-http --allow-unauthenticated

Node.js

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/helloGET

Python

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/hello_get

Go

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/HelloGet

Java

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/java-helloworld

C#

https://GCP_REGION-PROJECT_ID.cloudfunctions.net/csharp-helloworld

Ruby

gcloud functions describe hello_get

Étape suivante

• En savoir plus sur l'écriture des fonctions Cloud Functions
• En savoir plus sur le déploiement des fonctions Cloud Functions
• En savoir plus sur l'appel des fonctions Cloud Functions
• Apprenez à surveiller des fonctions Cloud Functions.
• Apprenez à exécuter des fonctions Cloud Functions localement.
• Explorez les tutoriels sur les fonctions Cloud Functions plus avancées.