Andrie
106 lines
2.9 KiB
Markdown
106 lines
2.9 KiB
Markdown
# Deployment Docker
|
|
|
|
Panduan ini menjadi referensi utama untuk menjalankan WebGIS Poverty Mapping. XAMPP tidak lagi menjadi jalur deploy utama; gunakan XAMPP hanya sebagai fallback legacy.
|
|
|
|
## Runtime
|
|
|
|
- PHP 8.2 Apache dari `Dockerfile` root repository.
|
|
- MariaDB 11.4 dari `docker-compose.yml`.
|
|
- Database aplikasi final: `db_webgis`.
|
|
- Database project kelas `01/`: `db_webgis_01`.
|
|
- Aplikasi final tersedia di path `/WebgisPovertyMapping/`.
|
|
|
|
## Struktur Docker
|
|
|
|
File Docker berada di root repository `webgis/`:
|
|
|
|
```text
|
|
Dockerfile
|
|
docker-compose.yml
|
|
docker-compose.local.yml
|
|
.env.example
|
|
docker/apache-webgis.conf
|
|
```
|
|
|
|
Service:
|
|
|
|
- `app`: Apache + PHP, melayani root landing page, `01/`, dan `WebgisPovertyMapping/`.
|
|
- `db`: MariaDB, private untuk service `app`.
|
|
|
|
## Local Development
|
|
|
|
Jalankan dari root repository:
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
docker compose -f docker-compose.yml -f docker-compose.local.yml up --build -d
|
|
```
|
|
|
|
Buka:
|
|
|
|
```text
|
|
http://localhost:8080/
|
|
http://localhost:8080/WebgisPovertyMapping/
|
|
```
|
|
|
|
Jika port `8080` sudah dipakai, tambahkan di `.env`:
|
|
|
|
```env
|
|
APP_PORT=8081
|
|
```
|
|
|
|
Lalu jalankan ulang compose lokal.
|
|
|
|
## Database Init
|
|
|
|
MariaDB menjalankan file berikut hanya saat volume database masih kosong:
|
|
|
|
```text
|
|
01/setup_database.sql
|
|
WebgisPovertyMapping/setup_database.sql
|
|
```
|
|
|
|
Untuk reset database lokal:
|
|
|
|
```bash
|
|
docker compose -f docker-compose.yml -f docker-compose.local.yml down -v
|
|
docker compose -f docker-compose.yml -f docker-compose.local.yml up --build -d
|
|
```
|
|
|
|
## Production Di Coolify
|
|
|
|
Gunakan `docker-compose.yml` saja.
|
|
|
|
1. Push root repository `webgis/` ke Git provider.
|
|
2. Buat resource baru di Coolify dari repository tersebut.
|
|
3. Pilih deployment type `Docker Compose`.
|
|
4. Set compose file ke `docker-compose.yml`.
|
|
5. Assign domain ke service `app`, misalnya `https://ifuntanhub.dev`.
|
|
6. Set environment variable:
|
|
|
|
```env
|
|
MARIADB_ROOT_PASSWORD=isi-password-kuat
|
|
```
|
|
|
|
`docker-compose.yml` production hanya memakai `expose: 80`. Jangan tambahkan `ports:` untuk production, karena routing publik harus lewat reverse proxy Coolify.
|
|
|
|
## Reverse Proxy
|
|
|
|
Coolify/reverse proxy menerima traffic publik dari domain dan meneruskannya ke container `app` port `80`.
|
|
|
|
Alur request:
|
|
|
|
```text
|
|
https://ifuntanhub.dev -> Coolify reverse proxy -> app:80 -> /WebgisPovertyMapping/
|
|
```
|
|
|
|
Header `X-Forwarded-Proto: https` dipakai oleh aplikasi untuk mengenali HTTPS saat menentukan secure session cookie.
|
|
|
|
## Troubleshooting
|
|
|
|
- App tidak bisa dibuka lokal: pastikan memakai `docker-compose.local.yml`, bukan hanya `docker-compose.yml`.
|
|
- DB gagal terhubung: cek env `MARIADB_ROOT_PASSWORD`, service `db`, dan healthcheck MariaDB.
|
|
- SQL init tidak berubah setelah edit schema: reset volume database; MariaDB hanya menjalankan init script saat volume kosong.
|
|
- Domain Coolify tidak masuk ke app: pastikan domain diassign ke service `app` dan container port `80`.
|
|
- Peta/chart/font gagal load: cek akses internet ke CDN dan tile provider eksternal.
|