HTTP 教學課程

準備應用程式

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 格式的範例，然後解壓縮該檔案。

   Ruby

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

   您也可以 下載 zip 格式的範例，然後解壓縮該檔案。

2. 變更為包含 Cloud Run 函式程式碼範例的目錄：

   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/

   Ruby

   cd ruby-docs-samples/functions/helloworld/

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"
   )
   
   // 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!");
     }
   }

   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

部署函式

如要使用 HTTP 觸發條件部署函式，請在包含範例程式碼的目錄中執行下列指令 (如果是 Java，則在 pom.xml 檔案中執行)：

gcloud functions deploy helloGET \
--runtime nodejs20 --trigger-http

gcloud functions deploy hello_get \
--runtime python312 --trigger-http

gcloud functions deploy HelloGet \
--runtime go121 --trigger-http

gcloud functions deploy java-http-function \
--entry-point functions.HelloWorld \
--runtime java17 \
--memory 512MB --trigger-http

gcloud functions deploy hello_get --runtime ruby33 --trigger-http

您可以選擇使用 --allow-unauthenticated 旗標，不必驗證就能使用函式。這項設定適用於測試，但除非您要建立公開 API 或網站，否則不建議在正式環境中使用。此外，根據公司政策設定，這項功能可能不適用於你。如要瞭解如何叫用需要驗證的函式，請參閱「叫用時進行驗證」。

觸發函式

如要對您的函式提出 HTTP 要求，請執行下列指令：

curl "https://REGION-PROJECT_ID.cloudfunctions.net/helloGET" 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get" 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/HelloGet" 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/java-http-function" 

curl "https://REGION-PROJECT_ID.cloudfunctions.net/hello_get" 

其中

• REGION 是函式部署的地區。函式完成部署時，終端機中會顯示這個值。
• PROJECT_ID 是您的 Cloud 專案 ID。當您的函式部署完成時，可以在您的終端機中看見它。

您也可以在瀏覽器中前往已部署函式的端點，查看「Hello World!」訊息。