Panduan memulai: Membuat Instance Cloud Run

Panduan memulai: Membuat Instance Cloud Run

Pratinjau — Instance Cloud Run

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari 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 membuat instance Cloud Run dalam container contoh, melihat lognya, dan mengelola siklus prosesnya menggunakan gcloud CLI.

Sebelum memulai

1. Instal Google Cloud CLI.

   Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

2. Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.

   Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.

3. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

   gcloud init

4. Buat atau pilih Google Cloud project.

   Peran yang diperlukan untuk memilih atau membuat project

   • Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
   • Membuat project: Untuk membuat project, Anda memerlukan peran Project Creator (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.
   Catatan: Jika Anda 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.

   • Buat Google Cloud project:

     gcloud projects create PROJECT_ID

     Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

   • Pilih project Google Cloud yang Anda buat:

     gcloud config set project PROJECT_ID

     Ganti PROJECT_ID dengan nama project Google Cloud Anda.

5. Jika Anda menggunakan project yang sudah ada untuk panduan ini, pastikan Anda memiliki izin yang diperlukan untuk menyelesaikan panduan ini. Jika berhasil membuat project baru, berarti Anda sudah memiliki izin yang diperlukan.

6. Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

7. Aktifkan Cloud Run Admin API dan Cloud Logging API:

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   gcloud services enable run.googleapis.com logging.googleapis.com

8. Guna menetapkan project default untuk instance Cloud Run Anda:

   gcloud config set project PROJECT_ID

   Ganti PROJECT_ID dengan nama project yang Anda buat untuk panduan memulai ini.
9. Pastikan Anda telah menginstal komponen gcloud beta:

   gcloud components install beta

10. Tinjau harga Cloud Run atau perkirakan biaya dengan kalkulator harga.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan panduan memulai ini, minta administrator untuk memberi Anda peran IAM berikut:

• Admin Cloud Run (roles/run.admin) di instance
• Pengguna Akun Layanan (roles/iam.serviceAccountUser) pada identitas layanan
• Logs Viewer (roles/logging.viewer) di project

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat instance

Untuk membuat instance Cloud Run dalam container contoh menggunakan gcloud CLI:

1. Jalankan perintah berikut:

   gcloud beta run instances create my-instance \
   --image us-docker.pkg.dev/cloudrun/container/hello \
   --region REGION \
   --port 8080 \
   --no-invoker-iam-check

   Ganti REGION dengan region Google Cloud yang didukung.

   Flag --no-invoker-iam-check menonaktifkan autentikasi pemanggil IAM, sehingga URL instance dapat diakses tanpa autentikasi IAM.

2. Tunggu hingga pembuatan instance selesai. Setelah selesai, perintah akan menampilkan output yang mirip dengan:

   Creating instance...
   Importing container..............done
   Provisioning resources.......done
   Starting instance.....done
   Done.
   Instance [my-instance] has successfully been created.
   
   URL: https://my-instance-PROJECT-NUMBER.REGION.run.app
   

3. Buka URL yang ditampilkan di browser Anda untuk berinteraksi dengan container yang sedang berjalan.

Melihat log instance

Untuk melihat log yang dihasilkan oleh instance Cloud Run Anda:

1. Di konsol Google Cloud , buka Logs Explorer:

   Buka Logs Explorer

2. Filter log untuk instance spesifik Anda:

   resource.type="cloud_run_instance"
   resource.labels.location="<var>REGION</var>"
   resource.labels.instance_name="my-instance"
   

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan di halaman ini, ikuti langkah-langkah berikut.

Menghapus instance Anda

Untuk menghentikan dan menghapus instance Cloud Run:

gcloud beta run instances delete my-instance --region REGION

Menghapus project pengujian Anda

Menghapus project Google Cloud akan menghentikan penagihan untuk semua resource dalam project tersebut. Untuk melepaskan semua Google Cloud resource di project Anda, ikuti langkah-langkah berikut:

Perhatian: Penghapusan project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Menghapus Google Cloud project:

gcloud projects delete PROJECT_ID

Langkah berikutnya

Untuk mengetahui informasi selengkapnya tentang instance Cloud Run, lihat:

• Membuat dan mengelola instance Cloud Run
• Siklus proses instance Cloud Run