- Modul Consumable Item: model master, buku besar transaksi (stock ledger), purchase unit conversion, stock opname, dan transaction reversal - Integrasi ke Employee Management, Asset Unit, dan tiket/work order - Konfigurasi akses jaringan lokal (LAN) via 0.0.0.0:8000, ALLOWED_HOSTS, dan CSRF_TRUSTED_ORIGINS otomatis - Script pembuka firewall Windows (buka_firewall_lan.bat) dan menu interaktif run.bat - Skema migrasi 0019_consumableitem_consumabletransaction - Seeder 11 item consumable riil (seed_consumables.py) - Test suite komprehensif (41 automated tests, 100% lulus) - Pipeline CI/CD GitHub Actions (.github/workflows/ci.yml)
6.9 KiB
6.9 KiB
10 — Deployment & Operational Runbook
Tanggal Analisis: 26 Oktober 2026
Status Verifikasi: Disusun berdasarkan bukti repository (settings.py, package.json, manage.py, .env.example, scratch_urls_all.py)
Lingkungan Target Terdeteksi: Windows Server / Linux Server, Laragon / Apache / Nginx, MySQL / MariaDB
1. Analisis Arsitektur Deployment Eksisting
Berdasarkan bukti di file repository:
- WSGI & ASGI Entry Point:
itam_core/wsgi.py(tersedia untuk WSGI Server seperti Gunicorn/uWSGI/mod_wsgi).itam_core/asgi.py(tersedia, namun saat ini tidak ada fitur asynchronous/websocket).
- Environment Path Clues:
- File
scratch_urls_all.pybaris 3 menunjukkan path development awal:c:/laragon/www/Manajemen-Aset-IT/...(Environment Laragon berbasis Windows).
- File
- Frontend Build Pipeline:
- Proyek menggunakan Vite + TailwindCSS + PostCSS (
package.json). - File output CSS final dikompilasi ke
static/dist/style.css(sudah di-commit di git). django-vitedanWhiteNoisedikonfigurasi disettings.pyuntuk menyajikan static files di mode production.
- Proyek menggunakan Vite + TailwindCSS + PostCSS (
- Media Storage:
- Direktori
media/bast_documents/digunakan untuk menyimpan file BAST yang diunggah pengguna.
- Direktori
2. Kebutuhan Lingkungan & Dependensi Sistem (Prerequisites)
| Komponen | Spesifikasi Rekomendasi | Keterangan |
|---|---|---|
| OS | Linux (Ubuntu 22.04 LTS / Debian 12) atau Windows Server | Linux sangat direkomendasikan untuk stabilitas produksi |
| Python | Python 3.10 atau 3.11 | Wajib untuk kompatibilitas Django 5.2 |
| Node.js | Node.js v18.x atau v20.x + npm | Hanya diperlukan saat build aset CSS/JS |
| Database | MySQL 8.0+ atau MariaDB 10.6+ | Karakter set utf8mb4 wajib aktif |
| Utilitas Sistem | mysqldump |
Wajib ada di PATH sistem agar fitur backup SQL berjalan |
| Web Server | Nginx (Reverse Proxy) + Gunicorn | Menangani HTTPS termination & media serving |
3. Variabel Lingkungan (Environment Variables)
File .env wajib dibuat di root direktori dengan parameter berikut:
# ==========================================
# KONFIGURASI INTI DJANGO
# ==========================================
DJANGO_SECRET_KEY=isi-dengan-string-acak-panjang-dan-unik-50-karakter
DJANGO_DEBUG=False
DJANGO_ALLOWED_HOSTS=aset.ptkmh.co.id,localhost,127.0.0.1
CSRF_TRUSTED_ORIGINS=https://aset.ptkmh.co.id
# ==========================================
# KONFIGURASI DATABASE MYSQL
# ==========================================
DB_NAME=manajemen_aset_it
DB_USER=db_user_it
DB_PASSWORD=password_database_kuat
DB_HOST=127.0.0.1
DB_PORT=3306
# ==========================================
# KEAMANAN HTTPS (PRODUCTION)
# ==========================================
SECURE_SSL_REDIRECT=True
# ==========================================
# INISIALISASI SUPERUSER (Opsional, untuk setup awal)
# ==========================================
SUPERUSER_USERNAME=admin
SUPERUSER_EMAIL=[email protected]
SUPERUSER_PASSWORD=password_admin_sangat_rahasia
4. Prosedur Instalasi & Deployment Langkah-demi-Langkah
Tahap 1: Persiapan Repository & Virtual Environment
# Masuk ke direktori aplikasi
cd /var/www/manajemen-aset-it
# Buat virtual environment Python
python3 -m venv venv
source venv/bin/activate
# Upgrade pip & install dependensi
pip install --upgrade pip
pip install -r requirements.txt
Tahap 2: Build Frontend Assets (TailwindCSS)
# Instal node modules & build aset produksi
npm ci
npm run build
Tahap 3: Konfigurasi Database & Migrasi
# Pastikan database telah dibuat di MySQL:
# CREATE DATABASE manajemen_aset_it CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
# Jalankan migrasi skema
python manage.py migrate
# Jalankan seeding kategori awal
python manage.py seed_initial_data
# Buat akun administrator (jika belum ada)
python manage.py setup_superuser
Tahap 4: Pengumpulan Static Files
python manage.py collectstatic --noinput
5. Konfigurasi Layanan Produksi (Gunicorn + Nginx + Systemd)
5.1 Service Systemd Gunicorn (/etc/systemd/system/itam.service)
[Unit]
Description=Gunicorn daemon for IT Asset Management PT KMH
After=network.target
[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/manajemen-aset-it
ExecStart=/var/www/manajemen-aset-it/venv/bin/gunicorn \
--access-logfile /var/log/gunicorn/itam_access.log \
--error-logfile /var/log/gunicorn/itam_error.log \
--workers 3 \
--bind unix:/run/itam.sock \
itam_core.wsgi:application
[Install]
WantedBy=multi-user.target
5.2 Konfigurasi Nginx Virtual Host (/etc/nginx/sites-available/itam)
server {
listen 80;
server_name aset.ptkmh.co.id;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name aset.ptkmh.co.id;
ssl_certificate /etc/ssl/certs/ptkmh_ssl.crt;
ssl_certificate_key /etc/ssl/private/ptkmh_ssl.key;
client_max_body_size 10M;
# Static files dilayani langsung oleh Nginx (Cache efisien)
location /static/ {
alias /var/www/manajemen-aset-it/staticfiles/;
expires 30d;
add_header Cache-Control "public, no-transform";
}
# Media files (Dokumen BAST fisik & QR Code)
location /media/ {
alias /var/www/manajemen-aset-it/media/;
expires 7d;
add_header Cache-Control "private";
}
# Reverse proxy ke Gunicorn socket
location / {
include proxy_params;
proxy_pass http://unix:/run/itam.sock;
}
}
6. Prosedur Backup & Disaster Recovery
6.1 Prosedur Backup Otomatis Terjadwal (Cron Job)
Aplikasi memiliki fitur backup web di /backup/, namun untuk keandalan infrastruktur wajib disiapkan backup level sistem menggunakan cron job:
# Tambahkan ke crontab (setiap hari pukul 02:00 dini hari)
0 2 * * * /usr/bin/mysqldump -u db_user_it -p'password' manajemen_aset_it | gzip > /backup/db/itam_db_$(date +\%Y\%m\%d).sql.gz
# Backup folder media upload setiap minggu
0 3 * * 0 tar -czf /backup/media/itam_media_$(date +\%Y\%m\%d).tar.gz /var/www/manajemen-aset-it/media/
6.2 Prosedur Pemulihan (Restoration Runbook)
- Restore dari File SQL:
gunzip < /backup/db/itam_db_20261026.sql.gz | mysql -u db_user_it -p manajemen_aset_it - Restore dari File JSON Django (Fitur Bawaan Aplikasi):
python manage.py loaddata backup_manajemen_aset_2026-10-26.json
7. Pemantauan & Logging Operasional
- Application Error Log:
error.logdi root direktori aplikasi (dikonfigurasi padasettings.pyL165-190). - Web Server Logs:
/var/log/nginx/access.logdan/var/log/nginx/error.log. - Gunicorn Logs:
/var/log/gunicorn/itam_error.log.
Warning
File
error.logdi root folder aplikasi belum memiliki sistem log rotation. Pastikan dikonfigurasikanlogrotatepada OS server agar ukuran log tidak memenuhi ruang disk.