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 ComposeDengan Compose
Perintah panjang, dicatat entah di manaBerkas compose.yaml โ€” sekaligus dokumentasi & resep resmi stack
Urutan menyalakan manual (db dulu, baru web)depends_on mengatur urutan otomatis
Membuat ulang stack = mengetik ulang semuanyadocker compose up -d โ€” selesai
Sulit dibagikan ke timBerkas dapat disimpan di Git, ditinjau, dan dipakai ulang di server mana pun
TERMINAL
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:

ANATOMI compose.yaml
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:

compose.yaml โ€” versi pertama
services:
  web:
    build: .
    image: web-kelas:v1
    container_name: webkelas
    ports:
      - "8080:80"
    restart: unless-stopped
TERMINAL
docker 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
๐Ÿ’ก Ejaan modernNama berkas memang 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.

compose.yaml โ€” stack tiga layanan
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:
  1. Simpan di folder proyek (bersama Dockerfile web), jalankan docker compose up -d.
  2. Buka http://IP-VM:8080 (web kelas) dan http://IP-VM:8081 (phpMyAdmin โ€” masuk dengan user root / kata sandi sesuai berkas).
  3. Amati keajaiban yang tidak dinyatakan eksplisit: Compose otomatis membuat jaringan khusus untuk stack ini, sehingga admin menemukan db cukup dengan namanya โ€” persis pelajaran Fase 3, tanpa satu pun perintah network.
  4. Di phpMyAdmin, buat tabel contoh di database sekolah. Lalu docker compose down dan up -d lagi โ€” tabelmu harus tetap ada (volume dbdata).
โš ๏ธ Alat lab โ‰  pola produksiphpMyAdmin memudahkan belajar database, tetapi di server produksi ia termasuk layanan sensitif: banyak perusahaan tidak memasangnya sama sekali di server publik, atau membatasinya hanya dari jaringan kantor/VPN. Perlakukan port 8081 ini sebagai alat lab, bukan pola publik.

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
# berkas .env (TIDAK dibagikan, TIDAK masuk Git)
DB_ROOT_PASSWORD=Latihan#2026-SulitDitebak
DB_NAME=sekolah
compose.yaml โ€” memakai variabel
services:
  db:
    image: mariadb:11.4
    environment:
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      MARIADB_DATABASE: ${DB_NAME}
TERMINAL
echo ".env" >> .gitignore     # cegah .env terunggah ke Git
docker compose config          # tampilkan hasil akhir penggabungan (cek variabel terisi)

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.

compose.yaml โ€” tambahan layanan Portainer
portainer:
    image: portainer/portainer-ce:latest
    ports:
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    restart: unless-stopped
โš ๏ธ Kendali penuh = tanggung jawab penuhPortainer dipasang dengan memasang soket Docker (/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.

compose.yaml โ€” tambahan layanan Uptime Kuma
kuma:
    image: louislam/uptime-kuma:1
    ports:
      - "3001:3001"
    volumes:
      - kuma_data:/app/data
    restart: unless-stopped

Setelah 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).

compose.yaml โ€” tambahan layanan Gitea
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
  1. Buka http://IP-VM:3000, selesaikan pemasangan awal (untuk lab, database bawaan SQLite sudah cukup), buat akun admin.
  2. Buat repositori bernama modul-docker dan unggah berkas-berkas latihanmu (Dockerfile, compose.yaml) ke sana.
  3. 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

TERMINAL
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

TERMINAL
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.

โš ๏ธ Disiplin updateSatu hal yang wajib dilatih sampai refleks: sebelum update apa pun pada stack yang datanya penting, cadangkan volumenya dengan pola tar dari Fase 3 Bab 4. Update tanpa cadangan bukan keberanian โ€” itu kecerobohan.

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

  1. web โ€” image web-kelas hasil build Dockerfile-mu sendiri (port 8080).
  2. db โ€” MariaDB 11.4 dengan volume bernama dan kata sandi dari .env.
  3. admin โ€” phpMyAdmin yang terhubung ke db (port 8081).
  4. kuma โ€” Uptime Kuma (port 3001) yang benar-benar memantau web dan menampilkan status hijau.
  5. portainer โ€” panel pengelola (port 9443) yang dapat dibuka dan menampilkan seluruh stack.

Ketentuan

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.






compose.yaml โ€” hasil susunanmu
# 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.

Lompat ke fase lain