Mulai menggunakan Cloud Code untuk VS Code untuk Kubernetes

Cloud Code memungkinkan Anda membuat aplikasi Kubernetes berdasarkan contoh atau dari project yang ada.

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.

Setelan build

Cloud Code mendukung jenis artefak Docker, Jib, dan Buildpack. Lihat Panduan mengonfigurasi preferensi build image container untuk mempelajari cara menetapkan builder pilihan Anda dan setelan yang relevan.

Menyesuaikan konfigurasi peluncuran

Untuk mengonfigurasi cara aplikasi dijalankan, Anda dapat menyesuaikan file skaffold.yaml.

Anda juga dapat mengonfigurasi peluncuran dengan mengedit konfigurasi cloudcode.kubernetes dalam file .vscode/launch.json.

Untuk mengetahui informasi selengkapnya tentang cara menyesuaikan konfigurasi peluncuran, lihat Kubernetes di Cloud Code.

Menjalankan aplikasi

Setelah menyiapkan aplikasi, Anda dapat menjalankannya di cluster Kubernetes dan melihatnya secara langsung, dengan memanfaatkan skaffold dev. Anda dapat menjalankan aplikasi di cluster lokal (seperti minikube atau Docker Desktop), Google Kubernetes Engine, atau penyedia Cloud lainnya.

  1. Buka Command Palette (tekan Ctrl/Cmd+Shift+P), lalu jalankan perintah Cloud Code: Run on Kubernetes.
  2. Konfirmasi apakah akan menggunakan konteks Kubernetes saat ini untuk menjalankan aplikasi (atau beralih ke konteks yang diinginkan). Untuk informasi selengkapnya tentang menyiapkan konteks Kubernetes, lihat menyiapkan konfigurasi.

  3. Jika Anda memilih cluster jarak jauh sebagai konteks, saat diminta, pilih registry gambar tempat gambar akan di-push. Jika menggunakan Container Registry, Anda dapat membuka registry yang ada atau menentukan nama registry yang akan dibuat. Jika project Anda telah mengaktifkan Artifact Registry API dan setidaknya satu repositori Artifact Registry, Anda dapat menjelajahi dan memilih repositori Artifact Registry yang ada.

    Contoh berikut menunjukkan cara menentukan tempat image container disimpan untuk beberapa registry umum:

    Artifact Registry {region}-docker.pkg.dev/{project_id}/{repo-name}
    Container Registry gcr.io/{project_id}
    Docker Hub docker.io/{account}
    Pastikan Anda diautentikasi dengan benar jika menggunakan repositori Docker Hub pribadi.
    AWS Container Repository (ECR) {aws_account_id}.dkr.ecr.{region}.amazonaws.com/{my-app}
    Azure Container Registry (ACR) {my_acr_name}.azurecr.io/{my-app}

    Cloud Code menggabungkan registry image ini dengan nama image yang ditentukan dalam manifes Kubernetes untuk menghasilkan nama repositori image akhir.

    Untuk mengetahui informasi selengkapnya, lihat panduan penanganan registry image.

    Pilihan ini disimpan di konfigurasi peluncuran cloudcode.kubernetes Anda (ditemukan di .vscode/launch.json).

    Cloud Code mem-build container Anda, mengirimkannya ke registry, menerapkan konfigurasi Kubernetes ke cluster, dan menunggu peluncuran.

Lihat log

Selain melihat log dari pod yang berjalan sebagai live stream di output terminal saat mengembangkan dan menjalankan aplikasi, Anda dapat melihat log dari pod tertentu dengan membuka bagian Kubernetes.

Untuk melihat log dari pod tertentu, ikuti langkah-langkah berikut:

  1. Di bagian Kubernetes, luaskan Deployment

  2. Klik kanan pod yang log-nya ingin Anda lihat, lalu klik Lihat Log.

    Logs viewer akan terbuka.

Melakukan perubahan, mem-build ulang, dan membersihkan

Jika Anda telah menetapkan mode watch ke false dalam konfigurasi peluncuran dan ingin melakukan perubahan pada aplikasi, lalu mem-build ulang dan men-deploy ulang aplikasi:

  1. Buat dan Simpan perubahan Anda.

  2. Di Toolbar Debug, klik Pause (F6), lalu klik Restart (Ctrl/Cmd + Shift + F5) untuk mem-build ulang dan men-deploy ulang aplikasi.

  3. Untuk berhenti menjalankan aplikasi, di Toolbar Debug, klik Stop.

Setelah Anda menghentikan aplikasi, semua resource Kubernetes yang di-deploy akan dihapus dari cluster. Anda dapat mengubah perilaku ini menggunakan tanda cleanUp dalam konfigurasi peluncuran.

Menyimpan secret

Jika kode Anda menyertakan data yang berpotensi sensitif seperti kunci API, sandi, dan sertifikat, sebaiknya simpan sebagai secret. Dengan Cloud Code, Anda dapat menyimpan rahasia ini dengan aman di Secret Manager dan mengambilnya secara terprogram saat Anda membutuhkannya.

Untuk melihat cara membuat dan mengelola secret dengan Cloud Code secara mendetail, lihat panduan Secret Manager.

Lihat detail resource

Bagian Kubernetes menampilkan cluster, namespace, node, workload (seperti deployment, replicaset, pod, dan container), layanan dan ingress, konfigurasi (seperti secret dan config map), serta penyimpanan (seperti volume). Dengan menggunakan bagian Kubernetes, Anda dapat melakukan tindakan unik pada beberapa resource ini.

Lihat ringkasan Kubernetes untuk mengetahui informasi selengkapnya tentang cara melihat detail resource.

Langkah selanjutnya

Dapatkan Dukungan

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