Google Cloud CLI を使用して Cloud Run 関数を作成する

サンプルコードを取得する

1. ローカルマシンにサンプル リポジトリのクローンを作成します。

   Node.js

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

   または、zip 形式のサンプルをダウンロードし、ファイルを抽出してもかまいません。

   Python

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

   または、zip 形式のサンプルをダウンロードし、ファイルを抽出してもかまいません。

   Go

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

   または、zip 形式のサンプルをダウンロードし、ファイルを抽出してもかまいません。

   Java

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

   または、zip 形式のサンプルをダウンロードしてファイルを抽出してもかまいません。

   C#

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

   または、zip 形式のサンプルをダウンロードしてファイルを抽出してもかまいません。

   Ruby

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

   または、zip 形式のサンプルをダウンロードしてファイルを抽出してもかまいません。

   PHP

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

   または、zip 形式のサンプルをダウンロードしてファイルを抽出してもかまいません。

2. Cloud Run functions のサンプルコードが含まれているディレクトリに移動します。

   Node.js

   cd nodejs-docs-samples/functions/helloworld/helloworldGet/

   Python

   cd python-docs-samples/functions/helloworld/

   Go

   cd golang-samples/functions/functionsv2/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/

   PHP

   cd php-docs-samples/functions/helloworld_get/

3. サンプルコードを見てみましょう。

   Node.js

   const functions = require('@google-cloud/functions-framework');
   
   // Register an HTTP function with the Functions Framework that will be executed
   // when you make an HTTP request to the deployed function's endpoint.
   functions.http('helloGET', (req, res) => {
     res.send('Hello World!');
   });

   Python

   import functions_framework
   
   @functions_framework.http
   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>.
       Note:
           For more information on how Flask integrates with Cloud
           Functions, see the `Writing HTTP functions` page.
           <https://cloud.google.com/functions/docs/writing/http#http_frameworks>
       """
       return "Hello World!"
   
   

   Go

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

   Java

   
   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#

   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!", context.RequestAborted);
       }
   }

   Ruby

   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

   PHP

   
   use Psr\Http\Message\ServerRequestInterface;
   
   function helloGet(ServerRequestInterface $request): string
   {
       return 'Hello, World!' . PHP_EOL;
   }
   

関数のデプロイ

HTTP トリガーを使用して関数をデプロイするには、サンプルコード（Java の場合は pom.xml ファイル）を含むディレクトリで次のコマンドを実行します。

gcloud functions deploy nodejs-http-function \
--gen2 \
--runtime=nodejs22 \
--region=REGION \
--source=. \
--entry-point=helloGET \
--trigger-http 

gcloud functions deploy python-http-function \
--gen2 \
--runtime=python312 \
--region=REGION \
--source=. \
--entry-point=hello_get \
--trigger-http 

gcloud functions deploy go-http-function \
--gen2 \
--runtime=go122 \
--region=REGION \
--source=. \
--entry-point=HelloGet \
--trigger-http 

gcloud functions deploy java-http-function \
--gen2 \
--runtime=java21 \
--region=REGION \
--source=. \
--entry-point=functions.HelloWorld \
--memory=512MB \
--trigger-http 

gcloud functions deploy csharp-http-function \
--gen2 \
--runtime=dotnet8 \
--region=REGION \
--source=. \
--entry-point=HelloWorld.Function \
--trigger-http 

gcloud functions deploy ruby-http-function \
--gen2 \
--runtime=ruby33 \
--region=REGION \
--source=. \
--entry-point=hello_get \
--trigger-http 

gcloud functions deploy php-http-function \
--gen2 \
--runtime=php83 \
--region=REGION \
--source=. \
--entry-point=helloGet \
--trigger-http 

必要に応じて --allow-unauthenticated フラグを使用し、認証なしで関数にアクセスすることもできます。これはテストに便利ですが、公開 API やウェブサイトを作成する場合を除き、本番環境でこの設定を使用することはおすすめしません。また、会社のポリシーの設定によっては、これは機能しない可能性があります。認証が必要な関数を呼び出す方法については、呼び出しの認証をご覧ください。

リージョン

Cloud Run functions をデプロイする場合は、リージョンを指定する必要があります。利用可能なリージョンの一覧については、ロケーションをご覧ください。gcloud CLI 構成にはデフォルトのリージョンが関連付けられていますが、deploy コマンドでサポートされている任意のリージョンを使用できます。

gcloud CLI の構成に関連付けられているデフォルトのリージョンを確認するには、次のコマンドを実行します。

gcloud config list

デフォルト リージョンは、次の手順で変更できます。

gcloud config set functions/region REGION

関数をデフォルトのリージョンにデプロイする場合でも、deploy コマンドラインにリージョンを含める必要があります。

関数のトリガー

1. 関数がデプロイされたら、url プロパティをメモするか、次のコマンドを使用して検索します。

   Node.js

   gcloud functions describe nodejs-http-function --gen2 --region REGION --format="value(url)"

   Python

   gcloud functions describe python-http-function --gen2 --region REGION --format="value(url)"

   Go

   gcloud functions describe go-http-function --gen2 --region REGION --format="value(url)"

   Java

   gcloud functions describe java-http-function --gen2 --region REGION --format="value(url)"

   C#

   gcloud functions describe csharp-http-function --gen2 --region REGION --format="value(url)"

   Ruby

   gcloud functions describe ruby-http-function --gen2 --region REGION --format="value(url)"

   PHP

   gcloud functions describe php-http-function --gen2 --region REGION --format="value(url)"

2. 独自の URI を使用するように次のコマンドを編集して実行すると、Hello World! メッセージが表示されます。

   curl -m 70 -X POST URI \
       -H "Authorization: Bearer $(gcloud auth print-identity-token)" \
       -H "Content-Type: application/json" \
       -d '{}'

関数の削除

このチュートリアルで作成した Cloud Run 関数を削除するには、次のコマンドを実行します。

gcloud functions delete nodejs-http-function --gen2 --region REGION 

gcloud functions delete python-http-function --gen2 --region REGION 

gcloud functions delete go-http-function --gen2 --region REGION 

gcloud functions delete java-http-function --gen2 --region REGION 

gcloud functions delete csharp-http-function --gen2 --region REGION 

gcloud functions delete ruby-http-function --gen2 --region REGION 

gcloud functions delete php-http-function --gen2 --region REGION 

Google Cloud コンソールから Cloud Run functions を削除することもできます。