Files
KMH_IT_Assets/docs/analysis/10-deployment-operations.md
T
nuexn0x-9 f28983011c feat: implement consumable inventory module, network LAN access, and CI/CD enhancements
- 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)
2026-10-27 09:42:15 +07:00

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:

  1. 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).
  2. Environment Path Clues:
    • File scratch_urls_all.py baris 3 menunjukkan path development awal: c:/laragon/www/Manajemen-Aset-IT/... (Environment Laragon berbasis Windows).
  3. 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-vite dan WhiteNoise dikonfigurasi di settings.py untuk menyajikan static files di mode production.
  4. Media Storage:
    • Direktori media/bast_documents/ digunakan untuk menyimpan file BAST yang diunggah pengguna.

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)

  1. Restore dari File SQL:
    gunzip < /backup/db/itam_db_20261026.sql.gz | mysql -u db_user_it -p manajemen_aset_it
    
  2. 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.log di root direktori aplikasi (dikonfigurasi pada settings.py L165-190).
  • Web Server Logs: /var/log/nginx/access.log dan /var/log/nginx/error.log.
  • Gunicorn Logs: /var/log/gunicorn/itam_error.log.

Warning

File error.log di root folder aplikasi belum memiliki sistem log rotation. Pastikan dikonfigurasikan logrotate pada OS server agar ukuran log tidak memenuhi ruang disk.