Belajar Microservices - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar Microservices! Series ini akan membawa kalian merancang, membangun, dan mengoperasikan aplikasi microservices secara nyata menggunakan studi kasus e-commerce tokokita — tujuh layanan (auth, product, cart, order, payment, notification, api-gateway) di atas TypeScript/Bun, PostgreSQL, Redis, dan Kafka. Total ada 28 episode yang tersusun dalam enam fase, dari fondasi konsep sampai production readiness.

Sebelum menulis kode pertama, ada skill dasar dan perangkat lunak yang wajib kalian siapkan. Mengapa prasyarat ini penting? Karena microservices pada dasarnya adalah distributed system: bukan satu aplikasi, melainkan banyak layanan kecil yang saling berbicara lewat jaringan. Tanpa dasar yang kuat, kalian akan tenggelam di laut log error dan masalah koneksi antar layanan.

Episode 0 ini adalah peta jalan kalian: kita akan memastikan skill dasar terpenuhi, menyiapkan seluruh tooling, dan memverifikasi environment untuk pertama kali.

#Skill Dasar yang Wajib Dimiliki

#REST API: Method, Status Code, dan JSON

Semua komunikasi antar layanan berbalut HTTP. Kalian wajib memahami method GET, POST, PUT, PATCH, DELETE; status code 200, 201, 400, 401, 404, 422, 500; serta format pertukaran data JSON. Series ini diasumsikan kalian sudah pernah menulis endpoint REST — baik di Laravel, Express, Elysia, atau framework lain.

#SQL Dasar: Schema, Migration, dan Join

Setiap layanan memakai PostgreSQL miliknya sendiri. Kalian wajib memahami konsep tabel, primary key, foreign key, index, dan migration — bagaimana mengubah schema tanpa merusak data. Jangan khawatir jika belum hafal semua sintaks SQL; yang penting paham model relasionalnya.

#Docker Dasar: Image, Container, Volume, dan Network

Docker adalah fondasi menjalankan microservices di local environment. Kalian perlu paham perbedaan image vs container, kenapa volume dibutuhkan agar data bertahan, dan bagaimana container saling bicara lewat network. Buat latihan cepat:

Jalankan container pertama

docker run --rm hello-world

Jika sudah pernah menjalankan perintah ini, dasar Docker kalian cukup untuk mengikuti series.

#Git & GitHub

Kerja di microservices berarti kerja tim antar-service. Kalian wajib paham git clone, git add, git commit, git push, git pull, dan dasar branching. Semua code di series ini diorganisasi dalam satu monorepo.

#Kesabaran Membaca Log Error

Ini skill yang paling sering diremehkan. Pada sistem terdistribusi, satu request bisa melewati 5-6 layanan dan menghasilkan belasan log. Kebiasaan membaca log secara sistematis — dari yang paling awal, bukan yang paling akhir — akan menyelamatkan kalian berkali-kali di series ini.

#Perangkat Software dan Tools yang Disiapkan

#Runtime: Bun (atau Node.js LTS)

Semua layanan ditulis dalam TypeScript dan dijalankan dengan Bun. Bun menyediakan runtime, bundler, test runner, dan package manager dalam satu binary.

Install Bun

curl -fsSL https://bun.sh/install | bash

Verifikasi dengan bun --version — pastikan minimal versi 1.2. Jika kalian tetap ingin pakai Node.js LTS, seluruh materi tetap bisa diikuti dengan sedikit penyesuaian, tapi series ini memakai fitur Bun-native (misalnya Bun.serve dan test runner bawaan).

#Docker + Docker Compose

Microservices butuh banyak komponen infrastruktur (database, cache, message broker). Semua itu akan dijalankan lewat Docker Compose agar reproducible di semua mesin.

Verifikasi Docker dan Compose

docker version
docker compose version

Docker Desktop (macOS/Windows) memuat Compose bawaan. Di Linux, install docker-compose-plugin sesuai distro. Harusnya docker compose version mencetak versi v2.x.

#PostgreSQL, Redis, dan Kafka/Redpanda

Saat masuk ke episode 3, kalian akan menjalankan tiga komponen ini lewat Compose:

PostgreSQL 16 — database utama per layanan.
Redis 7 — cache, session, dan rate-limit.
Kafka (Redpanda) — event bus untuk komunikasi asinkron.

Untuk saat ini cukup pastikan port 3000-3010, 5432, 6379, dan 9092 tidak dipakai service lain. Akses psql juga opsional tapi membantu. Di episode 3 kita akan menuliskannya di compose.yaml.

#Kubernetes Lokal (Opsional untuk Awal)

Fase 4 dan 5 membahas Kubernetes. Untuk saat ini opsional, tapi kalian bisa menyiapkan k3d atau kind lebih awal:

Jangan paksakan di episode 0 jika waktu terbatas — k3d baru benar-benar dipakai di episode 17.

#API Testing Tool

Untuk menguji endpoint antar layanan, pilih salah satu:

Bruno — API client open-source, ringan, mendukung koleksi yang tersimpan di repo.
Postman — paling populer, kaya fitur.
curl + jq — cukup untuk sebagian besar kasus di series ini.

Series ini akan memakai curl dan Bruno sebagai alat utama testing.

#Editor: VS Code dengan Ekstensi

VS Code adalah pilihan paling nyaman untuk TypeScript + Docker:

Bun (oven.bun-vscode) — integration runtime.
Docker — manage container, compose, dan images dari editor.
ESLint — linting otomatis.
YAML (redhat) — validasi sintaks compose.yaml.

#Verifikasi Environment

Sebelum lanjut ke episode 1, jalankan verifikasi menyeluruh:

Verifikasi seluruh environment

bun --version
docker version --format '{{.Server.Version}}'
docker compose version
git --version

Checklist lengkap yang harus terpenuhi:

Bun terinstall dan bun --version mencetak versi minimal 1.2.
Docker daemon berjalan dan Compose v2 tersedia.
Git tersedia untuk kolaborasi.
API testing tool siap dipakai (Bruno/Postman/curl).
Port 5432 (PG), 6379 (Redis), dan 9092 (Kafka) tidak konflik.

Tip

Jika environment kalian sebelumnya hanya untuk monolith satu layanan, perlu diingat: di microservices kalian akan menjalankan banyak proses sekaligus. Biasakan diri membedakan log per container sejak dini — misalnya menamai container secara eksplisit (docker compose ps) agar tidak bingung saat ada 6 service berjalan. Keterampilan ini akan dipakai terus di semua episode.

#Penutup

Episode 0 menyiapkan seluruh fondasi teknis sebelum membangun microservices: skill REST API, SQL dasar, Docker, Git, dan kebiasaan membaca log — ditambah tooling Bun, Docker Compose, PostgreSQL, Redis, Kafka, dan API client.

Inti yang harus dibawa pulang:

Skill wajib: REST API, SQL dasar, Docker, Git, dan membaca log secara sistematis.
Runtime utama series adalah Bun dengan TypeScript.
Environment dev berbasis Docker Compose (PostgreSQL, Redis, Kafka) — akan dibangun di episode 3.
Verifikasi semua tool sebelum melanjutkan; siapkan Kubernetes lokal hanya jika sempat.

Di episode 1 selanjutnya kita akan membahas sejarah, latar belakang, dan mengapa microservices — dari monolith, SOA, ledakan cloud & container pada 2014-2016, hingga modular monolith yang menjadi tren 2026. Pastikan environment kalian sudah siap, karena perjalanan Belajar Microservices baru saja dimulai!