Fase 2 โ€” Image & Dockerfile

Berhenti memakai image mentah: pahami anatomi layer, tulis Dockerfile, bangun image sendiri, kelola versi, dan distribusikan lewat Docker Hub atau registry lokal.

๐Ÿงฑ Layer & cache๐Ÿ“ Dockerfile๐Ÿ—๏ธ Multi-stage build๐ŸŽฏ Proyek: image web profil

Bab 1 โ€” Anatomi Image: Lapisan di Atas Lapisan

Image bukan satu berkas besar, melainkan tumpukan lapisan (layer) read-only. Setiap langkah pembuatan image menambah satu lapisan: sistem dasar, library, aplikasi, konfigurasi. Saat container berjalan, Docker menambahkan satu lapisan tipis yang bisa ditulis di paling atas โ€” semua perubahan selama container hidup tersimpan di sana dan hilang saat container dihapus (ingat baik-baik; ini alasan kita butuh volume di Fase 3).

TERMINAL
docker history nginx:alpine
# menampilkan tiap lapisan, perintah pembuatnya, dan ukurannya
docker image inspect nginx:alpine | head -40
๐Ÿ’ก Nama vs identitasSatu image ditandai nama:tag, tetapi identitas sejatinya adalah digest (sha256:...). Tag bisa dipindah ke image lain; digest tidak. Untuk kebutuhan belajar, tag versi yang jelas sudah cukup.

Bab 2 โ€” Dockerfile Dasar: FROM, COPY, CMD

Sekarang kita membuat image sendiri: web server berisi halaman profil kelas. Buat folder kerja dan dua berkas berikut:

TERMINAL โ€” berkas halaman web
mkdir web-kelas && cd web-kelas
cat > index.html <<'EOF'
<h1>Selamat datang di Web Kelas XI TJKT</h1>
<p>Image Docker pertama kami.</p>
EOF
DOCKERFILE
FROM nginx:alpine
COPY index.html /usr/share/nginx/html/index.html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]
InstruksiMakna
FROMImage dasar yang diwarisi โ€” selalu baris pertama. Kita memakai nginx:alpine yang sudah berisi web server
COPYMenyalin berkas dari folder proyek (host) ke dalam image
EXPOSEDokumentasi port yang dipakai aplikasi (tidak otomatis membuka port โ€” tetap perlu -p)
CMDPerintah bawaan yang dijalankan saat container menyala
๐Ÿง  Cara membaca DockerfileDockerfile dibaca dari atas ke bawah, satu instruksi = satu lapisan. Karena kita hanya mengganti halaman bawaan nginx, image kita praktis hanya menambah satu lapisan tipis di atas nginx:alpine โ€” build-nya nyaris seketika.

Bab 3 โ€” Build & Menjalankan Image Sendiri

Dari folder web-kelas yang berisi Dockerfile, jalankan:

TERMINAL
docker build -t web-kelas:v1 .
docker images
docker run -d --name webkelas -p 8080:80 web-kelas:v1
# buka http://IP-VM:8080 โ€” halaman profil kelas tampil
TERMINAL
docker build -t web-kelas:v2 .
docker stop webkelas && docker rm webkelas
docker run -d --name webkelas -p 8080:80 web-kelas:v2
๐Ÿ“Œ Penamaan versiMenamai versi dengan v1, v2, dst. memang sederhana, tetapi cukup untuk belajar. Di perusahaan, tag biasanya mengikuti versi aplikasi (mis. 1.4.2) atau nomor build dari CI/CD (Fase 5). Yang terlarang untuk produksi hanyalah mengandalkan latest tanpa versi cadangan.

Bab 4 โ€” CMD vs ENTRYPOINT, ENV & ARG

Tiga instruksi ini sering membingungkan pemula. Kita bedah dengan image mainan berbasis alpine:

DOCKERFILE โ€” contoh echo
FROM alpine
ENTRYPOINT ["echo"]
CMD ["halo"]
TERMINAL
docker build -t alat-echo .
docker run alat-echo            # mencetak: halo
docker run alat-echo dunia      # mencetak: dunia
# CMD adalah nilai bawaan; argumen saat run MENIMPANYA.
# ENTRYPOINT adalah perintah tetap yang selalu dijalankan.

Berikutnya variabel lingkungan (ENV) โ€” cara baku memberi konfigurasi ke aplikasi tanpa mengubah image:

DOCKERFILE โ€” contoh ENV
FROM alpine
ENV NAMA_SEKOLAH="SMKN 7 Samarinda"
CMD ["sh", "-c", "echo Selamat datang di $NAMA_SEKOLAH"]
TERMINAL
docker build -t alat-sapa .
docker run alat-sapa                        # Selamat datang di SMKN 7 Samarinda
docker run -e NAMA_SEKOLAH="SMK Lain" alat-sapa   # nilai ENV ditimpa dari luar

Bab 5 โ€” Cache Build & Berkas .dockerignore

Mengapa build kedua sering jauh lebih cepat? Karena Docker memakai cache lapisan: instruksi yang berkas masukannya tidak berubah memakai hasil lama. Konsekuensinya adalah aturan emas penulisan Dockerfile:

๐Ÿ“Œ Aturan emasSusun instruksi dari yang paling jarang berubah ke yang paling sering berubah. Salin berkas daftar dependensi dulu, instal, baru salin kode aplikasi. Bila kode disalin lebih dulu, setiap perubahan kecil kode membatalkan cache instalasi dependensi yang lama.
DOCKERFILE โ€” urutan ramah cache
# pola baik untuk aplikasi Node.js
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["node", "server.js"]

Pasangan wajibnya adalah .dockerignore โ€” daftar berkas yang tidak boleh masuk konteks build. Tanpa berkas ini, folder seperti node_modules (ratusan MB) dan .git ikut terkirim setiap build dan bisa menimpa isi image:

BERKAS .dockerignore
.git
node_modules
*.log
.env
Dockerfile
docker-compose.yml

Ukur perbedaannya sendiri: bangun image contoh Bab ini sebelum dan sesudah membuat .dockerignore pada folder yang berisi folder besar, lalu bandingkan waktu build dan ukuran konteks yang tertera di keluaran docker build.

Bab 6 โ€” Multi-Stage Build: Image Kecil, Aman, Cepat

Aplikasi web modern (React, Vue, dsb.) dibangun dengan perkakas berat (Node.js ยฑ1 GB) tetapi hasil akhirnya hanya berkas statis kecil. Bodoh rasanya mengirim perkakas seberat itu ke server. Solusinya multi-stage build: tahap pertama membangun, tahap terakhir hanya membawa hasil:

DOCKERFILE โ€” multi-stage
# ---- tahap 1: membangun aplikasi ----
FROM node:20-alpine AS build
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build

# ---- tahap 2: hanya hasil jadi + nginx ----
FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html
EXPOSE 80
๐Ÿง  PrinsipSimulator di akhir fase ini memvisualkan perbedaan ukurannya. Ingat prinsipnya: yang dikirim ke server hanyalah yang dibutuhkan aplikasi untuk berjalan โ€” bukan yang dibutuhkannya untuk dibangun.

Bab 7 โ€” Tag, Push ke Docker Hub & Registry Lokal

Image yang sudah bagus harus bisa dipindah ke server lain. Ada dua gudang tujuan:

A. Docker Hub (publik, untuk image yang boleh dibagikan)

TERMINAL
docker login                          # masuk dengan akun Docker Hub
docker tag web-kelas:v1 ardian/web-kelas:v1
docker push ardian/web-kelas:v1
# di server lain cukup: docker pull ardian/web-kelas:v1

B. Registry lokal (privat, untuk jaringan sekolah/perusahaan)

Registry resmi Docker sendiri adalah sebuah container! Jalankan sekali, pakai selamanya:

TERMINAL
docker run -d --name registry -p 5000:5000 --restart=always registry:2
docker tag web-kelas:v1 localhost:5000/web-kelas:v1
docker push localhost:5000/web-kelas:v1
curl http://localhost:5000/v2/web-kelas/tags/list
๐Ÿ’ก Jembatan ke Fase 3Menjalankan registry tanpa volume berarti daftar image hilang bila container registry dihapus โ€” tahan dulu rasa penasaran itu: memperbaikinya adalah pekerjaan pertama Fase 3 (Volume). Untuk sekarang, registry lokal cukup untuk membuktikan alur tag โ†’ push โ†’ pull berjalan.

Pilih gudang dengan sadar: kode berisi konfigurasi internal perusahaan tidak boleh didorong ke repositori publik. Di sinilah registry privat perusahaan berperan (Fase 5 menyinggung Harbor, registry privat yang lebih lengkap).

Bab 8 โ€” Praktik Baik Image + Proyek Fase 2

Checklist image yang layak produksi

๐ŸŽฏ Proyek Fase 2 โ€” Image Web Profil Kelas

  1. Buat halaman web profil kelas (HTML sederhana: nama kelas, wali kelas, daftar piket โ€” bebas berkreasi) sebagai index.html.
  2. Tulis Dockerfile dari nginx:alpine yang menyalin halaman itu, lengkap dengan EXPOSE dan .dockerignore.
  3. Bangun dua versi: web-profil:v1 dan (setelah satu perbaikan tampilan) web-profil:v2.
  4. Dorong v1 ke registry lokal (Bab 7) dan buktikan server/teman lain dapat pull dari sana.
  5. Laporan: tampilkan docker history image kamu dan jelaskan lapisan mana yang berasal dari Dockerfile-mu.

Kriteria tuntas: image berjalan di port 8080 dengan halaman profil tampil, ukuran image di bawah 80 MB, dan proses push/pull ke registry lokal terbukti berhasil.

๐Ÿงช Simulasi Interaktif โ€” Perancang Ukuran Image

Rakit kombinasi image dasar, isi, .dockerignore, dan multi-stage โ€” lalu lihat langsung dampaknya ke ukuran image akhir dan penilaian kualitasnya.

Rakit sebuah image dan lihat bagaimana pilihanmu memengaruhi ukuran akhir dan perilaku cache. Angka adalah perkiraan realistis untuk belajar menimbang, bukan hasil ukur resmi.




โ€“perkiraan ukuran image akhir
โ€“penilaian

โœ… Penutup Fase

Kamu kini bisa membaca dan menulis Dockerfile, membangun image berversi, menjaga ukurannya tetap ramping, dan mendistribusikannya. Tetapi ada satu kelemahan container yang belum kita atasi: data di dalam container hilang saat container dihapus, dan container-container kita belum saling berbicara. Fase 3 menyelesaikan keduanya dengan Volume dan Network โ€” fondasi semua layanan perusahaan.

Lompat ke fase lain