Belajar Traefik - Installing Traefik

#Pendahuluan

Sekarang teori sudah cukup — saatnya menjalankan Traefik sungguhan. Episode 3 memandu kalian menginstall Traefik dengan beberapa metode, dari yang paling sederhana sampai yang paling siap production. Setiap metode punya trade-off yang perlu kalian pahami sebelum memilih.

Metode yang akan kita gunakan untuk sepanjang series adalah Docker Compose: cepat, rapi, dan merepresentasikan setup yang umum dipakai di produksi. Di akhir episode, kalian akan menjalankan Traefik, membuka dashboard, dan membaca log pertamanya. Momen "Traefik berjalan" ini akan menjadi titik tolak semua eksperimen berikutnya.

#Metode Instalasi yang Tersedia

#Ringkasan Lima Metode

• Binary: unduh executable Traefik dari GitHub releases. Cocok untuk server sederhana tanpa Docker.
• Docker container: jalankan image resmi traefik dengan satu perintah. Ini cara paling direkomendasikan.
• Docker Compose: versi Docker yang lebih rapi dengan network, volume, dan service lain dalam satu file.
• Kubernetes: via Helm chart atau manifest — dibahas detail di episode 20-21.
• Package manager: APT atau Homebrew untuk distro tertentu, tapi sering tertinggal versi.

Traefik versi saat ini adalah v3.x. Pastikan selalu mengecek tag image resmi di Docker Hub. Kita akan konsisten memakai image traefik:v3 dengan tag minor terbaru.

#Instalasi Binary

#Download dan Verifikasi

Untuk server bare-metal tanpa Docker, binary adalah pilihan paling ringan:

curl -L -o traefik.tar.gz https://github.com/traefik/traefik/releases/download/v3.1.0/traefik_v3.1.0_linux_amd64.tar.gz
tar -xzf traefik.tar.gz
sudo mv traefik /usr/local/bin/
traefik version

Binary tunggal ini tidak butuh dependency apa pun — itulah keuntungan Go. Untuk menjalankan sebagai service di Linux, daftarkan lewat systemd dengan ExecStart=/usr/local/bin/traefik. Namun untuk mengikuti series ini dengan lancar, metode Docker lebih direkomendasikan karena menyeragamkan environment.

#Instalasi Docker

#Minimal Docker Run

Cara tercepat menjalankan Traefik adalah satu perintah docker run. Perhatikan dua hal penting: mount file konfigurasi dan mount Docker socket untuk provider:

docker run -d \
  --name traefik \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  traefik:v3

Sekilas container sudah berjalan. Tapi perhatikan: tidak ada entrypoint yang didefinisikan, sehingga Traefik hanya menampilkan API di port 8080 dan tidak benar-benar merutekan HTTP. Untuk setup fungsional, definisikan entrypoint lewat command line:

docker run -d \
  --name traefik \
  -p 80:80 \
  -p 8080:8080 \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  traefik:v3 \
  --api.insecure=true \
  --entrypoints.web.address=:80 \
  --providers.docker=true

Sekarang port 80 aktif sebagai entrypoint web dan dashboard tersedia di port 8080. Flag --api.insecure=true membuat dashboard bisa diakses tanpa autentikasi — cukup untuk eksperimen, tetapi jangan pernah dipakai di produksi (kita amankan di episode 4 dan 28).

#Setup Docker Compose

#Compose File Pertama

Untuk series ini kita pakai Compose yang lebih terstruktur. Buat file docker-compose.yml di direktori ~/learn-traefik:

services:
  traefik:
    image: traefik:v3
    container_name: traefik
    restart: unless-stopped
    ports:
      - "80:80"
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./config/traefik.yml:/etc/traefik/traefik.yml:ro
    command:
      - --api.insecure=true
      - --entrypoints.web.address=:80
      - --providers.docker=true

Beberapa hal yang perlu diperhatikan:

• Mount Docker socket read-only (:ro) sebagai praktik keamanan.
• File ./config/traefik.yml di-mount ke /etc/traefik/traefik.yml.
• Semua container backend yang ingin dirutekan Traefik harus berada di network yang sama.

Buat file static configuration-nya dulu, lalu jalankan:

mkdir -p config
cat > config/traefik.yml <<'EOF'
api:
  dashboard: true
EOF
docker compose up -d
docker compose ps

#First Run dan Verifikasi

#Mengakses Dashboard

Jika berhasil, dashboard Traefik bisa dibuka di http://localhost:8080/dashboard/. Halaman ini menampilkan tiga tab penting: HTTP Routers, HTTP Services, dan Middlewares. Saat ini daftarnya kosong karena belum ada container dengan label Traefik — kondisi wajar untuk instalasi pertama.

#Memeriksa Log

Log container adalah jendela utama untuk memantau Traefik:

docker logs traefik
docker logs -f traefik

Log awal akan menampilkan banner Traefik, versi, dan pesan bahwa entrypoint web aktif mendengarkan di port 80. Jika ada kesalahan konfigurasi, error akan muncul di sini. Verifikasi cepat dengan curl untuk memastikan Traefik merespons:

curl -s -o /dev/null -w "%{http_code}\n" http://localhost:80

Traefik mengembalikan 404 untuk path yang tidak punya router — itu normal dan justru menandakan Traefik hidup dan menolak request yang tidak dikenal. Perintah curl ini akan menjadi teman debugging kalian sepanjang series.

#Penutup

Inti yang harus dibawa pulang:

• Metode utama: binary, Docker, Docker Compose, Kubernetes, dan package manager.
• Cara terbaik untuk belajar: Docker Compose dengan mount Docker socket read-only.
• Entrypoints harus didefinisikan lewat CLI flag atau file config agar routing aktif.
• Dashboard sementara terbuka via port 8080 dengan api.insecure=true.
• Log container dan curl adalah alat debugging utama.

Di episode 4 selanjutnya kita akan membahas static configuration secara menyeluruh — format YAML, TOML, CLI, dan environment variable, urutan prioritasnya, definisi entrypoints, pengaturan API & dashboard yang aman, serta konfigurasi log. Mulai dari sini kalian akan meninggalkan flag CLI dan beralih ke file konfigurasi yang rapi.