Menjalankan EdigSSO Pro (Deployment)¶
Panduan ini berisi cara paling mudah untuk me-running (menjalankan) portal SSO Odoo secara lokal maupun di server produksi menggunakan arsitektur Docker Compose.
1. Persiapan Server¶
Pastikan Server atau Komputer Anda sudah meng-install: - Docker Engine - Docker Compose - Git (Opsional jika ingin clone repository langsung).
2. Environment Variables (.env)¶
Buat salinan file .env.example menjadi .env. Ini sangat penting, terutama ENCRYPTION_KEY.
cp .env.example .env
Buka dan sesuaikan variabel di dalam .env:
- JWT_SECRET: Harus string rahasia panjang (contoh: openssl rand -hex 32).
- ENCRYPTION_KEY: Wajib 32 byte dan jangan sampai dihilangkan (bila hilang, semua API Key di database tidak bisa di-decrypt).
- Konfigurasi PostgreSQL dan Redis (Username, Password).
3. Deployment Docker Compose¶
EdigSSO sudah di-bundle menjadi 3 services (App, Postgres, Redis). Jalankan perintah berikut di direktori root aplikasi:
# Menjalankan seluruh sistem di latar belakang (detached)
docker compose up -d
Pastikan semua berjalan baik dengan melakukan curl ke health endpoint:
curl http://localhost:8000/health
# Harus mengembalikan {"status":"healthy", ...}
4. Inisialisasi Database (Alembic)¶
Karena menggunakan ORM Alembic, migrasi struktur tabel (terutama untuk penambahan skema organisasi dan Pool Key) tidak otomatis dilakukan dari perintah create_all.
Jalankan migrasi pertama Anda:
# Eksekusi shell di dalam docker container `app`
docker compose exec app alembic upgrade head
Jika ini adalah database Odoo baru atau environment percobaan lokal, skrip inisialisasi awal juga tersedia:
docker compose exec app python -m app.models.database