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, ataugo.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.io 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
