Cloud Code secara otomatis menginstal dan mengelola minikube. Jika Anda memilih tidak ikut dalam pengelolaan dependensi, tambahkan biner minikube ke PATH
.
Sebelum memulai
- Instal Git agar Cloud Code dapat menjalankan operasi Git, seperti meng-clone sampel.
- Instal plugin Cloud Code jika Anda belum melakukannya.
Membuat aplikasi dari template
Cloud Code dilengkapi dengan kumpulan template contoh kode untuk membantu Anda memulai dengan cepat. Untuk membuat aplikasi Kubernetes menggunakan contoh yang ada, ikuti langkah-langkah berikut:
- Luncurkan Palet Perintah (tekan
Ctrl
/Cmd
+Shift
+P
atau klik View > Command Palette), lalu jalankan Cloud Code: New Application. - Pilih Kubernetes application untuk jenis sampel.
- Pilih contoh berdasarkan bahasa yang ingin Anda gunakan dari opsi yang tersedia: NodeJS, Go, Python, Java.
Pilih lokasi aplikasi yang disukai di komputer lokal Anda, lalu klik Create new application untuk menyimpan.
Cloud Code meng-clone sampel yang Anda pilih dan membuka project baru untuk digunakan.
Contoh struktur aplikasi
Semua aplikasi contoh bahasa memiliki struktur yang hampir sama. Ini bukan satu-satunya struktur yang didukung, tetapi direkomendasikan saat memulai.
Misalnya, struktur aplikasi Buku Tamu Node.js akan terlihat seperti ini:
.
|---- .vscode
| └---- launch.json
|---- kubernetes-manifests
| |---- guestbook-backend.deployment.yaml
| |---- guestbook-backend.service.yaml
| |---- guestbook-frontend.deployment.yaml
| |---- guestbook-frontend.service.yaml
| |---- mongo.deployment.yaml
| └---- mongo.service.yaml
|---- src
| |---- backend
| | |---- Dockerfile
| | |---- index.js
| | |---- app.js
| | └---- package.json
| |---- frontend
| |---- Dockerfile
| |---- index.js
| | |---- app.js
| └---- package.json
└---- skaffold.yaml
Melihat lebih dekat aplikasi contoh Node.js Buku Tamu Kubernetes ini, berikut adalah beberapa file utama dan penggunaannya:
- .vscode
extensions.json
: perintah yang meminta download ekstensi terkait saat membuka project inilaunch.json
: konfigurasi peluncuran (dengan jeniscloudcode.kubernetes
) untuk menjalankan atau men-debug aplikasi Kubernetestasks.json
: informasi konfigurasi untuk Tugas Kode Visual Studio
- kubernetes-manifests
guestbook-backend.deployment.yaml
: Spesifikasi pod untuk node backendguestbook-frontend.deployment.yaml
: Spesifikasi pod untuk node frontendmongo.deployment.yaml
: Spesifikasi pod untuk database
- src
(backend|frontend)/app.js
: Kode Node.js dengan logika server web(backend|frontend)/Dockerfile
: digunakan untuk membangun image container untuk program kami
skaffold.yaml
: file konfigurasi untuk Skaffold, yang digunakan Cloud Code untuk membangun, men-deploy, dan men-debug aplikasi Kubernetes
Gunakan aplikasi Anda sendiri
Untuk langkah-langkah cara menggunakan project yang ada, lihat menggunakan Cloud Code dengan aplikasi Kubernetes yang ada.
Menetapkan konteks Kubernetes
Sebelum menjalankan aplikasi, pastikan Anda sudah siap men-deploy aplikasi ke konteks Kubernetes pilihan Anda. Anda dapat menetapkannya di konfigurasi.
Konfigurasi
Saat menggunakan konfigurasi run Cloud Code: Mengembangkan di Kubernetes, Anda dapat menyesuaikan deployment dengan mengonfigurasi setelan yang tersedia.
Untuk menambahkan atau mengedit konfigurasi, buka Run > Open Configurations, lalu edit atau tambahkan konfigurasi.Membuat dan men-deploy ke cluster minikube
Mulai cluster minikube
Cloud Code secara otomatis menginstal dan mengelola minikube. Jika Anda memilih tidak ikut dalam pengelolaan dependensi, tambahkan biner minikube ke PATH
.
- Luncurkan Palet Perintah (tekan
Ctrl
/Cmd
+Shift
+P
atau klik View > Command Palette), lalu jalankan perintah Cloud Code: Control minikube. - Klik minikube untuk Choose a Minikube cluster (profile) to control lalu klik Start.
Jalankan di minikube
- Luncurkan Palet Perintah dan jalankan Cloud Code: Run on Kubernetes.
- Klik Yes untuk Use current context (minikube) untuk menjalankan aplikasi?
Cloud Code menjalankan aplikasi Anda di cluster minikube. Jika diminta, izinkan Cloud Shell untuk menggunakan kredensial Anda untuk melakukan panggilan Google Cloud API.
Lihat detail deployment di bagian Sesi pengembangan pada Cloud Code.
Lihat URL dengan mengklik Portfoward URLs di bagian Development session, lalu klik link URL untuk membuka browser dengan aplikasi yang sedang berjalan.
Membuka terminal interaktif ke container
- Klik Cloud Code, lalu luaskan explorer Development Sessions.
- Luaskan Deployed Resources, lalu luaskan Pods.
- Klik kanan container lalu klik Get Terminal.
Menjeda atau menghentikan cluster minikube
- Luncurkan Palet Perintah (tekan
Ctrl
/Cmd
+Shift
+P
atau klik View > Command Palette), lalu jalankan perintah Cloud Code: Control minikube. - Setelah opsi Choose a Minikube cluster (profile) to control terisi, klik minikube lalu klik Stop atau Pause.
Membuat dan menambahkan cluster dari penyedia cloud lain
Jika Anda menggunakan cluster lokal atau cluster dari penyedia lain seperti Azure atau AWS, gunakan alat dari penyedia tersebut untuk membuat cluster dan menambahkannya ke KubeConfig Anda.
Bekerja dengan cluster lokal lainnya
Selain minikube, Anda dapat menggunakan Cloud Code jika menggunakan Docker Desktop (untuk Mac atau Windows).
Agar Cloud Code dapat berfungsi dengan cluster lokal, pastikan konfigurasi default Anda (misalnya, ~/.kube/config
) berisi cluster lokal Anda. Cluster ini harus ditetapkan sebagai konteks saat ini.
Misalnya, jika Anda menggunakan cluster lokal, docker-for-desktop
, dengan Docker Desktop, tetapkan cluster pilihan Anda dengan menjalankan perintah berikut:
kubectl config use-context docker-for-desktop
Langkah selanjutnya
- Gunakan sinkronisasi file dan hot reload untuk mempercepat pengembangan.
- Mendebug aplikasi Anda di Cloud Code