Membuat Cloud Function menggunakan Google Cloud CLI
Halaman ini menampilkan cara membuat dan men-deploy Cloud Function generasi ke-2 menggunakan Google Cloud CLI.
Sebelum memulai
- 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.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, and Logging.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, and Logging.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
- Menyiapkan lingkungan pengembangan.
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.
Mendapatkan kode sampel
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.
Ubah ke direktori yang memuat kode contoh Cloud 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/
Lihat kode contoh:
Node.js
Python
Go
Java
C#
Ruby
PHP
Men-deploy fungsi
Untuk men-deploy fungsi dengan pemicu HTTP, jalankan perintah berikut di direktori yang berisi kode contoh (atau untuk Java, file pom.xml
):
Node.js
gcloud functions deploy nodejs-http-function \ --gen2 \ --runtime=nodejs20 \ --region=REGION
\ --source=. \ --entry-point=helloGET \
--trigger-http
Gunakan flag --runtime
untuk menentukan ID runtime dari versi Node.js yang didukung untuk menjalankan fungsi Anda.
Python
gcloud functions deploy python-http-function \ --gen2 \ --runtime=python312 \ --region=REGION
\ --source=. \ --entry-point=hello_get \
--trigger-http
Gunakan flag --runtime
untuk menentukan ID runtime
versi Python yang didukung untuk menjalankan
fungsi Anda.
Go
gcloud functions deploy go-http-function \ --gen2 \ --runtime=go121 \ --region=REGION
\ --source=. \ --entry-point=HelloGet \
--trigger-http
Gunakan flag --runtime
untuk menentukan ID runtime versi Go yang didukung untuk menjalankan fungsi Anda.
Java
gcloud functions deploy java-http-function \ --gen2 \ --runtime=java17 \ --region=REGION
\ --source=. \ --entry-point=functions.HelloWorld \ --memory=512MB \
--trigger-http
Gunakan flag --runtime
untuk menentukan ID runtime
versi Java yang didukung guna menjalankan
fungsi Anda.
C#
gcloud functions deploy csharp-http-function \ --gen2 \ --runtime=dotnet6 \ --region=REGION
\ --source=. \ --entry-point=HelloWorld.Function \
--trigger-http
Gunakan flag --runtime
untuk menentukan ID runtime
versi .NET yang didukung guna menjalankan
fungsi Anda.
Ruby
gcloud functions deploy ruby-http-function \ --gen2 \ --runtime=ruby32 \ --region=REGION
\ --source=. \ --entry-point=hello_get \
--trigger-http
Gunakan flag --runtime
untuk menentukan ID runtime
versi Ruby yang didukung untuk menjalankan
fungsi Anda.
PHP
gcloud functions deploy php-http-function \ --gen2 \ --runtime=php82 \ --region=REGION
\ --source=. \ --entry-point=helloGet \
--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.
Region
Anda harus menyediakan region saat men-deploy fungsi generasi ke-2. Lihat Lokasi untuk melihat daftar region yang tersedia. Konfigurasi gcloud CLI Anda memiliki region default yang terkait dengannya, tetapi Anda dapat menggunakan region yang didukung yang Anda inginkan dalam perintah deploy
.
Untuk melihat region default yang terkait dengan konfigurasi gcloud CLI, jalankan:
gcloud config list
Anda dapat mengubah region default dengan cara berikut:
gcloud config set functions/region REGION
Perhatikan bahwa meskipun men-deploy fungsi ke region default, Anda tetap harus menyertakan region tersebut di command line deploy
.
Memicu fungsi
Setelah fungsi selesai di-deploy, catat properti
uri
atau temukan menggunakan perintah berikut:Node.js
gcloud functions describe nodejs-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
Python
gcloud functions describe python-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
Go
gcloud functions describe go-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
Java
gcloud functions describe java-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
C#
gcloud functions describe csharp-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
Ruby
gcloud functions describe ruby-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
PHP
gcloud functions describe php-http-function --gen2 --region REGION --format="value(serviceConfig.uri)"
Setelah mengedit perintah berikut untuk menggunakan URI Anda sendiri, jalankan untuk menampilkan pesan
Hello World!
:curl -m 70 -X POST URI \ -H "Authorization: Bearer $(gcloud auth print-identity-token)" \ -H "Content-Type: application/json" \ -d '{}'
Menghapus Cloud Function
Untuk menghapus Cloud Function yang Anda buat dalam tutorial ini, jalankan perintah berikut:
Node.js
gcloud functions delete nodejs-http-function --gen2 --region REGION
Python
gcloud functions delete python-http-function --gen2 --region REGION
Go
gcloud functions delete go-http-function --gen2 --region REGION
Java
gcloud functions delete java-http-function --gen2 --region REGION
C#
gcloud functions delete csharp-http-function --gen2 --region REGION
Ruby
gcloud functions delete ruby-http-function --gen2 --region REGION
PHP
gcloud functions delete php-http-function --gen2 --region REGION
Anda juga dapat menghapus Cloud Functions dari Konsol Google Cloud.
Langkah selanjutnya
- Pelajari lebih lanjut cara menulis Cloud Functions.
- Pelajari lebih lanjut cara men-deploy Cloud Functions.
- Pelajari lebih lanjut cara memanggil Cloud Functions.
- Pelajari lebih lanjut cara memantau Cloud Functions.
- Pelajari lebih lanjut cara menjalankan Cloud Functions secara lokal.
- Pelajari tutorial Cloud Functions lebih lanjut.