Bekerja dengan file YAML Google Cloud dan Kubernetes di Cloud Code for IntelliJ

Cloud Code dirancang untuk membantu mengedit file konfigurasi terkait Google Cloud dan Kubernetes, termasuk validasi berbasis skema, diagnostik, dan dokumentasi cepat.

Catatan: Karena alasan kompatibilitas, fitur pengeditan Kubernetes akan otomatis dinonaktifkan jika plugin Kubernetes JetBrains terdeteksi. Ganti setelan ini secara manual di menu setelan Cloud Code dengan membuka Cloud Code > Kubernetes > Kubernetes editing features, lalu aktifkan setelan Enable Kubernetes YAML configuration editing features. Langkah kompatibilitas ini hanya memengaruhi file YAML Kubernetes. Dukungan untuk jenis file konfigurasi YAML lainnya seperti Skaffold tidak terpengaruh.

Catatan: Dukungan pengeditan YAML Cloud Build hanya tersedia untuk file bernama cloudbuild.yaml

File konfigurasi YAML yang didukung

• Anthos Config Management
• Cloud Build
• Config Connector
• Knative
• Kubernetes
• Kustomize
• Migrate to Containers
• Skaffold

Cloud Code juga mendukung CRD Kubernetes populer, seperti Kubeflow, secara langsung.

Catatan: Untuk menggunakan agregasi resource terbaru, Anda memerlukan Cloud Code versi terbaru.

Mengaktifkan atau menonaktifkan dukungan YAML

Untuk mengaktifkan atau menonaktifkan dukungan YAML, buka File > Settings > Tools > Gemini + Google Cloud Code > Kubernetes (untuk Windows dan Linux) atau IntelliJ IDEA > Settings > Tools > Gemini + Google Cloud Code > Kubernetes (untuk macOS), lalu centang atau hapus centang pada kotak Enable YAML support untuk mengaktifkan atau menonaktifkan fitur.

Menggunakan skema kustom

Dengan Cloud Code, Anda dapat memberikan skema CRD Anda sendiri dengan setelan IntelliJ dengan membuka File > Settings > Tools > Gemini + Google Cloud Code > Kubernetes (Untuk Windows dan Linux) atau IntelliJ IDEA > Settings > Tools > Gemini + Google Cloud Code > Kubernetes (untuk macOS), lalu lihat bagian Lokasi skema CRD.

Anda dapat mengarahkan ke file lokal atau URL. URL yang mengarah ke github.com akan otomatis dikonversi menjadi raw.githubusercontent.com.

Menarik skema dari cluster

Saat Anda beralih ke cluster yang menjalankan Kubernetes v1.16+ di Kubernetes Explorer, Cloud Code akan otomatis mengambil skema semua CRD yang diinstal.

Dukungan Skaffold tambahan

Skaffold adalah mesin dasar yang mendukung Cloud Code, membantu Anda mem-build, mendorong, dan men-deploy aplikasi, serta memberikan dukungan untuk membuat pipeline CI/CD.

Cloud Code dilengkapi dengan dukungan tambahan untuk mengelola file konfigurasi Skaffold. Saat Anda membuka project, Cloud Code akan mendeteksi skema Skaffold yang tidak terbaru dan meminta Anda (melalui Log Peristiwa) saat upgrade versi skema Skaffold tersedia untuk file konfigurasi YAML Skaffold yang ada.

Atau, Anda dapat membuka Tools > Gemini + Cloud Code > Kubernetes > Check for Skaffold Schemas Upgrades untuk memeriksa upgrade skema yang tersedia.

Mengonfigurasi dengan cuplikan

Cuplikan siap pakai untuk skema YAML umum (menggunakan Ctrl+Spasi untuk melihat opsi) memungkinkan Anda memulai file YAML baru atau menambahkan ke file yang ada tanpa error, sambil tetap mengikuti praktik terbaik. Selain itu, lebih mudah untuk menggunakan kolom berulang; isi satu kolom dan Cloud Code akan mengisi instance yang tersisa.

Cloud Code menawarkan cuplikan berikut:

• Cloud Build - Cloud Run deployment
• Cloud Build - Docker container build
• Cloud Build - GKE deployment
• Cloud Build - GKE Skaffold deployment
• Cloud Build - Go build
• Cloud Build - Terraform plan + apply
• Config Connector - BigQueryDataset
• Config Connector - BigQueryTable
• Config Connector - BigtableCluster
• Config Connector - BigtableInstance
• Config Connector - PubSubSubscription
• Config Connector - PubSubTopic
• Config Connector - RedisInstance
• Config Connector - SpannerInstance
• Kubernetes - ConfigMap
• Kubernetes - Deployment
• Kubernetes - Ingress
• Kubernetes - Pod
• Kubernetes - Service
• Migrate to Containers - Export
• Migrate to Containers - PersistentVolumeClaim
• Migrate to Containers - StatefulSet
• Skaffold - Bazel
• Skaffold - Getting-started
• Skaffold - Helm deployment
• Skaffold - Kaniko

Menyelesaikan dengan konteks

Berdasarkan skema saat ini, Cloud Code menyediakan penyelesaian kontekstual untuk membantu Anda memilih opsi yang tepat.

Memvalidasi skema YAML

Cloud Code menawarkan dukungan validasi skema dengan menandai tag dan nilai yang tidak valid dalam file YAML Anda dan menyarankan perbaikan jika memungkinkan.

Memvalidasi file YAML Skaffold

Cloud Code menyediakan dukungan pengeditan file konfigurasi Skaffold tambahan dan template cerdas yang memungkinkan Anda memvalidasi file skaffold.yaml. Lihat panduan tentang cara menggunakan aplikasi yang ada dengan Cloud Code ini.

Menyelesaikan file konfigurasi Skaffold dengan konteks

Berdasarkan skema saat ini, Cloud Code menyediakan penyelesaian kontekstual dan dokumentasi yang relevan untuk membantu Anda memilih opsi yang tepat.

Menemukan definisi menggunakan dokumentasi cepat

Cloud Code menampilkan dokumentasi yang relevan untuk resource saat Anda menandai baris dalam file konfigurasi dan membuka View > Quick Documentation.

Lint YAML untuk masalah struktural dan validitas

Cloud Code memberikan dukungan linting seputar masalah skema umum dan memberikan error deskriptif.

Menerapkan file YAML

Untuk menjalankan kubectl apply -f guna menerapkan perubahan konfigurasi menggunakan file saat ini, Anda dapat menggunakan ikon tindakan kubectl , yang tersedia di gutter IDE, dan memilih Terapkan. Tindakan ini akan menampilkan tampilan diff untuk meninjau perubahan sebelum mengklik Terapkan.

Perbedaan antara file YAML

Untuk melihat perbedaan antara file YAML dalam kontrol sumber dan file YAML yang di-deploy, Anda dapat menggunakan ikon tindakan kubectl yang tersedia di gutter editor. Pilih opsi Diff untuk melihat tampilan diff bagi Anda untuk membandingkan dan membedakan dua file skema.

Melakukan uji coba file YAML

Untuk melakukan dry run file dan memeriksa validitasnya, Anda dapat menggunakan ikon tindakan kubectl , yang tersedia di gutter IDE, untuk memilih Dry-run on Server atau Dry-run on Client. Tindakan ini akan menjalankan kubectl apply -f dry-run=server (atau kubectl apply -f dry-run=client, untuk opsi Klien) dan memberi tahu Anda jika file berhasil dibuat di jendela Terminal.

Langkah selanjutnya

• Buat file skaffold.yaml Konfigurasi run Kubernetes Cloud Code.
• Buat konfigurasi Skaffold secara manual untuk aplikasi Anda.
• Lihat dokumen referensi Skaffold.yaml.

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.