Menggunakan minikube untuk pengembangan lokal di Cloud Code untuk VS Code

Cloud Code otomatis menginstal dan mengelola minikube. Jika Anda memilih untuk tidak menggunakan pengelolaan dependensi, tambahkan biner minikube ke PATH.

Sebelum memulai

  1. Instal Git agar Cloud Code dapat melakukan 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 Command Palette (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette), lalu jalankan Cloud Code: New Application.
  2. Pilih Aplikasi Kubernetes untuk jenis sampel.
  3. Pilih sampel berdasarkan bahasa yang ingin Anda gunakan dari opsi yang tersedia: NodeJS, Go, Python, Java.

  4. Pilih lokasi aplikasi yang diinginkan di komputer lokal Anda, lalu klik Create new application untuk menyimpan.

    Cloud Code akan meng-clone contoh 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 terlihat seperti:

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

Untuk melihat lebih dekat aplikasi contoh Node.js Buku Tamu Kubernetes ini, berikut beberapa file utama dan penggunaannya:

  • .vscode
    • extensions.json: perintah yang meminta download ekstensi terkait saat membuka project ini
    • launch.json: konfigurasi peluncuran (jenis cloudcode.kubernetes) untuk menjalankan atau men-debug aplikasi Kubernetes
    • tasks.json: informasi konfigurasi untuk Visual Studio Code Tasks
  • 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 mem-build image container untuk program kita
  • skaffold.yaml: file konfigurasi untuk Skaffold, yang digunakan Cloud Code untuk mem-build, men-deploy, dan men-debug aplikasi Kubernetes

Menggunakan aplikasi Anda sendiri

Untuk mengetahui langkah-langkah menggunakan project yang ada, lihat menggunakan Cloud Code dengan aplikasi Kubernetes yang ada.

Menetapkan konteks Kubernetes

Sebelum menjalankan aplikasi, pastikan Anda siap men-deploy aplikasi ke konteks Kubernetes pilihan Anda. Anda dapat menentukannya di konfigurasi.

Konfigurasi

Saat menggunakan konfigurasi run Cloud Code: Develop on 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

Memulai cluster minikube

Cloud Code otomatis menginstal dan mengelola minikube. Jika Anda memilih untuk tidak menggunakan pengelolaan dependensi, tambahkan biner minikube ke PATH.

  1. Luncurkan Command Palette (tekan Ctrl/Cmd+Shift+P atau klik View > Command Palette), lalu jalankan perintah Cloud Code: Control minikube.
  2. Klik minikube untuk Pilih cluster Minikube (profil) untuk dikontrol, lalu klik Mulai.

Berjalan di minikube

  1. Luncurkan Palet Perintah dan jalankan Cloud Code: Run on Kubernetes.
  2. Klik Yes untuk Use current context (minikube) to run the app?

  3. Cloud Code menjalankan aplikasi Anda di cluster minikube. Jika diminta, beri otorisasi Cloud Shell untuk menggunakan kredensial Anda guna melakukan panggilan Google Cloud API.

    Lihat detail deployment di bagian Development sessions di Cloud Code.

  4. Lihat URL dengan mengklik Portfoward URLs di bagian Development sessions, lalu klik link URL untuk membuka browser dengan aplikasi yang sedang berjalan.

Membuka terminal interaktif ke penampung

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

Menjeda atau menghentikan cluster minikube

  1. Luncurkan Command Palette (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 diisi, 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 penyedia 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 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.