Mulai menggunakan Cloud Code for IntelliJ 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. Buka File > New Project.
2. Pilih Cloud Code: Kubernetes.
3. Pilih template dari daftar aplikasi awal.

4. Pilih nama untuk project Anda.

   Setelah Anda mengklik Finish, Cloud Code akan meng-clone template yang dipilih dan membuka project yang baru dibuat untuk digunakan.

   Untuk template Java, Anda akan diminta untuk mengimpor project Maven untuk menyinkronkan pom.xml. Klik Tambahkan sebagai project Maven. Selain itu, impor project Maven yang diperlukan dengan mengklik Import Changes.

5. Target run Kubernetes dan IDE pengembangan untuk project akan otomatis dibuat dan siap dijalankan.

   Opsional: Atau, Anda dapat membuat target run secara manual:

   1. Pilih drop-down Run Configuration, lalu klik Edit Configurations.
   2. Klik + Add New Configuration untuk menambahkan konfigurasi run baru.
   3. Buka Cloud Code: Kubernetes
   4. Masukkan nama untuk konfigurasi baru Anda (defaultnya adalah "Unnamed").
   5. Klik OK untuk membuat target operasi.
   Catatan: Jika Anda login ke Google Cloud di IDE dan memiliki project default yang ditentukan, Cloud Code akan menggunakan repositori image container default Anda. Untuk menentukan image container yang berbeda, ikuti Mengonfigurasi setelan image container.

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 diluncurkan ke produksi, gunakan alur kerja CI/CD otomatis.

Menetapkan konteks Kubernetes

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

Jika ingin mengubah konteks saat ini, Anda dapat melakukannya dengan Kubernetes Explorer, yang dapat diakses dari panel sidebar di sebelah kanan atau menggunakan Tools > Cloud Code > Kubernetes > View Cluster Explorer.

Untuk mengoptimalkan loop pengembangan dengan cepat mengambil perubahan file dari jenis tertentu tanpa harus melakukan build ulang image, Anda dapat mengaktifkan sinkronisasi file dan hot reload.

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

Opsi penyimpanan image container

Jika Anda memilih cluster jarak jauh sebagai konteks, pilih registry image tempat gambar akan di-push. Buka Run > Edit configurations untuk menetapkan registry image di Run/Debug Configurations.

Lihat panduan menyimpan image container untuk mengetahui detail selengkapnya.

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 di Konfigurasi Run/Debug. Untuk mengedit konfigurasi, buka Run > Edit configurations.

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

Catatan: Cloud Code dibuat agar berfungsi dengan Cloud Build. Untuk mem-build aplikasi yang ada menggunakan infrastruktur Google Cloud, lihat dokumen Skaffold untuk Cloud Build.

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.

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

1. Klik ikon Run pada tindakan run pilihan Anda. Kemudian, Anda dapat melihat log aplikasi yang masuk di jendela output pada tab Logs.

   Saat deployment dimulai, Anda akan melihat daftar port yang diteruskan untuk aplikasi yang di-deploy.

2. Setelah deployment berhasil, Anda akan diberi tahu bahwa URL layanan baru tersedia. Klik tab Service URLs untuk melihat URL, lalu klik link URL untuk membuka browser dengan aplikasi yang sedang berjalan.

   Atau, Anda dapat membuka Log Peristiwa, lalu mengklik link untuk membuka browser dengan aplikasi yang sedang berjalan.

   Panel Deployed Resources menampilkan apa yang Anda deploy selama sesi pengembangan.

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

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

1. Buka Kubernetes Explorer. View Cluster Explorer dapat diakses dari panel samping di sebelah kanan atau menggunakan Tools > Cloud Code > Kubernetes > View Cluster Explorer.

2. Pilih pod yang log-nya ingin Anda lihat.

3. Klik kanan pod, lalu klik Stream Logs. Atau, Anda dapat menstreaming log untuk setiap penampung yang berjalan di pod.

   Konsol Kubernetes Explorer menampilkan log.

Melakukan perubahan, mem-build ulang, dan membersihkan

Jika mode watch ditetapkan ke On demand dalam konfigurasi peluncuran dan Anda ingin melakukan perubahan pada aplikasi, lalu mem-build ulang dan men-deploy ulang aplikasi:

1. Buat dan simpan perubahan Anda.

2. Klik ikon Trigger Build and Deploy atau tekan Option + Ctrl/Cmd + Comma untuk mem-build ulang dan men-deploy ulang aplikasi.

3. Untuk berhenti menjalankan aplikasi, klik ikon Stop atau tekan Ctrl/Cmd + F2.

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

Kubernetes Explorer 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 Kubernetes Explorer, Anda dapat melakukan tindakan unik pada beberapa resource ini.

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

Langkah selanjutnya

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

Mendapatkan dukungan

Untuk mengirimkan masukan atau melaporkan masalah di IDE IntelliJ, buka Tools > Cloud Code > Help / About > Submit feedback or report an issue untuk melaporkan masalah di GitHub.