Panduan memulai: Deploy layanan Java ke Cloud Run
Pelajari cara membuat aplikasi Hello World sederhana, memaketkannya ke dalam image container, mengupload image container ke Artifact Registry, lalu men-deploy image container ke Cloud Run. Anda dapat menggunakan bahasa lain selain yang sudah ditampilkan.
Untuk mengikuti panduan langkah demi langkah untuk tugas ini secara langsung di Cloud Shell Editor, klik Pandu saya:
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.
- 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.
- Menginstal Google Cloud CLI.
-
Untuk initialize gcloud CLI, jalankan perintah berikut:
gcloud init
- Guna menetapkan project default untuk layanan Cloud Run Anda:
Ganti PROJECT_ID dengan nama project yang Anda buat untuk panduan memulai ini.gcloud config set project PROJECT_ID
Jika Anda dikenai kebijakan organisasi pembatasan domain yang membatasi pemanggilan yang tidak terautentikasi untuk project, Anda perlu mengakses layanan yang di-deploy seperti yang dijelaskan di bagian Menguji layanan pribadi.
Menulis aplikasi contoh
Untuk menulis aplikasi di Java:
Buat aplikasi Spring Boot.
Dari konsol, buat project web kosong baru menggunakan perintah cURL dan ekstrak:
curl https://start.spring.io/starter.zip \ -d type=maven-project \ -d bootVersion=3.2.1 \ -d dependencies=web \ -d javaVersion=17 \ -d name=helloworld \ -d artifactId=helloworld \ -d baseDir=helloworld \ -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 command line berikut, atau jika perlu, Anda dapat menggunakan Spring Initializr (configuration pre pramuat) untuk membuat project:
Perbarui kelas
HelloworldApplication
src/main/java/com/example/helloworld/HelloworldApplication.java
dengan menambahkan@RestController
untuk menangani/
pemetaan serta tambahkan@Value
kolom untuk menyediakan NAMA variabel lingkungan:Atur port server yang akan ditentukan oleh PORT variabel lingkungan di
application.properties
:Kode ini menghasilkan sebuah web server dasar yang memantau port yang ditentukan oleh variabel
PORT
lingkungan.Buat file
project.toml
di direktorisrc/main/java/com/example/helloworld/
untuk menentukan versi Java:[[build.env]] name = "GOOGLE_RUNTIME_VERSION" value = "17"
Aplikasi Anda sudah selesai dan siap untuk di-deploy.
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. Atau melihat izin deployment Cloud Run, izin Cloud Build, dan izin Artifact Registry untuk izin yang diperlukan.
Men-deploy dari sumber secara otomatis akan mem-build image container dari kode sumber dan men-deploy-nya.
Untuk men-deploy dari sumber:
Dalam direktori kode sumber Anda, deploy dari sumber menggunakan perintah berikut:
gcloud run deploy
Jika diminta mengaktifkan API, Balas y untuk mengaktifkan.
Ketika Anda diminta untuk memasukkan lokasi kode sumber, tekan Enter untuk men-deploy folder saat ini.
Saat diminta memasukkan nama layanan, tekan Enter untuk menerima nama default, misalnya
helloworld
.Jika Anda diminta untuk mengaktifkan Artifact Registry API atau mengizinkan pembuatan repositori Artifact Registry, tanggapi dengan menekan
y
.Saat Anda diminta untuk memasukkan region: pilih region pilihan Anda, misalnya
us-central1
.Anda akan diminta untuk mengizinkan pemanggilan yang tidak diautentikasi: merespons
y
.
Lalu tunggu sebentar sampai proses deployment selesai. Jika berhasil, command line akan menampilkan URL layanannya.
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) CO2 Rendaheurope-southwest1
(Madrid)europe-west1
(Belgia) CO2 Rendaheurope-west4
(Belanda)europe-west8
(Milan)europe-west9
(Paris) CO2 Rendahme-west1
(Tel Aviv)us-central1
(Iowa) CO2 rendahus-east1
(South Carolina)us-east4
(North Virginia)us-east5
(Columbus)us-south1
(Dallas)us-west1
(Oregon) CO2 Rendah
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)europe-west12
(Turin)europe-west2
(London, Inggris Raya) CO2 Rendaheurope-west3
(Frankfurt, Jerman) CO2 Rendaheurope-west6
(Zurich, Swiss) CO2 Rendahme-central1
(Doha)me-central2
(Damam)northamerica-northeast1
(Montreal) CO2 Rendahnorthamerica-northeast2
(Toronto) CO2 Rendahsouthamerica-east1
(Sao Paulo, Brasil) CO2 Rendahsouthamerica-west1
(Santiago, Cile) CO2 Rendahus-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.
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.
- Di konsol Google Cloud, buka halaman Manage resource.
- Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
Langkah selanjutnya
Untuk informasi lebih lanjut dalam mem-build container dari kode sumber dan penerapan untuk repositori, lihat: