Lewati ke konten utama

Validate Troubleshooting

Validate Troubleshooting

Panduan Bantuan

Selesaikan validation failure yang umum sebelum menjalankan workflow Custy.

Commandcusty validate

Category

Validate

Quick Command

custy validate
troubleshootingvalidationerrors

Ringkasan​

Sebagian besar validation failure terjadi karena satu atau beberapa project prerequisites belum terpenuhi. Masalah yang dilaporkan biasanya menyertakan hint yang menjelaskan cara menyelesaikannya.

Git Repository Tidak Ditemukan​

Yang Anda lihat

Validation langsung berhenti dan melaporkan bahwa current directory bukan Git repository.

Penyebab

Git belum diinisialisasi pada proyek.

Cara menyelesaikan

Inisialisasi repository:

git init

Setelah itu, jalankan kembali command validate.

Configured Remote Tidak Ditemukan​

Yang Anda lihat

Custy melaporkan bahwa Git remote yang dikonfigurasi tidak ditemukan.

Penyebab

Nama remote yang dikonfigurasi tidak tersedia di repository.

Cara menyelesaikan

Periksa configured remote:

git remote -v

Tambahkan remote yang belum tersedia jika diperlukan:

git remote add origin <repository-url>

Sebagai alternatif, perbarui nama remote dalam .config/custy/config.toml.

Version File Tidak Tersedia​

Yang Anda lihat

Validation melaporkan version file yang dikonfigurasi tidak tersedia.

Penyebab

Version file belum dibuat atau configured path tidak benar.

Cara menyelesaikan

Tinjau configured version file path. Jika proyek belum di-init, jalankan:

custy init

atau:

custy init --mode config

sesuai setup proyek.

Commit Message Template Tidak Tersedia​

Yang Anda lihat

Commit message template yang diperlukan tidak ditemukan.

Penyebab

Template resources belum dibuat.

Cara menyelesaikan

custy init --mode templates

Kemudian jalankan kembali command validate.

Tag Message Template Tidak Tersedia​

Yang Anda lihat

Tag message template yang dikonfigurasi tidak tersedia.

Penyebab

Template initialization belum diselesaikan.

Cara menyelesaikan

custy init --mode templates

atau buat ulang project resources dengan:

custy init

Tidak Ada Staged Changes​

Yang Anda lihat

Validation melaporkan tidak ada staged files.

Penyebab

Project files belum di-stage.

Cara menyelesaikan

git add .

atau:

git add <file>

Setelah melakukan stage, jalankan validation kembali.

Commit Convention Validation Gagal​

Yang Anda lihat

Commitizen configuration, availability, atau final message validation gagal.

Penyebab

Selected provider bersifat strict tetapi configuration atau cz tidak ada, configuration malformed, atau final message melanggar project rules.

Cara menyelesaikan

Baca structured error label, lalu instal custy[commitizen], perbaiki detected configuration, perbarui message, atau pilih provider = "custy". Version strategy dan message provider terpisah. Lihat behavior matrix.

Langkah Diagnosis Berikutnya​

Jika validation tetap gagal:

  • Pastikan Anda berada di project directory yang benar.
  • Tinjau configuration .config/custy/config.toml.
  • Pastikan project resources yang diperlukan tersedia.
  • Jalankan command kembali setelah memperbaiki masalah yang dilaporkan.

Sebagian besar masalah selesai dengan memperbaiki error pertama karena Custy menggunakan fail-fast validation strategy.