Panduan memulai: Men-deploy layanan Kotlin ke Cloud Run

Panduan memulai: Men-deploy layanan Kotlin ke Cloud Run

Pelajari cara membuat aplikasi Hello World sederhana, mengemasnya ke image container, mengupload image container ke Artifact Registry, dan lalu deploy image container ke Cloud Run.

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. Menginstal Google Cloud CLI.

5. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

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

6. 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

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

8. Menginstal Google Cloud CLI.

9. Untuk initialize gcloud CLI, jalankan perintah berikut:

   gcloud init

   Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
10. Guna menetapkan project default untuk layanan Cloud Run Anda:

     gcloud config set project PROJECT_ID

    Ganti PROJECT_ID dengan nama project yang Anda buat untuk panduan memulai ini.

11. 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.

12. Aktifkan Cloud Run Admin API:

    gcloud services enable run.googleapis.com

    Setelah Cloud Run Admin API diaktifkan, akun layanan default Compute Engine akan otomatis dibuat.

13. 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.

Menulis aplikasi contoh

Untuk menulis aplikasi di Kotlin:

Buat aplikasi Spring Boot.

1. Dari konsol, buat project web kosong baru menggunakan perintah cURL dan ekstrak:

   curl https://start.spring.io/starter.zip \
       -d language=kotlin \
       -d type=gradle-project-kotlin \
       -d bootVersion=3.2.5 \
       -d dependencies=webflux \
       -d javaVersion=17 \
       -d name=Demo \
       -d artifactId=helloworld \
       -d baseDir=helloworld \
       -d packageName=demo \
       -o helloworld.zip
   unzip helloworld.zip
   cd helloworld
   

   Langkah ini menghasilkan project Spring Boot.

   Untuk menggunakan perintah cURL ini di Microsoft Windows, Anda memerlukan salah satu dari command line berikut, atau jika perlu, gunakan Spring Initializr (konfigurasi bawaan) untuk membuat project:

   • WSL (pilihan)
   • cygwin

2. Perbarui class DemoApplication di src/main/kotlin/DemoApplication.kt dengan menambahkan @RestController untuk menangani pemetaan /:

   package demo
   
   import kotlinx.coroutines.delay
   import org.springframework.boot.autoconfigure.SpringBootApplication
   import org.springframework.boot.runApplication
   import org.springframework.web.bind.annotation.GetMapping
   import org.springframework.web.bind.annotation.RestController
   
   @SpringBootApplication
   @RestController
   class DemoApplication {
   
       @GetMapping("/")
       suspend fun index() = run {
           delay(10)
           "hello, world"
       }
   }
   
   fun main(args: Array<String>) {
       runApplication<DemoApplication>(*args)
   }
   

3. Atur port server yang akan ditentukan oleh PORT variabel lingkungan di application.properties:

   server.port=${PORT:8080}
   

   Kode ini menghasilkan sebuah web server dasar yang memantau port yang ditentukan oleh variabel PORT lingkungan.

4. Buat file project.toml di direktori utama untuk menentukan versi Java:

   [[build.env]]
   name =  "GOOGLE_RUNTIME_VERSION"
   value = "17"
   

Aplikasi Anda sudah selesai dan siap untuk di-deploy.

Catatan: Untuk men-deploy Kotlin ke Cloud Run dengan framework lain, tinjau Contoh Kotlin.

Men-deploy ke Cloud Run dari sumber

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 guna mendapatkan izin yang diperlukan untuk men-deploy resource Cloud Run dari sumber.

Men-deploy dari sumber secara otomatis akan mem-build image container dari kode sumber dan men-deploy-nya.

Untuk men-deploy dari sumber:

1. Dalam direktori kode sumber Anda, deploy dari sumber menggunakan perintah berikut:

   gcloud run deploy

   Jika diminta mengaktifkan API, Balas y untuk mengaktifkan.

   1. Ketika Anda diminta untuk memasukkan lokasi kode sumber, tekan Enter untuk men-deploy folder saat ini.

   2. Saat diminta memasukkan nama layanan, tekan Enter untuk menerima nama default, misalnya helloworld.

   3. Jika Anda diminta untuk mengaktifkan API pada project, misalnya, Artifact Registry API, merespons dengan menekan y.

   4. Saat Anda diminta untuk memasukkan region: pilih region pilihan Anda, misalnya us-central1.

   5. Jika Anda diminta untuk membuat repositori di region yang ditentukan, respons dengan menekan y.

   6. Jika Anda diminta untuk mengizinkan pemanggilan yang tidak diautentikasi: respons y. Anda mungkin tidak akan melihat dialog ini jika ada domain pembatasan kebijakan organisasi yang mencegahnya; untuk mengetahui detail selengkapnya, lihat Bagian Sebelum memulai.

   Lalu tunggu sebentar sampai proses deployment selesai. Jika berhasil, command line akan menampilkan URL layanannya.

2. Kunjungi layanan yang telah di-deploy dengan membuka URL layanan pada browser web.

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

Selamat! Anda baru saja men-deploy image container dari kode sumber ke Cloud Run. Cloud Run meningkatkan skala image container secara otomatis dan horizontal untuk menangani permintaan yang diterima, lalu menurunkan skala saat permintaan berkurang. Anda hanya membayar untuk CPU, memori, dan jaringan yang terpakai selama penanganan permintaan.

Pembersihan

Menghapus project pengujian Anda

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 berikutnya

Untuk informasi lebih lanjut dalam mem-build container dari kode sumber dan penerapan untuk repositori, lihat:

• Mengembangkan layanan Cloud Run
• Mem-build Container
• Men-deploy dari kode sumber