2.9 KiB
🚀 MERICA — Low-Code Data Lakehouse Platform (Production Release)
MERICA (Managed Engine for Robust Ingestion & Cloud Airflow) adalah platform visual low-code mandiri khusus Data Engineer untuk merancang, mengonfigurasi, dan menyusun task DAG Apache Airflow secara deklaratif tanpa menulis boilerplate Python manual.
Paket rilis ini adalah Clean Production Appliance yang dapat dijalankan secara mandiri (standalone) dan langsung dihubungkan ke kluster Apache Airflow eksternal yang sudah ada.
⚡ Panduan Cepat Memulai (Quick Start 2 Menit)
1. Salin Berkas Konfigurasi Lingkungan
cp .env.example .env
Sesuaikan AIRFLOW_WEB_URL mengarah ke alamat server Apache Airflow existing Anda (default: http://host.docker.internal:14080).
2. Jalankan Script Setup Sekali Klik
bash ./setup.sh
Atau jalankan manual:
docker compose up -d
3. Akses Antarmuka Web
Setelah kontainer aktif dan sehat (healthy):
- MERICA Canvas UI:
http://localhost:14000 - Kredensial Default: Username:
admin| Password:admin
🏛️ Pilihan Mode Deployment
| Mode Deployment | Berkas Compose | Keterangan |
|---|---|---|
| 1. Standalone Appliance (Default) | docker-compose.yml |
Hanya 1 kontainer merica (Port 14000, RAM ~100MB). Terhubung ke kluster Apache Airflow, PostgreSQL, dan MinIO eksternal. |
| 2. All-in-One Appliance (Demo) | docker-compose.all-in-one.yml |
Menjalankan MERICA bersama Apache Airflow 3 tertanam (Webserver: 14080, Scheduler, DAG Processor) untuk evaluasi lokal di 1 mesin. |
Untuk menjalankan mode All-in-One (dengan Airflow lokal):
docker compose -f docker-compose.all-in-one.yml up -d
📚 Dokumentasi Lengkap
Seluruh panduan teknis tersedia terstruktur di dalam direktori docs/:
- 🗺️ Pusat Dokumentasi & Alur Membaca (Index Hub): Peta panduan lengkap dan rekomendasi alur membaca dokumen.
- 🏛️ Arsitektur Sistem: Topologi Single-Port Appliance (Port 14000), isolasi perimeter loopback, modul backend stateless, dan integrasi GitOps Airflow 3.
- 📦 Panduan Deployment & Build: Spesifikasi hardware ultra-ringan (~100MB RAM), instalasi cepat
setup.sh, build image mandiri, dan upgrade runbook. - 📘 Panduan Integrasi External Airflow: Dua metode penyiapan Airflow existing (Metode 1: Tanpa Rebuild dan Metode 2: Build Ulang Image Resmi) serta pengelolaan starter pipelines.
- 🎨 Panduan Penggunaan Canvas (User Guide): Tata cara merancang pipeline visual, database introspection & safe preview, Google Workspace discovery, dlt REST API, dan Shift-Left dbt testing.
🛑 Menghentikan Layanan
docker compose down
Untuk menghentikan dan membersihkan volume data:
docker compose down -v