Auto-Detect Framework di Helipod: Deploy Tanpa Konfigurasi

Deploy aplikasi seharusnya mudah. Connect repository, klik deploy, selesai. Tapi kenyataannya, banyak platform yang butuh konfigurasi ribet — Dockerfile, buildpacks, environment detection.

Helipod menggunakan auto-detect framework untuk mengenali project kamu secara otomatis. Cukup hubungkan repository, dan sistem akan mendeteksi framework, build command, dan start command yang tepat.

Cara Kerja Auto-Detect

1. Hubungkan Repository

Buka Helipod dashboard
Klik New Service
Pilih GitHub atau GitLab
Pilih repository

2. Auto-Detect Berjalan

Helipod akan scan repository kamu dan mendeteksi:

Framework — Next.js, Django, Laravel, Go, dll
Runtime — Node.js, Python, PHP, Go
Package manager — npm, yarn, pip, composer
Build command — yarn build, python manage.py collectstatic, dll
Start command — yarn start, gunicorn, php-fpm, dll

3. Review dan Deploy

Review konfigurasi yang ter-deteksi, lalu klik Deploy.

Framework yang Didukung

JavaScript/TypeScript

Framework	Auto-Detect	Build Command	Start Command
Next.js	✅	`yarn build`	`yarn start`
Nuxt.js	✅	`yarn build`	`node .output/server/index.mjs`
Remix	✅	`yarn build`	`yarn start`
Express.js	✅	-	`node server.js`
NestJS	✅	`yarn build`	`node dist/main.js`
Vite	✅	`yarn build`	- (static)

Python

Framework	Auto-Detect	Build Command	Start Command
Django	✅	`python manage.py collectstatic`	`gunicorn myproject.wsgi`
FastAPI	✅	-	`uvicorn main:app`
Flask	✅	-	`gunicorn app:app`

PHP

Framework	Auto-Detect	Build Command	Start Command
Laravel	✅	`composer install`	`php-fpm`
Symfony	✅	`composer install`	`php-fpm`

Go

Framework	Auto-Detect	Build Command	Start Command
Standard Go	✅	`go build`	`./main`
Gin	✅	`go build`	`./main`
Echo	✅	`go build`	`./main`

Static Sites

Framework	Auto-Detect	Build Command	Start Command
HTML/CSS/JS	✅	-	- (static)
Astro	✅	`yarn build`	- (static)
Hugo	✅	`hugo`	- (static)

Contoh Auto-Detect

Next.js Project

Repository structure:
├── package.json
├── next.config.js
├── pages/
└── public/

Helipod detects:
- Framework: Next.js
- Runtime: Node.js 20
- Package manager: yarn
- Build command: yarn build
- Start command: yarn start
- Port: 3000

Django Project

Repository structure:
├── requirements.txt
├── manage.py
├── myproject/
│   ├── settings.py
│   └── wsgi.py
└── apps/

Helipod detects:
- Framework: Django
- Runtime: Python 3.12
- Package manager: pip
- Build command: python manage.py collectstatic --noinput
- Start command: gunicorn myproject.wsgi:application --bind 0.0.0.0:8000
- Port: 8000

Laravel Project

Repository structure:
├── composer.json
├── artisan
├── app/
├── public/
└── routes/

Helipod detects:
- Framework: Laravel
- Runtime: PHP 8.3
- Package manager: composer
- Build command: composer install --optimize-autoloader
- Start command: php-fpm
- Port: 9000

Custom Konfigurasi

Jika auto-detect tidak sesuai, kamu bisa override konfigurasi:

Override Build Command

# helipod.yml (opsional)
build:
  command: yarn build:prod

Override Start Command

# helipod.yml (opsional)
run:
  command: node custom-server.js

Custom Dockerfile

Kalau butuh kontrol penuh, buat Dockerfile sendiri:

FROM node:20-alpine
WORKDIR /app
COPY package.json yarn.lock ./
RUN yarn install --frozen-lockfile
COPY . .
RUN yarn build
EXPOSE 3000
CMD ["yarn", "start"]

Helipod akan mendeteksi Dockerfile dan menggunakannya alih-alih auto-detect.

Untuk panduan Dockerfile lengkap, baca: Cara Membuat Dockerfile untuk Deploy

Monorepo Support

Auto-detect juga mendukung monorepo dengan banyak service:

my-monorepo/
├── packages/
│   ├── frontend/     → Next.js
│   ├── backend/      → Express.js
│   └── shared/       → Library
├── package.json
└── turbo.json

Setup di Helipod:

Buat service untuk packages/frontend
Buat service untuk packages/backend
Set working directory masing-masing
Deploy

Troubleshooting

Auto-Detect Salah

Jika framework tidak ter-deteksi dengan benar:

Pastikan file konfigurasi ada di root repository
Cek package.json, requirements.txt, atau go.mod
Override konfigurasi manual jika diperlukan

Build Gagal

Cek build logs untuk error message
Pastikan dependencies terinstall dengan benar
Verifikasi build command sesuai framework

Port Tidak Sesuai

Pastikan aplikasi listen ke port yang benar (biasanya process.env.PORT)
Cek konfigurasi port di Helipod

Untuk troubleshooting lebih lanjut, baca: Cara Membuat Dockerfile untuk Deploy — bagian debugging

Best Practices

1. Ikuti Convention Framework

Gunakan struktur project yang standar agar auto-detect bisa bekerja dengan baik.

2. Dokumentasi di README

Tulis build dan start command di README.md. Ini membantu jika auto-detect perlu override.

3. Test Locally

Pastikan aplikasi bisa jalan lokal sebelum deploy. Auto-detect tidak bisa fix kode yang broken.

4. Gunakan Dockerfile untuk Kasus Khusus

Jika butuh system dependency khusus atau build steps kompleks, gunakan Dockerfile custom.

Mulai Sekarang

Daftar gratis di helipod.io. Hubungkan repository dan deploy dalam hitungan menit — tidak perlu konfigurasi manual.

Butuh bantuan? Hubungi support@helipod.id atau bergabung di komunitas hangar.helipod.io.

Baca juga:

Cara Membuat Dockerfile untuk Deploy — panduan Dockerfile lengkap

CI/CD dengan GitLab — auto deploy setiap push

Environment Variables di Helipod — cara set konfigurasi