Memulai Cloud Code untuk VS Code untuk Kubernetes

Dengan Cloud Code, Anda dapat membuat aplikasi Kubernetes berdasarkan sampel 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 sampel 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 Aplikasi Kubernetes untuk jenis sampelnya.
  3. Pilih contoh 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 meng-clone sampel yang Anda pilih dan membuka project baru untuk digunakan.

Contoh struktur aplikasi

Semua aplikasi contoh bahasa memiliki struktur yang hampir sama. Struktur ini bukan satu-satunya struktur yang didukung, tetapi direkomendasikan saat memulai.

Misalnya, struktur aplikasi Buku Tamu Node.js terlihat seperti berikut:

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

Dengan melihat lebih dekat aplikasi contoh Node.js Buku Tamu Kubernetes ini, berikut ini 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 Tugas Kode Visual Studio
  • kubernetes-manifest
    • 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 membuat image container untuk program kita
  • skaffold.yaml: file konfigurasi untuk Skaffold, yang digunakan Cloud Code untuk membangun, men-deploy, dan men-debug aplikasi Kubernetes

Gunakan aplikasi Anda sendiri

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

Menetapkan konteks Kubernetes

Sebelum menjalankan aplikasi, pastikan Anda sudah siap untuk men-deploy aplikasi ke konteks Kubernetes pilihan Anda. Anda dapat menetapkannya 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 Buildpacks. 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 di file .vscode/launch.json Anda.

Untuk mengetahui informasi selengkapnya tentang 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 Palet Perintah (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 yang lebih disukai). Untuk mengetahui informasi selengkapnya tentang cara menyiapkan konteks Kubernetes, lihat menyiapkan konfigurasi.
  3. Jika memilih cluster jarak jauh sebagai konteks, saat diminta, pilih registry gambar untuk mengirim gambar. Jika menggunakan Container Registry, Anda dapat menjelajahi registry yang ada atau menentukan nama registry yang akan dibuat. Jika project Anda memiliki Artifact Registry API yang diaktifkan dan setidaknya satu repositori Artifact Registry, Anda dapat menjelajahi dan memilih repositori Artifact Registry yang ada.

    Contoh berikut menunjukkan cara menentukan lokasi penyimpanan image container 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 membuat nama repositori image akhir.

    Untuk mengetahui informasi selengkapnya, lihat panduan penanganan registry gambar.

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

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

Lihat log

Selain melihat log dari menjalankan pod sebagai live stream di output terminal saat mengembangkan dan menjalankan aplikasi, Anda juga 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 lognya ingin Anda lihat, lalu klik View Logs.

    Penampil log akan terbuka.

Buat perubahan, bangun ulang, dan bersihkan

Jika Anda telah menyetel mode smartwatch 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.

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

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

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

Menyimpan rahasia

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

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

Lihat detail resource

Bagian Kubernetes menampilkan cluster, namespace, node, beban kerja (seperti deployment, replikaset, pod dan container), layanan dan ingress, konfigurasi (seperti secret dan peta konfigurasi), serta penyimpanan (seperti volume). Melalui 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.