Jika Anda memiliki project yang sudah dikonfigurasi dengan manifes Kubernetes, Dockerfile, atau Jib untuk mem-build image, Anda dapat membuka dan menggunakannya dengan plugin. Satu-satunya konfigurasi tambahan yang diperlukan adalah file YAML Skaffold yang dapat dihasilkan secara otomatis untuk Anda atau dibuat menggunakan template yang disediakan.
Setelah selesai mengonfigurasi YAML Skaffold, pastikan untuk menentukan tempat penyimpanan image container tempat image project akan di-push.
Bootstrap project otomatis
Project Anda harus memiliki satu atau beberapa manifes Kubernetes. Jika Cloud Code mendeteksi manifes Kubernetes apa pun dalam project, Cloud Code akan mencoba melakukan bootstrap.
Jika Cloud Code tidak mendeteksi konfigurasi Skaffold yang ada, Anda akan diminta untuk membantu menyiapkannya.
Prasyarat
Project Anda harus memenuhi prasyarat berikut agar diminta untuk membuat file skaffold.yaml
dan menjalankan konfigurasi yang diperlukan:
(Opsi 1) Project Anda memiliki Dockerfile dan dikonfigurasi untuk Jib, atau
(Opsi 2) Project Anda dapat di-build menggunakan Buildpack dan memiliki resource Kubernetes.
Menyiapkan konfigurasi run Kubernetes
Jika prasyarat terpenuhi, Cloud Code akan
memberi tahu Anda dengan notifikasi untuk membuat file skaffold.yaml
(jika belum ada) dan konfigurasi run yang diperlukan:
Klik notifikasi. Tindakan ini akan otomatis membuat konfigurasi Anda jika memungkinkan.
Jika pembuatan konfigurasi Skaffold otomatis tidak dapat dilakukan karena beberapa gambar atau builder terdeteksi, Cloud Code akan menampilkan dialog yang meminta Anda untuk memberikan pemetaan antara gambar dan builder yang terdeteksi.
Atau, Anda juga dapat menyiapkan konfigurasi Skaffold dengan membuka Tools > Cloud Code > Kubernetes dan memilih Add Kubernetes Support.
Opsi ini menganalisis resource Kubernetes project Anda dan membuat file
skaffold.yaml
(jika belum ada) serta konfigurasi run yang diperlukan. Dua konfigurasi run yang dihasilkan mencakup satu untuk menjalankan project Anda di Kubernetes dan satu untuk pengembangan di cluster Kubernetes.Setelah dukungan ditambahkan, Anda dapat mulai menjalankan dan men-debug project di Kubernetes menggunakan konfigurasi run yang baru ditambahkan.
Membuat konfigurasi Skaffold Cloud Code secara manual
Anda dapat memilih untuk membuat file skaffold.yaml
baru secara manual atau menambahkan file yang sudah ada ke project Anda.
Untuk membuat file skaffold.yaml
secara manual menggunakan template live, ikuti langkah-langkah berikut:
Buat file baru bernama
skaffold.yaml
di direktori utama project Anda (klik kanan > New > File).Dengan kursor di file baru, tekan
Ctrl+Space
untuk menampilkan saran template live, lalu pilih template Skaffold yang diinginkan.Isi kolom image dengan nama image project dan kolom manifes dengan daftar resource Kubernetes yang ingin Anda deploy dari IDE.
Setelah Cloud Code menentukan bahwa file
skaffold.yaml
Anda valid, klik perintah untuk membuat konfigurasi run Kubernetes.
Contoh konfigurasi Skaffold Cloud Code
Build berbasis Dockerfile:
build: artifacts: - image: image_name deploy: kubectl: manifests: - k8s/web.yaml - k8s/backend.yaml
Bagian build untuk project Java Maven/Gradle dengan plugin Jib (bagian deployment tetap sama seperti contoh di atas):
build: artifacts: - image: image_name jib: {}
Jika ingin menentukan konfigurasi build, pengujian, dan deployment untuk konteks yang berbeda, Anda dapat memiliki profil yang berbeda. Berikut adalah contoh profil Cloud Build untuk mengonfigurasi Cloud Code guna mem-build image dengan Cloud Build:
profiles: # use the cloudbuild profile to build images using Google Cloud Build - name: cloudbuild build: googleCloudBuild: {}
Jika Anda ingin men-deploy project dengan Helm, lihat dokumentasi Helm.
Menentukan tempat penyimpanan image container
Penyimpanan image container
Sebelum men-deploy aplikasi, Anda harus menentukan repositori image default untuk digunakan dengan project.
Secara default, project dikonfigurasi untuk menggunakan nama image yang ditentukan dalam manifes Kubernetes Anda. Anda juga dapat menyesuaikan spesifikasi gambar ini. Setelah menyiapkan repositori pilihan Anda (Artifact Registry, Container Registry, DockerHub, repositori pribadi, dll.), edit konfigurasi run dan tentukan sebagai repositori image default di setelan konfigurasi run. Untuk image Google Container Registry, kolom ini dilengkapi dengan pelengkapan otomatis untuk membantu Anda menemukan repositori Container Registry lebih cepat.
Repositori ini dapat diakses dari dialog konfigurasi Run/Debug di taskbar atas pada bagian Edit Configurations > Develop on Kubernetes > Image repository.
Untuk mengetahui informasi selengkapnya tentang cara menentukan preferensi image container, lihat Panduan mengonfigurasi setelan image container.
Setelan build
Setelah menetapkan image container, Anda dapat mengonfigurasi setelan build-nya. Cloud Code mendukung jenis artefak Docker, Jib, dan Buildpack.
Di tab Build / Deploy pada setelan konfigurasi Run (Edit Configurations > Develop on Kubernetes), Anda dapat mengonfigurasi setelan build untuk profil default.
Untuk mengetahui informasi selengkapnya tentang cara menentukan setelan build untuk image Anda, lihat Panduan mengonfigurasi preferensi build image container.
Langkah selanjutnya
- Gunakan sinkronisasi file dan hot reload untuk mempercepat pengembangan.
- Men-debug aplikasi di Cloud Code.