Mulai menggunakan Cloud Code untuk VS Code untuk Kubernetes

Cloud Code memungkinkan Anda 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 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 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 Buat aplikasi baru untuk menyimpan.

   Cloud Code akan 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 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

Dengan 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 (berjenis cloudcode.kubernetes) untuk menjalankan atau men-debug aplikasi Kubernetes
  • tasks.json: informasi konfigurasi untuk Tugas Visual Studio Code
• 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 membuat image container untuk program kami
• skaffold.yaml: file konfigurasi untuk Skaffold, yang digunakan Cloud Code untuk membangun, 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.

Catatan: Untuk mengembangkan dan menguji aplikasi, buat dan jalankan aplikasi di cluster non-produksi.
Untuk perubahan yang akan di-roll out ke produksi, gunakan alur kerja CI/CD otomatis.

Menetapkan konteks Kubernetes Anda

Sebelum menjalankan aplikasi, pastikan Anda telah menyiapkan deployment aplikasi ke konteks Kubernetes pilihan Anda. Anda dapat menentukannya di konfigurasi.

Konfigurasi

Saat menggunakan konfigurasi peluncuran 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 menyetel builder pilihan Anda dan setelannya yang relevan.

Menyesuaikan konfigurasi peluncuran

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

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

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

Catatan: Cloud Code dibuat untuk bekerja dengan Cloud Build. Untuk membangun aplikasi yang ada menggunakan infrastruktur Google Cloud , lihat Dokumen Skaffold untuk Cloud Build.

Jalankan aplikasi Anda

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.

Catatan: Jika Anda menggunakan cluster Autopilot pribadi, Anda mungkin mengalami error penarikan image saat menarik image di luar registry image untuk project Anda, seperti dengan menggunakan Docker Hub. Untuk mengatasi masalah ini, Anda dapat menghosting image di Artifact Registry atau memberikan akses internet keluar untuk node pribadi Anda.

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 konteks yang diinginkan). Untuk mengetahui informasi selengkapnya tentang cara menyiapkan konteks Kubernetes, lihat menyiapkan konfigurasi.

3. Jika Anda memilih cluster jarak jauh sebagai konteks, saat diminta, pilih registry gambar untuk mengirimkan gambar. Jika project Anda telah mengaktifkan Artifact Registry API dan memiliki setidaknya satu repositori Artifact Registry, Anda dapat menjelajahi dan memilih repositori Artifact Registry yang ada.

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

   Artifact Registry	REGION-docker.pkg.dev/PROJECT_ID/REPO_NAME
   Docker Hub	docker.io/ACCOUNT Pastikan Anda diautentikasi dengan benar jika Anda menggunakan repositori Docker Hub pribadi.
   AWS Container Repository (ECR)	AWS_ACCOUNT_ID.dkr.ecr.REGION.amazonaws.com/APP
   Azure Container Registry (ACR)	ACR_NAME.azurecr.io/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 (ditemukan di .vscode/launch.json).

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

Melihat log

Selain melihat log dari pod yang berjalan sebagai live stream di output terminal saat Anda 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 Deployments

2. Klik kanan pod yang lognya ingin Anda lihat, lalu klik View Logs.

   Logs viewer akan terbuka.

Lakukan perubahan, bangun ulang, dan bersihkan

Jika Anda telah menyetel mode tontonan ke false dalam konfigurasi peluncuran dan ingin melakukan perubahan pada aplikasi, lalu membangun kembali dan men-deploy ulang aplikasi:

1. Buat dan Simpan perubahan Anda.

2. Di Toolbar Debug, klik Jeda (F6), lalu klik Mulai Ulang (Ctrl/Cmd + Shift + F5) untuk membangun ulang dan men-deploy ulang aplikasi.

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

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 data tersebut sebagai secret. Dengan Cloud Code, Anda dapat menyimpan rahasia ini dengan aman di Secret Manager dan mengambilnya secara terprogram saat Anda membutuhkannya.

Untuk melihat detail cara membuat dan mengelola secret dengan Cloud Code, 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 berikutnya

• Jelajahi opsi build Anda dengan buildpack, Jib, atau Docker.
• Gunakan sinkronisasi file dan hot reload untuk mempercepat pengembangan.
• Pelajari lebih lanjut bantuan pengeditan YAML Cloud Code.

Dapatkan Dukungan

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