Menggunakan minikube untuk pengembangan lokal pada Cloud Code untuk VS Code

Cloud Code secara otomatis menginstal dan mengelola minikube. Jika Anda memilih tidak ikut dalam pengelolaan dependensi, tambahkan biner minikube ke PATH.

Sebelum memulai

  1. Instal Git agar Cloud Code dapat menjalankan operasi Git, seperti meng-clone sampel.
  2. 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:

  1. Luncurkan Palet Perintah (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette), lalu jalankan Cloud Code: New Application.
  2. Pilih Kubernetes application untuk jenis sampel.
  3. Pilih contoh berdasarkan bahasa yang ingin Anda gunakan dari opsi yang tersedia: NodeJS, Go, Python, Java.
  4. 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 ini
    • launch.json: konfigurasi peluncuran (dengan jenis cloudcode.kubernetes) untuk menjalankan atau men-debug aplikasi Kubernetes
    • tasks.json: informasi konfigurasi untuk Tugas Kode Visual Studio
  • kubernetes-manifests
    • guestbook-backend.deployment.yaml: Spesifikasi pod untuk node backend
    • guestbook-frontend.deployment.yaml: Spesifikasi pod untuk node frontend
    • mongo.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.

  1. Luncurkan Palet Perintah (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette), lalu jalankan perintah Cloud Code: Control minikube.
  2. Klik minikube untuk Choose a Minikube cluster (profile) to control lalu klik Start.

Jalankan di minikube

  1. Luncurkan Palet Perintah dan jalankan Cloud Code: Run on Kubernetes.
  2. Klik Yes untuk Use current context (minikube) untuk menjalankan aplikasi?
  3. 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.

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

  1. Klik Cloud Code, lalu luaskan explorer Development Sessions.
  2. Luaskan Deployed Resources, lalu luaskan Pods.
  3. Klik kanan container lalu klik Get Terminal.

Menjeda atau menghentikan cluster minikube

  1. Luncurkan Palet Perintah (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette), lalu jalankan perintah Cloud Code: Control minikube.
  2. 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

Dapatkan Dukungan

Untuk mengirim masukan, laporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.