Ringkasan

Cloud Run adalah platform komputasi terkelola yang memungkinkan Anda untuk menjalankan container stateless yang dapat dipanggil melalui permintaan HTTP. Cloud Run bersifat serverless. Platform ini memisahkan semua pengelolaan infrastruktur di lokasi lain, sehingga Anda dapat berfokus pada hal terpenting, yakni membangun aplikasi yang andal.

Sasaran lab ini adalah untuk mempersiapkan Anda membangun image aplikasi sederhana dalam container dan men-deploy-nya di Cloud Run.

Tujuan

Di lab ini, Anda mempelajari cara:

• Mengaktifkan Cloud Run dan Artifact Registry API.
• Membuat aplikasi Node.js sederhana yang dapat di-deploy sebagai container stateless serverless.
• Membuat repositori Artifact Registry.
• Memasukkan aplikasi ke dalam container dan menguploadnya ke Artifact Registry.
• Men-deploy aplikasi dalam container di Cloud Run.
• Menghapus image yang tidak diperlukan untuk menghindari timbulnya biaya penyimpanan tambahan.

Penyiapan dan persyaratan

Untuk setiap lab, Anda akan memperoleh project Google Cloud baru serta serangkaian resource selama jangka waktu tertentu, tanpa biaya.

1. Klik tombol Start Lab. Jika Anda perlu membayar lab, jendela pop-up akan terbuka untuk memilih metode pembayaran. Di sebelah kiri adalah panel Lab Details yang memuat sebagai berikut:

   • Tombol Open Google Cloud console
   • Waktu tersisa
   • Kredensial sementara yang harus Anda gunakan untuk lab ini
   • Informasi lain, jika diperlukan, untuk menyelesaikan lab ini

2. Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).

   Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.

   Tips: Atur tab di jendela terpisah secara berdampingan.

   Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.

3. Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.

   {{{user_0.username | "Username"}}}

   Anda juga dapat menemukan Username di panel Lab Details.

4. Klik Next.

5. Salin Password di bawah dan tempel ke dialog Welcome.

   {{{user_0.password | "Password"}}}

   Anda juga dapat menemukan Password di panel Lab Details.

6. Klik Next.

   Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda. Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.

7. Klik halaman berikutnya:

   • Setujui persyaratan dan ketentuan.
   • Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
   • Jangan mendaftar uji coba gratis.

Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.

Catatan: Untuk melihat menu yang berisi daftar produk dan layanan Google Cloud, klik Navigation menu di kiri atas, atau ketik nama layanan atau produk di kolom Search.

Mengaktifkan Google Cloud Shell

Google Cloud Shell adalah virtual machine yang dilengkapi dengan berbagai fitur pengembangan. Virtual machine ini menawarkan direktori beranda persisten berkapasitas 5 GB dan berjalan di Google Cloud.

Google Cloud Shell menyediakan akses command line untuk resource Google Cloud Anda.

1. Di Cloud Console, pada toolbar di kanan atas, klik tombol Open Cloud Shell.

   

2. Klik Continue.

Proses menyediakan dan menghubungkan ke lingkungan memerlukan waktu beberapa saat. Setelah terhubung, Anda sudah diautentikasi, dan project ditetapkan ke PROJECT_ID Anda. Contoh:

gcloud adalah alat command line untuk Google Cloud. Alat ini sudah terinstal di Cloud Shell dan mendukung pelengkapan command line.

• Anda dapat menampilkan daftar nama akun yang aktif dengan perintah ini:

gcloud auth list

Output:

Akun berkredensial: - @.com (aktif)

Contoh output:

Akun berkredensial: - google1623327_student@qwiklabs.net

• Anda dapat menampilkan daftar project ID dengan perintah ini:

gcloud config list project

Output:

[core] project =

Contoh output:

[core] project = qwiklabs-gcp-44776a13dea667a6 Catatan: Dokumentasi lengkap gcloud tersedia dalam panduan ringkasan gcloud CLI .

Referensi

Perintah Linux Dasar

Di bawah ini Anda akan menemukan daftar referensi untuk beberapa perintah Linux paling mendasar yang mungkin diberikan dalam petunjuk atau blok kode untuk lab ini.

Perintah -->	Tindakan	.	Perintah -->	Tindakan
mkdir (make directory)	membuat folder baru	.	cd (change directory)	mengubah lokasi ke folder lain
ls (list )	mencantumkan file dan folder di direktori	.	cat (concatenate)	membaca konten file tanpa menggunakan editor
apt-get update	mengupdate library pengelola paket	.	ping	sinyal untuk menguji keterjangkauan host
mv (move )	memindahkan file	.	cp (copy)	membuat salinan file
pwd (present working directory )	kembali ke lokasi Anda saat ini	.	sudo (super user do)	memberi hak istimewa administrator yang lebih tinggi

Tugas 1. Mengaktifkan Cloud Run API dan mengonfigurasi lingkungan Shell

Dalam tugas ini, Anda akan mengaktifkan API yang diperlukan dan menyiapkan variabel lingkungan untuk menyederhanakan perintah Anda.

1. Dari Cloud Shell, aktifkan Cloud Run API dan Artifact Registry API. Dengan demikian, project Anda akan menerima permintaan untuk layanan berikut:

gcloud services enable run.googleapis.com artifactregistry.googleapis.com

2. Lakukan otorisasi penggunaan kredensial Anda jika diminta. Anda kemudian akan melihat pesan seperti berikut yang menandakan bahwa prosesnya berhasil:

Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully. Catatan: Anda juga dapat mengaktifkan API melalui bagian APIs & Services pada konsol Google Cloud.

3. Tetapkan region komputasi:

gcloud config set compute/region {{{project_0.default_region | "REGION"}}}

4. Buat variabel lingkungan LOCATION:

LOCATION="{{{project_0.default_region | Region}}}"

Tugas 2. Menulis aplikasi contoh

Dalam tugas ini, Anda akan membangun aplikasi NodeJS sederhana berbasis express yang merespons permintaan HTTP.

1. Di Cloud Shell, buat direktori baru bernama helloworld, lalu pindahkan tampilan Anda ke dalam direktori tersebut:

mkdir helloworld && cd helloworld

2. Berikutnya, Anda akan membuat dan mengedit file. Untuk mengedit file, gunakan nano atau Editor Kode Cloud Shell dengan mengklik tombol Open Editor di Cloud Shell.

3. Buat file package.json, lalu tambahkan konten berikut ke dalamnya:

nano package.json { "name": "helloworld", "description": "Simple hello world sample in Node", "version": "1.0.0", "main": "index.js", "scripts": { "start": "node index.js" }, "author": "Google LLC", "license": "Apache-2.0", "dependencies": { "express": "^4.17.1" } }

Dan yang paling penting, file di atas berisi perintah mulai skrip dan dependensi pada framework aplikasi web Express.

4. Tekan CTRL+X, lalu Y, kemudian Enter untuk menyimpan file package.json.

5. Berikutnya, di direktori yang sama, buat file index.js, lalu tempel baris berikut ke dalamnya:

nano index.js const express = require('express'); const app = express(); const port = process.env.PORT || 8080; app.get('/', (req, res) => { const name = process.env.NAME || 'World'; res.send(`Hello ${name}!`); }); app.listen(port, () => { console.log(`helloworld: listening on port ${port}`); });

Kode ini menghasilkan server web dasar yang memantau (listen) port yang ditentukan oleh variabel lingkungan PORT. Aplikasi Anda kini sudah jadi dan siap dimasukkan ke dalam container serta diupload ke Artifact Registry.

6. Tekan CTRL+X, lalu Y, kemudian Enter untuk menyimpan file index.js.

Catatan: Anda dapat menggunakan bahasa pemrograman lainnya untuk mulai menggunakan Cloud Run. Petunjuk untuk skrip Go, Python, Java, PHP, Ruby, Shell, dan lainnya dapat ditemukan di Panduan memulai.

Tugas 3. Membuat repositori Artifact Registry

Dalam tugas ini, Anda akan membuat repositori di Artifact Registry. Repositori ini akan bertindak sebagai lokasi penyimpanan image container Anda, sehingga layanan Google Cloud dapat mengakses dan menariknya.

1. Buat repositori Docker baru bernama my-repository di region Anda:

gcloud artifacts repositories create my-repository \ --repository-format=docker \ --location=$LOCATION \ --description="Docker repository"

2. Konfigurasi Docker guna mengautentikasi permintaan untuk Artifact Registry di region Anda:

gcloud auth configure-docker $LOCATION-docker.pkg.dev

Klik Periksa progres saya untuk memverifikasi tujuan. Membuat repositori Artifact Registry

Tugas 4. Memasukkan aplikasi ke dalam container dan menguploadnya ke Artifact Registry

Dalam tugas ini, Anda akan memasukkan aplikasi contoh ke dalam container dan mengirim image ke Artifact Registry.

1. Untuk memasukkan aplikasi contoh ke dalam container, buat file baru bernama Dockerfile di dalam direktori yang sama dengan file sumber. File ini berfungsi sebagai resep, yang menginstruksikan Docker cara membangun image Anda:

nano Dockerfile # Gunakan image resmi Node.js 12 versi ringan. # https://hub.docker.com/_/node DARI node:20-slim # Buat dan ubah ke direktori aplikasi. WORKDIR /usr/src/app # Salin manifes dependensi aplikasi ke image container. # A wildcard is used to ensure copying both package.json AND package-lock.json (when available). # Copying this first prevents re-running npm install on every code change. COPY package*.json ./ # Install production dependencies. # If you add a package-lock.json, speed your build by switching to 'npm ci'. # JALANKAN npm ci --only=production JALANKAN npm install --only=production # Salin kode lokal ke image container. COPY . ./ # Run the web service on container startup. CMD [ "npm", "start" ]

2. Tekan CTRL+X, lalu Y, kemudian Enter untuk menyimpan file Dockerfile.

3. Sekarang, bangun image container Anda menggunakan Cloud Build dengan menjalankan perintah berikut dari direktori yang berisi Dockerfile. (Perhatikan variabel lingkungan $GOOGLE_CLOUD_PROJECT di perintah, yang berisi ID Project lab Anda):

gcloud builds submit --tag $LOCATION-docker.pkg.dev/$GOOGLE_CLOUD_PROJECT/my-repository/helloworld

Cloud Build adalah layanan yang menjalankan build Anda di Google Cloud. Dengan satu perintah, layanan ini menjalankan serangkaian langkah build yang masing-masing dijalankan dalam container Docker untuk menghasilkan container aplikasi Anda (atau artefak lain), lalu mengirimkannya ke Artifact Registry.

Setelah dikirimkan ke registry, Anda akan melihat pesan SUCCESS yang berisi nama image. Image tersebut disimpan di Artifact Registry dan dapat digunakan kembali bila diinginkan.

4. Untuk menjalankan dan menguji aplikasi secara lokal dari Cloud Shell, gunakan perintah docker standar ini:

docker run -d -p 8080:8080 $LOCATION-docker.pkg.dev/$GOOGLE_CLOUD_PROJECT/my-repository/helloworld

5. Di jendela Cloud Shell, klik Web preview lalu pilih Preview on port 8080.

Tindakan ini akan membuka jendela browser berisi pesan "Hello World!". Anda juga dapat menggunakan curl localhost:8080.

Klik Periksa progres saya untuk memverifikasi tujuan. Memasukkan aplikasi ke dalam container dan menguploadnya ke Artifact Registry

Tugas 5. Men-deploy ke Cloud Run

Dalam tugas ini, Anda akan men-deploy aplikasi dalam container ke Cloud Run. Proses ini menjalankan layanan yang dapat merespons permintaan web melalui URL HTTPS yang aman.

1. Deploy aplikasi dalam container Anda ke Cloud Run menggunakan perintah berikut:

gcloud run deploy helloworld \ --image $LOCATION-docker.pkg.dev/$GOOGLE_CLOUD_PROJECT/my-repository/helloworld \ --allow-unauthenticated \ --region=$LOCATION

Flag allow-unauthenticated pada perintah di atas akan membuat layanan Anda dapat diakses secara publik.

2. Jika diminta untuk mengaktifkan API, ketik Y.

Tunggu sebentar sampai proses deployment selesai. Jika berhasil, command line akan menampilkan URL layanan:

Service [helloworld] revision [helloworld-00001-xit] has been deployed and is serving 100 percent of traffic. Service URL: https://helloworld-h6cp412q3a-uc.a.run.app

Sekarang Anda dapat melihat container yang telah di-deploy dengan membuka URL layanan di jendela browser apa pun.

Selamat! Anda telah men-deploy aplikasi yang dikemas dalam image container ke Cloud Run. Cloud Run meningkatkan skala image container secara otomatis dan horizontal untuk menangani permintaan yang diterima, lalu menurunkan skala saat permintaan berkurang. Di lingkungan Anda sendiri, Anda hanya membayar untuk CPU, memori, dan jaringan yang terpakai selama permintaan ditangani.

Untuk lab ini, Anda telah menggunakan command line gcloud. Cloud Run juga tersedia melalui Konsol Cloud.

3. Di Konsol Google Cloud, pada Navigation menu (), klik Cloud Run dan Anda akan melihat layanan helloworld Anda tercantum:

Klik Periksa progres saya untuk memverifikasi tujuan. Men-deploy aplikasi dalam container di Cloud Run

Tugas 6. Pembersihan

Dalam tugas ini, Anda akan menghapus layanan yang di-deploy dan image container untuk menghindari biaya.

Meskipun Cloud Run tidak mengenakan biaya selama layanannya tidak digunakan, Anda mungkin akan tetap ditagih atas penyimpanan image container yang telah dibuat.

1. Anda dapat menghapus image helloworld menggunakan perintah berikut:

gcloud artifacts docker images delete $LOCATION-docker.pkg.dev/$GOOGLE_CLOUD_PROJECT/my-repository/helloworld

2. Jika diminta untuk melanjutkan, ketik Y, lalu tekan Enter.

3. Untuk menghapus layanan Cloud Run, gunakan perintah berikut:

gcloud run services delete helloworld --region={{{project_0.default_region | "REGION"}}}

4. Jika diminta untuk melanjutkan, ketik Y, lalu tekan Enter.

Mengakhiri lab Anda

Setelah Anda menyelesaikan lab, klik Akhiri Lab. Google Skills menghapus resource yang telah Anda gunakan dan membersihkan akun.

Anda akan diberi kesempatan untuk menilai pengalaman menggunakan lab. Pilih jumlah bintang yang sesuai, ketik komentar, lalu klik Submit.

Makna jumlah bintang:

• 1 bintang = Sangat tidak puas
• 2 bintang = Tidak puas
• 3 bintang = Netral
• 4 bintang = Puas
• 5 bintang = Sangat puas

Anda dapat menutup kotak dialog jika tidak ingin memberikan masukan.

Untuk masukan, saran, atau koreksi, gunakan tab Support.

Selamat!

Anda telah menyelesaikan lab ini!

Langkah berikutnya/pelajari lebih lanjut

Untuk mengetahui informasi selengkapnya tentang cara membangun container HTTP stateless yang cocok untuk Cloud Run dari sumber kode dan mengirimkannya ke Artifact Registry, baca artikel:

• Mengembangkan layanan Cloud Run
• Membangun Container

Hak cipta 2026 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.