Memulai Cloud Code for IntelliJ 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. 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 guna menyinkronkan pom.xml. Klik Add as Maven project. Selain itu, impor project Maven yang diperlukan dengan mengklik Import Changes.

5. Target pengoperasian dan IDE yang dijalankan Kubernetes 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 "Tanpa nama").
   5. Klik OK untuk membuat target lari.
   Catatan: Jika Anda login ke Google Cloud di IDE dan telah menetapkan project default, Cloud Code akan menggunakan repositori image container default Anda. Untuk menentukan image container yang berbeda, ikuti Mengonfigurasi setelan image container.

Gunakan aplikasi Anda sendiri

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

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

Menetapkan konteks Kubernetes

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

Jika ingin mengalihkan 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 mengambil perubahan file dari jenis tertentu dengan cepat tanpa harus melakukan build ulang gambar, 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 gambar untuk mengirim gambar. Buka Run > Edit configurations untuk menetapkan registry image di Run/Debug Configurations.

Lihat panduan cara menyimpan image container untuk detail selengkapnya.

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

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

Catatan: Cloud Code dibuat agar dapat digunakan 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 bekerja dengan cluster Autopilot pribadi, Anda mungkin mengalami error penarikan gambar saat mengambil image di luar registry image untuk project Anda, misalnya 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 yang diinginkan. Selanjutnya, Anda dapat melihat log aplikasi yang masuk di jendela output di bagian tab Log.

   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 URL Layanan 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 saja yang Anda deploy selama sesi pengembangan.

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

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

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

2. Pilih pod yang lognya ingin Anda lihat.

3. Klik kanan pod, lalu klik Stream Logs. Atau, Anda dapat melakukan streaming log untuk setiap container yang berjalan di pod.

   Kubernetes Explorer Console akan menampilkan log.

Buat perubahan, bangun ulang, dan bersihkan

Jika mode smartwatch disetel ke On demand dalam konfigurasi peluncuran dan Anda ingin membuat perubahan pada aplikasi, lalu mem-build ulang dan men-deploy ulang aplikasi:

1. Buat dan simpan perubahan.

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

Kubernetes Explorer 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). Dengan 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 di Cloud Code.

Dapatkan dukungan

Untuk mengirimkan masukan atau melaporkan masalah di IntelliJ IDE, buka Alat > Cloud Code > Bantuan / Tentang > Kirim masukan atau laporkan masalah untuk melaporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.