Lewati ke konten utama

Konfigurasi

Panduan Pengaturan Variabel Repository​

Bagian Variables merupakan inti dari integrasi Git Deployment. Selama data pada bagian ini diisi dengan benar, server akan dapat menarik kode dari repository Anda tanpa kendala.

Sebelum melanjutkan, pastikan Anda sudah berada di menu Git Deployment. Fokuskan perhatian pada lima kolom di bagian bawah halaman yang menentukan sumber repository dan lokasi tujuan kode di server.

Menu Konfigurasi

Penjelasan Setiap Kolom​

GIT REPO URL​

Masukkan alamat lengkap repository Git Anda. Pastikan menggunakan protokol HTTPS, bukan SSH.

Contoh format:

  • https://github.com/username/nama-repo.git
  • https://gitlab.com/username/nama-repo.git

GIT BRANCH​

Tentukan nama branch yang akan digunakan sebagai sumber deployment.

  • main / master: Umumnya digunakan untuk lingkungan produksi
  • development: Cocok untuk pengujian atau staging
  • Default: Gunakan main jika tidak memiliki kebutuhan khusus

GIT USERNAME​

Masukkan username akun GitHub atau GitLab Anda. Data ini digunakan untuk proses otentikasi saat server melakukan penarikan kode dari repository.

GIT TOKEN​

Kolom paling krusial dalam konfigurasi ini. Isikan Personal Access Token (PAT) yang dibuat dari akun GitHub atau GitLab Anda.

Catatan Keamanan: Raznar tidak menggunakan password akun Git secara langsung. Token digunakan sebagai pengganti yang lebih aman. Pastikan token memiliki izin minimum:

  • GitHub: repo
  • GitLab: read_repository

Lengkapnya ada disini:

GIT DEST DIR (Destination Directory)​

Menentukan lokasi penyimpanan kode di dalam server. Anda dapat menggunakan beberapa format path berikut:

  • . atau ./ Gunakan jika Anda ingin kode ditempatkan langsung di direktori utama (root working directory) server.

  • / Memiliki efek yang sama dengan . — kode akan dideploy ke direktori utama container.

  • /home/container Path absolut ke direktori kerja utama server. Direkomendasikan jika Anda ingin lebih eksplisit dan menghindari ambiguitas.

  • Nama folder Masukkan nama folder relatif (misalnya public, app, atau backend) jika ingin menyimpan kode di subdirektori tertentu.

Catatan: Semua path di atas akan diproses relatif terhadap direktori kerja server. Pastikan path yang Anda tentukan memiliki izin tulis (write permission).

Langkah Verifikasi​

Setelah semua variabel terisi dengan benar:

  1. Klik tombol Save (jika tersedia) untuk menyimpan konfigurasi.
  2. Klik tombol DEPLOY untuk menjalankan penarikan kode pertama secara manual.
  3. Jika konfigurasi valid, proses akan berhasil dan file repository Anda akan langsung terlihat di File Manager.