Lewati ke konten utama

Overview

Init Proyek

Direkomendasikan

Siapkan proyek yang sudah ada untuk digunakan bersama Custy dengan membuat konfigurasi, template, dan resource pendukung khusus proyek.

Commandcusty init

Category

Init

Quick Command

custy init

configurationtemplatesproject setup

Ringkasan​

Command custy init menyiapkan proyek yang sudah ada agar dapat digunakan bersama Custy.

Command ini tidak mengubah riwayat Git proyek atau menjalankan release workflow. Sebagai gantinya, command ini membuat workspace proyek yang dapat dikonfigurasi di bawah .config/custy/. File yang dibuat memungkinkan Anda menyesuaikan perilaku Custy tanpa mengubah aplikasi itu sendiri.

Menjalankan custy init adalah langkah pertama yang direkomendasikan saat mulai menggunakan Custy pada repositori baru maupun yang sudah ada.


Yang Dilakukan Command Ini

Yang Dilakukan Command Ini

Membuat Configuration

Membuat file configuration utama proyek di.config/custy/config.toml.

Membuat Templates

Membuat template default untuk commit, tag, dan changelog yang dapat disesuaikan dengan workflow tim Anda.

Menyiapkan Proyek

Membuat struktur direktori yang diperlukan Custy.

Examples Opsional

Membuat resource contoh untuk memperlihatkan template yang didukung.

Kapan Command Ini Digunakan?

Anda biasanya perlu menjalankan custy init ketika:

  • Menyiapkan Custy di sebuah proyek untuk pertama kali.
  • Menambahkan Custy ke repositori Git yang sudah ada.
  • Membuat configuration khusus proyek.
  • Membuat ulang template default setelah upgrade Custy.
  • Menyiapkan repositori untuk digunakan oleh seluruh tim.

Pada sebagian besar proyek, custy init dijalankan sekali saat setup awal. Setelah itu, configuration yang dibuat cukup diperbarui seiring perkembangan proyek.


Yang Tidak Dilakukan Command Ini

Berbeda dengan workflow commands, custy init tidak:

  • Membuat commit.
  • Membuat Git tag.
  • Melakukan push ke remote repository.
  • Membuat release.
  • Mengubah riwayat Git.
  • Menjalankan release pipeline.

Tanggung jawabnya hanya menyiapkan proyek untuk workflow Custy berikutnya.


Workspace Proyek

Setelah init selesai, proyek Anda memiliki workspace Custy khusus.

Terminal
bash
your-project/
└── .config/
  └── custy/
      ├── config.toml
      └── templates/
          ├── backups/
          ├── changelog/
          ├── examples/
          ├── commit-message.txt
          └── tag-message.txt

Workspace ini memisahkan configuration khusus proyek dari default internal Custy, sehingga perilaku dapat disesuaikan tanpa mengubah aplikasi.


Mengapa Perlu Menjalankan Init?

Custy sudah dilengkapi perilaku default yang masuk akal.

Artinya, init direkomendasikan, tetapi tidak mutlak diwajibkan.

Tanpa menjalankan custy init, Custy menggunakan default bawaannya.

Menjalankan custy init memberi fleksibilitas tambahan karena proyek dapat menentukan sendiri:

  • configuration
  • templates
  • preferences
  • struktur direktori

Pendekatan ini menyeimbangkan kemudahan dan kemampuan customization.



Langkah Berikutnya

Setelah proyek selesai di-init, langkah berikutnya bergantung pada workflow Anda.

Sebagai contoh:

  • Validate configuration proyek.
  • Mulai gunakan command Custy secara individual.
  • Jalankan workflow yang telah ditentukan.
  • Sesuaikan configuration dan template yang dibuat.