Panduan memulai: Men-deploy fungsi ke Cloud Run menggunakan Konsol Google Cloud

Panduan memulai: Men-deploy fungsi ke Cloud Run menggunakan Konsol Google Cloud

Pratinjau — Cloud Run functions

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menunjukkan cara menggunakan Cloud Run untuk men-deploy fungsi HTTP menggunakan Konsol Google Cloud.

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. Aktifkan API Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging .

   Mengaktifkan API

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. Aktifkan API Artifact Registry, Cloud Build, Cloud Run Admin API, and Cloud Logging .

   Mengaktifkan API

8. Jika Anda dikenai kebijakan organisasi pembatasan domain yang membatasi pemanggilan yang tidak diautentikasi untuk project, Anda perlu mengakses layanan yang di-deploy seperti yang dijelaskan di bagian Menguji layanan pribadi.

9. Agar Cloud Build dapat membangun sumber Anda, berikan izin Akun Layanan Cloud Build ke akun layanan default Compute Engine dengan menjalankan perintah berikut:
   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:PROJECT_NUMBER-compute@ \
       --role=roles/cloudbuild.builds.builder

   Ganti PROJECT_NUMBER dengan Google Cloud Anda nomor project, dan PROJECT_ID dengan data Google Cloud project ID Anda.

   Anda dapat menemukan nomor project dan ID project Anda di Selamat datang halaman Konsol Google Cloud.

   Catatan:

   Batasan kebijakan organisasi iam.automaticIamGrantsForDefaultServiceAccounts mencegah peran Editor diberikan secara otomatis ke akun layanan default. Jika Anda membuat organisasi Anda setelah 3 Mei 2024, batasan ini diberlakukan oleh secara default.

   Sebaiknya terapkan batasan ini untuk menonaktifkan pemberian peran otomatis. Jika Anda menonaktifkan pemberian peran otomatis, Anda harus memutuskan peran mana yang akan diberikan ke layanan default akun, lalu memberikan peran ini diri Anda sendiri.

   Jika akun layanan default sudah memiliki peran Editor, sebaiknya Anda mengganti Peran editor dengan peran yang kurang permisif. Untuk mengubah peran akun layanan secara aman, gunakan Simulator Kebijakan untuk melihat dampak perubahan, lalu berikan dan cabut peran yang sesuai.

Men-deploy cloud function

Penting: Panduan memulai ini mengasumsikan bahwa Anda memiliki peran pemilik atau editor dalam project yang Anda gunakan untuk panduan memulai tersebut. Jika tidak, lihat peran Cloud Run Source Developer untuk mendapatkan izin yang diperlukan guna men-deploy resource Cloud Run dari sumber.

Untuk men-deploy fungsi, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Cloud Run:

   Buka Cloud Run

2. Klik Write a function.

3. Di kolom Nama layanan, masukkan nama layanan untuk mendeskripsikan fungsi Anda. seperti my-nodejs-http-function. Nama layanan hanya boleh dimulai dengan huruf, dan berisi maksimal 49 karakter atau kurang, termasuk huruf, angka, atau tanda hubung. Nama layanan tidak boleh diakhiri dengan tanda hubung, dan harus unik per region dan project. Nama layanan tidak dapat diubah nanti dan terlihat secara publik.

4. Di daftar Region, gunakan nilai default us-central1, atau pilih region tempat Anda ingin men-deploy fungsi.

5. Dalam daftar Runtime, gunakan nilai default, atau pilih versi runtime.

6. Di bagian Autentikasi, pilih Izinkan pemanggilan tanpa autentikasi. Jika Anda tidak memiliki izin (peran Cloud Run Admin) untuk memilih ini, layanan akan men-deploy dan memerlukan otentikasi.

7. Klik Create, dan tunggu hingga Cloud Run membuat layanan menggunakan revisi placeholder.

8. Konsol akan mengalihkan Anda ke Source tab tempat Anda dapat melihat kode sumber fungsi Anda. Klik Save and redeploy.

9. Di tab Source, Anda dapat mengklik Show Payload (opsional) untuk melihat objek permintaan masuk.

10. Setelah deployment, URL container ditampilkan di sebelah teks URL:. Untuk melihat output fungsi, klik Salin ke papan klip untuk menyalin URL-nya, lalu tempel URL tersebut ke di kolom URL.

Untuk mempelajari cara menambahkan pemicu Eventarc ke fungsi Anda, lihat Panduan Deploy fungsi untuk mendapatkan petunjuk.

Lokasi Cloud Run

Cloud Run bersifat regional, berarti infrastruktur yang menjalankan layanan Cloud Run Anda terletak di region tertentu dan dikelola oleh Google agar tersedia secara redundan di semua zona dalam region tersebut.

Memenuhi persyaratan latensi, ketersediaan, atau ketahanan adalah faktor utama untuk memilih region tempat layanan Cloud Run dijalankan. Pada umumnya, Anda dapat memilih region yang paling dekat dengan pengguna Anda, tetapi Anda harus mempertimbangkan lokasi dari produk Google Cloud lain yang digunakan oleh layanan Cloud Run Anda. Menggunakan produk Google Cloud secara bersamaan di beberapa lokasi dapat memengaruhi latensi serta biaya layanan Anda.

Cloud Run tersedia di region berikut:

Tergantung harga Tingkat 1

• asia-east1 (Taiwan)
• asia-northeast1 (Tokyo)
• asia-northeast2 (Osaka)
• europe-north1 (Finlandia) Rendah CO₂
• europe-southwest1 (Madrid) Rendah CO₂
• europe-west1 (Belgia) Rendah CO₂
• europe-west4 (Belanda) Rendah CO₂
• europe-west8 (Milan)
• europe-west9 (Paris) Rendah CO₂
• me-west1 (Tel Aviv)
• us-central1 (Iowa) Rendah CO₂
• us-east1 (South Carolina)
• us-east4 (North Virginia)
• us-east5 (Columbus)
• us-south1 (Dallas) Rendah CO₂
• us-west1 (Oregon) Rendah CO₂

Tergantung harga Tingkat 2

• africa-south1 (Johannesburg)
• asia-east2 (Hong Kong)
• asia-northeast3 (Seoul, Korea Selatan)
• asia-southeast1 (Singapura)
• asia-southeast2 (Jakarta)
• asia-south1 (Mumbai, India)
• asia-south2 (Delhi, India)
• australia-southeast1 (Sydney)
• australia-southeast2 (Melbourne)
• europe-central2 (Warsawa, Polandia)
• europe-west10 (Berlin) Rendah CO₂
• europe-west12 (Turin)
• europe-west2 (London, Inggris) Rendah CO₂
• europe-west3 (Frankfurt, Jerman) Rendah CO₂
• europe-west6 (Zurich, Swiss) Rendah CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) Rendah CO₂
• northamerica-northeast2 (Toronto) Rendah CO₂
• southamerica-east1 (Sao Paulo, Brasil) Rendah CO₂
• southamerica-west1 (Santiago, Cile) Rendah CO₂
• us-west2 (Los Angeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Jika sudah membuat layanan Cloud Run, Anda dapat melihat region di dasbor Cloud Run di Konsol Google Cloud.

Oke

Pembersihan

Meskipun Cloud Run tidak mengenakan biaya saat layanannya tidak digunakan, Anda mungkin tetap dikenai biaya atas penyimpanan image container di Artifact Registry. Anda dapat menghapus image container atau menghapus project Google Cloud untuk menghindari tagihan. Menghapus project Google Cloud Anda akan menghentikan penagihan untuk semua resource yang digunakan dalam project tersebut.

Perhatian: Menghapus project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.
1. Di konsol Google Cloud, buka halaman Manage resource.

   Buka Manage resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah selanjutnya

• Memicu fungsi dari Cloud Storage menggunakan Eventarc

• Untuk men-deploy fungsi contoh ke Cloud Run menggunakan Google Cloud CLI, lihat Panduan memulai: Deploy fungsi ke Cloud Run menggunakan gcloud CLI.

• Untuk men-deploy fungsi menggunakan Konsol Google Cloud dan Google Cloud CLI, lihat Men-deploy fungsi.

• Untuk melihat dan menghapus fungsi yang ada, lihat Mengelola revisi layanan.

• Untuk membangun container fungsi di toolchain Anda sendiri dan men-deploy-nya ke Cloud Run, lihat Fungsi build.