Membuat Cloud Function generasi ke-1 menggunakan Google Cloud CLI

Membuat Cloud Function generasi ke-1 menggunakan Google Cloud CLI

Catatan: Konten ini hanya berlaku untuk Cloud Functions (generasi ke-1). Lihat Perbandingan versi Cloud Functions untuk mengetahui informasi selengkapnya.

Untuk versi generasi ke-2 dokumen ini, lihat Membuat dan men-deploy Cloud Function (generasi ke-2).

Halaman ini menampilkan cara membuat dan men-deploy Cloud Function generasi ke-1 menggunakan Google Cloud CLI.

Sebelum memulai

1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

7. Enable the Cloud Functions and Cloud Build APIs.

   Enable the APIs

8. Instal dan lakukan inisialisasi gcloud CLI.
9. Perbarui komponen gcloud:

   gcloud components update

Perlu command prompt? Anda dapat menggunakan Google Cloud Shell. Google Cloud Shell adalah lingkungan command line yang sudah menyertakan Google Cloud CLI, sehingga Anda tidak perlu menginstalnya. Google Cloud CLI juga sudah terinstal di Virtual Machine Google Compute Engine.

10. Menyiapkan lingkungan pengembangan.

    Node.js

    Buka panduan penyiapan Node.js

    Python

    Buka panduan penyiapan Python

    Go

    Buka panduan penyiapan Go

    Java

    Buka panduan penyiapan Java

    C#

    Buka panduan penyiapan .NET

    Ruby

    Buka panduan penyiapan Ruby

    PHP

    Buka Menggunakan PHP di Google Cloud

Mendapatkan kode sampel

1. Clone repositori contoh ke komputer lokal Anda:

   Node.js

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

   Python

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

   Go

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

   Java

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

   C#

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

   Ruby

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

   PHP

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

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

2. Ubah ke direktori yang memuat kode contoh 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/

   PHP

   cd php-docs-samples/functions/helloworld_get/

3. Lihat kode contoh:

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

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

   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;
   }
   

Men-deploy fungsi

Untuk men-deploy fungsi dengan pemicu HTTP, jalankan perintah berikut di direktori yang berisi fungsi Anda:

Node.js

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

Gunakan flag --runtime untuk menentukan ID runtime dari versi Node.js yang didukung untuk menjalankan fungsi Anda.

Python

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

Gunakan flag --runtime untuk menentukan ID runtime versi Python yang didukung untuk menjalankan fungsi Anda.

Go

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

Gunakan flag --runtime untuk menentukan ID runtime versi Go yang didukung untuk menjalankan fungsi Anda.

Java

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

Gunakan flag --runtime untuk menentukan ID runtime versi Java yang didukung guna menjalankan fungsi Anda.

C#

gcloud functions deploy csharp-helloworld \
--entry-point HelloWorld.Function \
--runtime dotnet6 --trigger-http

Gunakan flag --runtime untuk menentukan ID runtime versi .NET yang didukung guna menjalankan fungsi Anda.

Ruby

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

Gunakan flag --runtime untuk menentukan ID runtime versi Ruby yang didukung untuk menjalankan fungsi Anda.

PHP

 gcloud functions deploy helloGet --runtime php82 --trigger-http

Gunakan tanda --runtime untuk menentukan ID runtime versi PHP yang didukung untuk menjalankan fungsi Anda.

Secara opsional, Anda dapat menggunakan flag --allow-unauthenticated untuk menjangkau fungsi tanpa autentikasi. Hal ini berguna untuk pengujian, tetapi sebaiknya jangan gunakan setelan ini dalam produksi kecuali Anda membuat situs atau API publik. Selain itu, fitur ini mungkin tidak berfungsi untuk Anda, bergantung pada setelan kebijakan perusahaan Anda. Baca bagian Mengautentikasi pemanggilan untuk mengetahui informasi selengkapnya tentang cara memanggil fungsi yang memerlukan autentikasi.

Menguji fungsi

1. Setelah fungsi selesai di-deploy, catat properti httpsTrigger url atau temukan menggunakan perintah berikut:

   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

   gcloud functions describe hello_get

   PHP

   gcloud functions describe helloGet

   Kodenya akan terlihat seperti berikut:

   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

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

   PHP

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

2. Kunjungi URL ini di browser Anda. Anda akan melihat pesan Hello World!.

Hapus fungsi

Untuk menghapus fungsi, jalankan perintah berikut:

Node.js

gcloud functions delete helloGET 

Python

gcloud functions delete hello_get 

Go

gcloud functions delete HelloGet 

Java

gcloud functions delete java-helloworld 

C#

gcloud functions delete csharp-helloworld 

Ruby

gcloud functions delete hello_get 

PHP

gcloud functions delete helloGet 

Langkah selanjutnya

Lihat panduan Fungsi Pertama Anda yang relevan untuk runtime pilihan Anda guna mempelajari cara menyiapkan lingkungan pengembangan, membuat fungsi baru dari awal, menentukan dependensi, men-deploy fungsi, menguji fungsi, dan melihat log. Perhatikan bahwa panduan ini hanya untuk Cloud Functions (generasi ke-1):

• Fungsi Pertama Anda: Node.js
• Fungsi Pertama Anda: Python
• Fungsi Pertama Anda: Go
• Fungsi Pertama Anda: Java
• Fungsi Pertama Anda: .NET
• Fungsi Pertama Anda: Ruby
• Fungsi Pertama Anda: PHP