Fase 4 โ Docker Compose & Layanan Perusahaan
Satu berkas, satu perintah, seluruh stack menyala. Kuasai Compose, kelola rahasia dengan .env, dan pasang layanan yang nyata dipakai perusahaan: Portainer, Uptime Kuma, dan Gitea.
๐งฉ compose.yaml๐ Berkas .env๐ฅ๏ธ Portainer๐ Uptime Kuma๐ฏ Proyek: paket kantor kecil
Bab 1 โ Kenapa Docker Compose: Dari Perintah Panjang ke Satu Berkas
Ingat perintah dua container di Fase 3 Bab 7? Hampir 20 baris bendera (-e, -v, --network) yang harus diketik sempurna setiap kali. Satu huruf salah, stack rusak. Docker Compose menggantinya dengan satu berkas teks yang mendeskripsikan seluruh layanan:
| Tanpa Compose | Dengan Compose |
|---|---|
| Perintah panjang, dicatat entah di mana | Berkas compose.yaml โ sekaligus dokumentasi & resep resmi stack |
| Urutan menyalakan manual (db dulu, baru web) | depends_on mengatur urutan otomatis |
| Membuat ulang stack = mengetik ulang semuanya | docker compose up -d โ selesai |
| Sulit dibagikan ke tim | Berkas dapat disimpan di Git, ditinjau, dan dipakai ulang di server mana pun |
docker compose version # nama berkas baku: compose.yaml (nama lama docker-compose.yml juga masih diterima)
Struktur berkasnya selalu berpola sama โ kenali lima kata kuncinya sejak sekarang:
services: # daftar layanan (container) yang membentuk stack
nama-layanan:
image: ... # atau build: untuk membangun dari Dockerfile
ports: ... # pemetaan port
environment: ... # variabel konfigurasi
volumes: ... # volume / bind mount
depends_on: ... # urutan menyalakan
volumes: # volume bernama yang dipakai stack
networks: # jaringan buatan sendiri (bila perlu dinyatakan)Bab 2 โ Compose Pertama: Web Server Kita, Cara Baru
Mari ubah praktik Fase 1โ2 menjadi Compose. Di folder web-kelas yang sudah berisi Dockerfile, buat berkas compose.yaml:
services:
web:
build: .
image: web-kelas:v1
container_name: webkelas
ports:
- "8080:80"
restart: unless-stoppeddocker compose up -d # bangun (bila perlu) + jalankan semua layanan docker compose ps # status layanan pada stack ini docker compose logs # log semua layanan (atau: logs web) docker compose down # hentikan + hapus container & jaringan stack ini
- Indentasi adalah nyawa YAML โ gunakan spasi (bukan Tab), dan sejajarkan dengan teliti. 90% error Compose pemula adalah salah indentasi.
restart: unless-stoppedmembuat container hidup lagi otomatis setelah VM restart, kecuali pernah kamu hentikan manual (dibahas penuh di Fase 5).docker compose downtidak menghapus volume bernama โ data aman. Barulahdown -vmenghapus volume juga: perintah ini setara membuang database, gunakan dengan sadar penuh.
compose.yaml, tetapi perintahnya tetap docker compose (dengan spasi) karena Compose kini adalah plugin Docker, bukan program terpisah seperti dulu (docker-compose bertanda hubung).Bab 3 โ Stack Lengkap: Web + Database + phpMyAdmin
Sekarang stack tiga layanan yang menjadi pola dasar sangat banyak sistem perusahaan: aplikasi web, database, dan alat administrasi database berbasis web.
services:
web:
build: .
image: web-kelas:v1
ports:
- "8080:80"
depends_on:
- db
restart: unless-stopped
db:
image: mariadb:11.4
environment:
MARIADB_ROOT_PASSWORD: latihan123
MARIADB_DATABASE: sekolah
volumes:
- dbdata:/var/lib/mysql
restart: unless-stopped
admin:
image: phpmyadmin:5.2
environment:
PMA_HOST: db
ports:
- "8081:80"
depends_on:
- db
restart: unless-stopped
volumes:
dbdata:- Simpan di folder proyek (bersama Dockerfile web), jalankan
docker compose up -d. - Buka
http://IP-VM:8080(web kelas) danhttp://IP-VM:8081(phpMyAdmin โ masuk dengan userroot/ kata sandi sesuai berkas). - Amati keajaiban yang tidak dinyatakan eksplisit: Compose otomatis membuat jaringan khusus untuk stack ini, sehingga
adminmenemukandbcukup dengan namanya โ persis pelajaran Fase 3, tanpa satu pun perintah network. - Di phpMyAdmin, buat tabel contoh di database
sekolah. Laludocker compose downdanup -dlagi โ tabelmu harus tetap ada (volumedbdata).
Bab 4 โ Berkas .env: Memisahkan Rahasia dari Resep
Kata sandi yang tertulis langsung di compose.yaml adalah masalah: berkas itu akan dibagikan, disimpan di Git, dan difoto untuk laporan. Solusi standarnya: pindahkan nilai rahasia & konfigurasi ke berkas .env di folder yang sama:
# berkas .env (TIDAK dibagikan, TIDAK masuk Git) DB_ROOT_PASSWORD=Latihan#2026-SulitDitebak DB_NAME=sekolah
services:
db:
image: mariadb:11.4
environment:
MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
MARIADB_DATABASE: ${DB_NAME}echo ".env" >> .gitignore # cegah .env terunggah ke Git docker compose config # tampilkan hasil akhir penggabungan (cek variabel terisi)
docker compose configadalah alat periksa terbaik sebelumup: ia memvalidasi sintaks dan menunjukkan wujud akhir konfigurasi. Hati-hati, keluaran perintah ini menampilkan kata sandi hasil gabungan โ jangan difoto untuk laporan.- Sediakan juga
.env.exampleberisi nama variabel tanpa nilai asli, agar anggota tim tahu variabel apa saja yang harus mereka isi sendiri. - Pola pikirnya:
compose.yaml= resep (boleh dibagikan),.env= bumbu rahasia tiap dapur (tiap server boleh berbeda nilainya).
Bab 5 โ Layanan Perusahaan #1: Portainer & Uptime Kuma
Dua layanan ini hampir selalu termasuk yang pertama dipasang perusahaan kecil-menengah di server Docker mereka.
Portainer โ panel visual pengelola Docker
Semua yang kamu lakukan lewat terminal (container, image, volume, network) dapat dilihat dan dikelola lewat antarmuka web. Sangat membantu tim dan presentasi ke pimpinan.
portainer:
image: portainer/portainer-ce:latest
ports:
- "9443:9443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- portainer_data:/data
restart: unless-stopped/var/run/docker.sock) ke dalam container. Itu berarti Portainer memegang kendali setara root atas Docker. Kuat dan praktis โ tetapi panelnya tidak boleh dibuka sembarangan ke internet; perlakukan seperti panel Barepod di modul sebelumnya: batasi dari jaringan lokal/VPN.Uptime Kuma โ pemantau layanan 24 jam
Memantau web/database/aplikasi dan memberi tahu (Telegram, surel, dsb.) bila ada yang mati โ jauh sebelum pengguna melapor.
kuma:
image: louislam/uptime-kuma:1
ports:
- "3001:3001"
volumes:
- kuma_data:/app/data
restart: unless-stoppedSetelah up -d, buka http://IP-VM:3001, buat akun admin, lalu tambahkan monitor HTTP untuk web kelasmu (port 8080). Di Fase 6, Uptime Kuma menjadi bagian dari proyek akhir โ dan di dunia nyata, dialah yang membangunkan teknisi pukul 3 pagi.
Bab 6 โ Layanan Perusahaan #2: Gitea, Git Server Ringan Milik Sendiri
Perusahaan menyimpan kode dan berkas konfigurasi pada server Git. GitHub memang populer, tetapi banyak kantor memilih server Git sendiri demi kerahasiaan dan kemandirian โ dan pilihan ringannya adalah Gitea: satu container, fitur lengkap (repositori, isu, pull request, wiki).
gitea:
image: gitea/gitea:1.22
environment:
USER_UID: "1000"
USER_GID: "1000"
ports:
- "3000:3000"
- "222:22"
volumes:
- gitea_data:/data
restart: unless-stopped- Buka
http://IP-VM:3000, selesaikan pemasangan awal (untuk lab, database bawaan SQLite sudah cukup), buat akun admin. - Buat repositori bernama
modul-dockerdan unggah berkas-berkas latihanmu (Dockerfile, compose.yaml) ke sana. - Mulai sekarang, setiap proyek fase disimpan di Gitea kelas โ inilah awal kebiasaan version control seorang teknisi.
Layanan populer lain yang berpola sama persis (web + database + volume) dan layak kamu kenal namanya: Nextcloud (penyimpanan & kolaborasi berkas seperti Google Drive milik sendiri), BookStack (wiki dokumentasi kantor), dan Vaultwarden (pengelola kata sandi tim). Semua dapat dijalankan dengan pola Compose bab ini โ proyek fase memberi ruang untuk membuktikannya.
Bab 7 โ Mengelola Stack Sehari-hari: Update, Log, Skala
Memperbarui layanan dengan aman
docker compose pull # unduh image versi terbaru sesuai tag di berkas docker compose up -d # layanan yang image-nya berubah dibuat ulang, yang lain dibiarkan docker image prune # bersihkan image lama yang tidak terpakai
Karena tag kita versi pasti (mis. mariadb:11.4), memperbarui berarti mengganti nomor versi di compose.yaml secara sadar, membaca catatan rilis, mencadangkan volume database, barulah pull + up -d. Inilah disiplin update perusahaan โ bukan asal terbaru.
Log & masuk ke layanan
docker compose logs -f db # ikuti log satu layanan docker compose exec db mariadb -uroot -p # masuk ke layanan yang berjalan docker compose ps # siapa sehat, siapa bermasalah
Menambah replika (konsep skala)
Untuk layanan web yang tidak menyimpan data di dalam container-nya (stateless), Compose dapat menjalankan beberapa salinan sekaligus: docker compose up -d --scale web=3. Syaratnya: jangan mengunci container_name dan jangan memetakan port host yang sama untuk semua replika (gunakan penyeimbang beban di depannya โ disinggung di Fase 6). Database tidak diskalakan semudah ini; jangan pernah men-scale layanan database dengan perintah tersebut.
Bab 8 โ Proyek Fase 4 โ Paket Layanan Kantor Kecil
Misi: dalam SATU berkas compose.yaml, hadirkan paket layanan sebuah kantor kecil, lengkap dengan rahasia yang dikelola benar.
Isi stack yang wajib ada
- web โ image web-kelas hasil build Dockerfile-mu sendiri (port 8080).
- db โ MariaDB 11.4 dengan volume bernama dan kata sandi dari
.env. - admin โ phpMyAdmin yang terhubung ke db (port 8081).
- kuma โ Uptime Kuma (port 3001) yang benar-benar memantau web dan menampilkan status hijau.
- portainer โ panel pengelola (port 9443) yang dapat dibuka dan menampilkan seluruh stack.
Ketentuan
- Tidak ada kata sandi tertulis langsung di
compose.yamlโ semuanya dari.env, dan.envtidak ikut diunggah ke Gitea (sediakan.env.example). - Semua layanan memakai
restart: unless-stopped. - Uji akhir:
docker compose downlaluup -dโ semua layanan kembali dan data db (buat satu tabel bukti) tetap ada. - Unggah
compose.yaml, Dockerfile, dan.env.exampleke repositori Gitea kelasmu.
Kriteria tuntas: kelima layanan tampil sehat di Portainer, monitor Kuma hijau, dan stack dapat dimatikan-dihidupkan ulang tanpa kehilangan data. Fase berikutnya membuat stack seperti ini layak produksi: Fase 5 โ keamanan, batas sumber daya, healthcheck, backup terjadwal, dan CI/CD.
๐งช Simulasi Interaktif โ Penyusun compose.yaml Otomatis
Pilih layanan yang ingin dipasang dan saksikan berkas compose.yaml tersusun sendiri โ lengkap dengan depends_on dan daftar volume yang menyesuaikan pilihanmu.
Centang layanan yang ingin dipasang, lalu tekan tombolnya โ berkas compose.yaml tersusun otomatis persis pola Bab 3โ6 fase ini. Perhatikan bagaimana volumes di bagian bawah menyesuaikan diri dengan layanan yang dipilih.
# centang layanan, lalu tekan "Susun compose.yaml"
โ Penutup Fase
Kamu sekarang dapat menghadirkan paket layanan kantor kecil dalam satu berkas Compose โ keterampilan yang benar-benar dicari perusahaan. Tetapi stack yang jalan belum tentu stack yang aman dan tahan banting. Fase 5 menaikkan kelasnya: keamanan container, batas sumber daya, healthcheck, backup terjadwal, dan pengiriman otomatis dengan CI/CD.