Cara Deploy Aplikasi ke VPS dengan Docker

Diposkan oleh BagasUnix Post a Comment

# Cara Deploy Aplikasi ke VPS dengan Docker: Panduan Lengkap

Gw pernah spent 3 jam debug aplikasi yang jalan sempurna di laptop tapi crash terus di VPS. Ternyata? Beda versi Node.js. 🤦 Sejak itu, Docker jadi best friend gw buat deploy. Kalau kamu juga sering pusing pas deploy aplikasi ke VPS, artikel ini bakal jadi cheat sheet kamu. Docker bikin cara deploy aplikasi ke VPS dengan Docker jadi jauh lebih predictable. Gak ada lagi cerita "works on my machine" tapi production nangis. Yuk, kita bedah step-by-step dari nol sampai aplikasi kamu live di internet. ---

Mengapa Docker untuk Deploy di VPS?

Sebelum gas ke praktik, penting banget pahami kenapa Docker itu game changer untuk deployment. Bukan cuma hype — ini masalah real yang Docker solve.

Konsistensi Lingkungan

Kamu pernah gak sih, pas awalnya aplikasi jalan mulus di local, tapi begitu di-upload ke VPS, tiba-tiba error gak jelas? Biasanya ini gara-gara beda versi runtime, library, atau OS configuration. Docker solve masalah ini dengan cara containerize seluruh aplikasi kamu — termasuk dependencies, runtime, bahkan OS libraries-nya. Jadi apapun environment VPS kamu, aplikasi tetap jalan persis seperti di local. > "Tapi kan bisa pakai virtualenv atau nvm?" — Bisa, tapi itu cuma solve di level runtime. Docker solve di level system-wide. Lebih reliable.

Portabilitas & Efisiensi

Docker container itu super lightweight dibanding VM. Kamu bisa jalankan beberapa container di satu VPS tanpa bikin server nangis. Resource usage-nya juga lebih kecil. Plus, kamu bisa pindah-pindah server cuma dengan pull image yang sama. VPS mati? Tinggal deploy ulang di server baru dalam hitungan menit.

Skalabilitas Mudah

Butuh scale up? Tambah container. Butuh scale down? Hapus container. Docker Compose bikin orchestration lokal jadi gampang, dan kalau butuh production-grade, ada Docker Swarm atau Kubernetes sebagai next step. ---

Persiapan: VPS, Docker, dan Aplikasi

Oke, sekarang kita mulai praktik. Pastikan kamu sudah punya VPS aktif — bisa DigitalOcean, Vultr, Linode, atau provider lokal seperti IDCloudHost.

Memilih & Mengatur VPS (Ubuntu/Debian)

Untuk panduan ini, kita pakai Ubuntu 22.04 LTS karena paling stabil dan dokumentasinya lengkap. Minimal RAM 1GB untuk aplikasi kecil-menengah. SSH ke VPS kamu dulu:

ssh root@ip-address-vps-kamu

Update system dulu biar fresh:

sudo apt update && sudo apt upgrade -y

Instalasi Docker & Docker Compose

Ini step yang sering bikin bingung pemula. Ikutin aja urutannya:

# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Tambah user ke docker group (biar gak perlu sudo terus)
sudo usermod -aG docker $USER

# Logout dan login lagi, atau pakai ini:
newgrp docker

# Verifikasi instalasi
docker --version
docker compose version

Kalau muncul versi Docker, artinya instalasi berhasil. 🎉

Menyiapkan Aplikasi dengan Dockerfile

Nah, ini bagian seru. Kita buat Dockerfile untuk aplikasi. Gw kasih contoh untuk Node.js app sederhana:

# Dockerfile
FROM node:18-alpine

WORKDIR /app

# Copy package files dulu (untuk cache layer)
COPY package*.json ./

# Install dependencies
RUN npm ci --only=production

# Copy semua source code
COPY . .

# Expose port yang dipakai aplikasi
EXPOSE 3000

# Command untuk menjalankan aplikasi
CMD ["node", "server.js"]

Untuk Laravel, Dockerfile-nya beda sedikit:

# Dockerfile Laravel
FROM php:8.2-fpm

# Install system dependencies
RUN apt-get update && apt-get install -y \
    git curl zip unzip libpng-dev libonig-dev libxml2-dev \
    && docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd

# Install Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

WORKDIR /var/www

COPY . .

RUN composer install --no-dev --optimize-autoloader

EXPOSE 9000
CMD ["php-fpm"]

Tips: Selalu gunakan .dockerignore supaya file yang gak perlu (seperti node_modules, .env, .git) gak ikut ke image. Ini bisa bikin image kamu 10x lebih kecil!

# .dockerignore
node_modules
.env
.git
*.md
Dockerfile

---

Deploy Aplikasi Step-by-Step

Sekarang kita mulai deploy. Ikuti setiap step-nya, jangan skip.

Build Image Docker

Pertama, upload source code kamu ke VPS. Bisa pakai Git, scp, atau rsync:

# Contoh pakai Git
git clone https://github.com/username/project-kamu.git
cd project-kamu

Build image-nya:

docker build -t nama-app:v1 .

Cek apakah image berhasil dibuat:

docker images

Kamu bakal lihat list image termasuk yang baru di-build tadi.

Menjalankan Container Pertama

Sekarang jalankan container dari image yang sudah dibuat:

docker run -d \
  --name app-container \
  -p 80:3000 \
  --restart unless-stopped \
  nama-app:v1

Breakdown command-nya:

-d = run in background (detached mode)
--name = nama container biar gampang dimanage
-p 80:3000 = mapping port 80 VPS ke port 3000 di dalam container
--restart unless-stopped = auto-restart kalau server reboot

Cek apakah container jalan:

docker ps
docker logs app-container

Kalau gak ada error di logs, coba akses http://ip-vps-kamu di browser. harusnya aplikasi sudah live! 🚀

Mengelola Port & Volume

Untuk persistent data (database, upload files), pakai volume:

# Named volume untuk database
docker volume create db-data

# Run dengan volume mount
docker run -d \
  --name db-container \
  -v db-data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=rahasia123 \
  -p 3306:3306 \
  mysql:8.0

Dengan volume, data kamu tetap aman meskipun container dihapus. Penting banget untuk production! ---

Mengamankan & Mempublikasikan Aplikasi

Deploy aja belum cukup. Aplikasi harus aman dan bisa diakses dengan domain.

Konfigurasi Reverse Proxy dengan Nginx

Jangan langsung expose port aplikasi ke internet. Pakai Nginx sebagai reverse proxy:

sudo apt install nginx -y

Buat config baru:

sudo nano /etc/nginx/sites-available/app-kamu

Isi dengan:

server {
    listen 80;
    server_name domain-kamu.com;

    location / {
        proxy_pass http://localhost:80;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_cache_bypass $http_upgrade;
    }
}

Aktifkan config-nya:

sudo ln -s /etc/nginx/sites-available/app-kamu /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Menerapkan SSL/TLS Gratis (Let's Encrypt)

Jangan pernah jalankan production tanpa SSL. Untungnya, Let's Encrypt gratis dan setup-nya gampang:

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d domain-kamu.com

Follow instruksi di terminal. Certbot bakal otomatis setup SSL dan redirect HTTP ke HTTPS.

Firewall & Praktik Keamanan Dasar

Jangan lupa aktifkan firewall. Minimal buka port yang diperlukan aja:

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status

Tips keamanan tambahan:

Jangan pakai password root untuk SSH — pakai SSH key
Disable root login di SSH config
Ganti port SSH default (22) ke port lain
Update system secara berkala

---

Otomasi & Monitoring di Produksi

Deploy manual itu oke untuk awal. Tapi untuk production, kamu butuh otomasi.

Logging & Monitoring Container

Docker punya built-in logging. Tapi untuk production, pertimbangkan pakai logging driver:

# Lihat logs real-time
docker logs -f app-container

# Cek resource usage
docker stats

# Lihat detail container
docker inspect app-container

Untuk monitoring lebih serius, bisa pakai Portainer (GUI untuk Docker) atau prometheus + grafana.

Mengatur CI/CD Pipeline Sederhana

Contoh GitHub Actions untuk auto-deploy:

# .github/workflows/deploy.yml
name: Deploy to VPS

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy via SSH
        uses: appleboy/ssh-action@master
        with:
          host: ${{ secrets.VPS_HOST }}
          username: ${{ secrets.VPS_USER }}
          key: ${{ secrets.VPS_SSH_KEY }}
          script: |
            cd /var/www/app
            git pull origin main
            docker compose up -d --build

Sekarang setiap push ke branch main, aplikasi otomatis ter-deploy. Saves a lot of time! ⏱️

Backup & Restore Strategy

Jangan pernah skip backup. Buat script sederhana:

#!/bin/bash
# backup.sh
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/backups"

# Backup database
docker exec db-container mysqldump -u root -p$MYSQL_PASS --all-databases > $BACKUP_DIR/db_$DATE.sql

# Backup source code
tar -czf $BACKUP_DIR/app_$DATE.tar.gz /var/www/app

# Hapus backup lebih dari 7 hari
find $BACKUP_DIR -mtime +7 -delete

echo "Backup selesai: $DATE"

Jalankan pakai cron job:

crontab -e
# Tambah baris ini (backup setiap jam 3 pagi)
0 3 * * * /bin/bash /path/to/backup.sh

---

Troubleshooting Umum

Berikut beberapa masalah yang sering muncul dan caraatasinya.

Debug Container Gagal Start

Kalau container mati terus, cek logs-nya:

# Lihat logs meskipun container stopped
docker logs app-container

# Cek status
docker ps -a

# Masuk ke dalam container untuk debug
docker exec -it app-container /bin/sh

Masalah paling umum: environment variable yang salah, file gak ke-copy, atau port sudah dipakai lain.

Masalah Jaringan & Port Conflict

Kalau dapat error "port already in use":

# Cari proses yang pakai port tersebut
sudo lsof -i :80

# Atau pakai Docker network untuk isolasi
docker network create app-network
docker run -d --network app-network --name app-container nama-app:v1

Docker network bikin container-container kamu bisa komunikasi tanpa expose port ke host.

Optimasi Ukuran Image

Image yang kecil = pull lebih cepat, deploy lebih hemat. Tips optimization:

# Pakai multi-stage build
FROM node:18-alpine AS builder
WORKDIR /app
COPY . .
RUN npm ci && npm run build

FROM node:18-alpine
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
EXPOSE 3000
CMD ["node", "dist/server.js"]

Multi-stage build bisa bikin image production kamu 60-70% lebih kecil karena gak include dev dependencies dan build tools. ---

BagasUnix