README.MD

@@ -0,0 +1,119 @@
+# BTN Middleware Server Local
+
+Projek ini adalah Environment Docker untuk menjalankan stack middleware BTN secara lokal (GitLab, Jenkins, database DB2 (mwconfig & mwlog), dan IBM ACE).
+
+## Requirements
+
+- Jalankan di linux/wsl2
+- Docker & Docker Compose terinstal
+
+---
+
+## Setup Project
+
+### 1. (Opsional) Fork project
+
+Fork repository ini ke akun gitlab masing-masing jika ingin menyimpan perubahan konfigurasi sendiri.
+
+### 2. Clone project
+
+```bash
+git clone https://code.senomas.com/wisnu/btnmw-server-local
+cd btnmw-server-local
+```
+
+### 3. Login ke Docker registry Senomas
+
+Gunakan kredensial yang telah diberikan:
+
+```bash
+docker login docker.senomas.com
+```
+
+### 4. Pull image
+
+Download semua image yang dibutuhkan dari registry:
+
+```bash
+docker compose pull
+```
+
+### 5. Build image
+
+```bash
+docker compose build
+```
+
+Hanya wajib jika belum pernah build Jenkins, atau ada perubahan pada `jenkins/jenkins/Dockerfile` dan file terkait.
+
+### 6. Setup GitLab
+
+Ikuti panduan lengkap di [Setup GitLab](docs/setup-gitlab.md).
+
+### 7. Setup Jenkins
+
+Ikuti panduan lengkap di [Setup Jenkins](docs/setup-jenkins.md).
+
+
+
+---
+
+
+## Menjalankan Project
+
+### 1. Menjalankan GitLab
+
+Menjalankan kontainer gitlab (pastikan gitlab sudah disetup)
+
+```bash
+docker compose up -d gitlab
+```
+
+Gitlab bisa diakses di
+```
+http://localhost:10806/
+```
+
+### 2. Menjalankan Jenkins
+
+Menjalankan kontainer jenkins (pastikan jenkins sudah disetup)
+
+```bash
+docker compose up -d jenkins
+```
+
+Jenkins bisa diakses di
+```
+http://localhost:10808/
+```
+
+### 3. Menjalankan ACE (middleware)
+
+Disarankan menjalankan ACE di tab terminal terpisah:
+
+```bash
+make ace
+```
+
+---
+
+## Useful Commands
+
+- Hentikan stack ACE (mwconfig, mwlog, btn-middleware):
+
+```bash
+make ace-down
+```
+
+- Hentikan semua container beserta volume:
+
+```bash
+make down
+```
+
+- Lihat status semua container:
+
+```bash
+docker compose ps
+```
+

docs/setup-gitlab.md

@@ -0,0 +1,80 @@
+# Setup GitLab
+
+Panduan ini menjelaskan cara menjalankan dan mengkonfigurasi GitLab lokal untuk project BTN Middleware.
+
+---
+
+## 1. Jalankan container GitLab
+
+Dari root project, jalankan:
+
+```bash
+docker compose up -d gitlab
+```
+
+---
+
+## 2. Pastikan GitLab healthy
+
+GitLab membutuhkan beberapa menit untuk inisialisasi pertama kali. Cek status container:
+
+```bash
+docker compose ps gitlab
+```
+
+Pastikan kolom **STATUS** menunjukkan `Up (healthy)`.
+
+
+## 3. Buka GitLab di browser
+
+Akses URL berikut:
+
+```
+http://localhost:10806
+```
+
+---
+
+## 4. Login sebagai root
+
+Gunakan kredensial berikut:
+
+| Field      | Nilai  |
+|------------|--------|
+| Username   | `root` |
+| Password   | lihat command di bawah |
+
+Ambil password awal root dengan:
+
+```bash
+docker exec gitlab cat /etc/gitlab/initial_root_password
+```
+
+Cari baris `Password:` itu password untuk user `root`.
+
+![Password GitLab](./gitlab-pass.png)
+
+> File password ini hanya valid ~24 jam setelah GitLab pertama kali di-setup, dan hanya jika password belum diubah manual.
+
+---
+
+## 5. Buat user baru
+
+Setelah login sebagai root, buat user baru. Untuk membuat user baru pergi ke halaman `http://localhost:10806/admin/users/new` 
+
+> **Penting:** User yang akan digunakan untuk development adalah **user baru ini**, bukan user `root`/admin. Jangan gunakan akun root untuk aktivitas sehari-hari.
+>
+> Alternatif: user baru juga bisa mendaftar lewat tombol **Register**, namun akun tersebut perlu **disetujui admin (root)** terlebih dahulu sebelum bisa login.
+
+---
+
+## 6. Login dengan user baru & buat group
+
+1. Logout dari akun root, lalu login dengan user baru yang sudah dibuat.
+2. Buat group dengan nama **`btnmw`** atau **`bsnmw`**.
+
+---
+
+Setup GitLab selesai.
+
+[Kembali ke Setup Project](README.MD).

docs/setup-jenkins.md

@@ -0,0 +1,57 @@
+# Setup Jenkins
+
+Panduan ini menjelaskan cara menjalankan dan mengkonfigurasi Jenkins lokal untuk project BTN Middleware.
+
+---
+
+## 1. Download jenkins-data
+
+Masuk ke folder `jenkins`, lalu unduh dan ekstrak `jenkins-data`:
+
+```bash
+cd jenkins
+wget -c code.senomas.com/file/jenkins-data.20230920.tgz -O - | tar -xz
+```
+
+Command ini akan **mengganti** folder `jenkins-data` yang sudah ada
+
+---
+
+## 2. Jalankan container Jenkins
+
+Kembali ke direktori utama project, lalu nyalakan Jenkins:
+
+```bash
+cd ..
+docker compose up -d jenkins
+```
+
+Cek status container:
+
+```bash
+docker compose ps jenkins
+```
+
+Pastikan kolom **STATUS** menunjukkan `Up`.
+
+---
+
+## 3. Buka Jenkins di browser
+
+Akses URL berikut:
+
+```
+http://localhost:10808/
+```
+
+---
+
+## 4. Login Jenkins
+
+Login menggunakan kredensial yang telah diberikan oleh tim.
+
+---
+
+Setup Jenkins selesai.
+
+[Kembali ke Setup Project](../README.MD).