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).
docker history nginx:alpine # menampilkan tiap lapisan, perintah pembuatnya, dan ukurannya docker image inspect nginx:alpine | head -40
- Lapisan dibagikan: 10 container dari image yang sama = lapisan dasar hanya disimpan sekali di disk.
- Cache build: saat membangun image, lapisan yang tidak berubah tidak dibangun ulang โ kunci kecepatan build ada di urutan penulisan Dockerfile (Bab 5).
- Image resmi (official) di Docker Hub โ nginx, mariadb, wordpress, dst. โ dikelola pembuat perangkat lunaknya atau tim Docker. Selalu utamakan image resmi daripada image acak buatan perorangan.
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:
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
FROM nginx:alpine COPY index.html /usr/share/nginx/html/index.html EXPOSE 80 CMD ["nginx", "-g", "daemon off;"]
| Instruksi | Makna |
|---|---|
FROM | Image dasar yang diwarisi โ selalu baris pertama. Kita memakai nginx:alpine yang sudah berisi web server |
COPY | Menyalin berkas dari folder proyek (host) ke dalam image |
EXPOSE | Dokumentasi port yang dipakai aplikasi (tidak otomatis membuka port โ tetap perlu -p) |
CMD | Perintah bawaan yang dijalankan saat container menyala |
Bab 3 โ Build & Menjalankan Image Sendiri
Dari folder web-kelas yang berisi Dockerfile, jalankan:
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
- Titik (
.) di akhir adalah konteks build: folder yang isinya boleh diakses Dockerfile. - Ubah isi index.html, lalu bangun lagi sebagai
web-kelas:v2. Dua versi kini hidup berdampingan โ inilah cara rilis yang aman: versi lama tetap ada bila versi baru bermasalah. - Nama container dan nama image itu berbeda hal: satu image
web-kelas:v1boleh dijalankan menjadi banyak container.
docker build -t web-kelas:v2 . docker stop webkelas && docker rm webkelas docker run -d --name webkelas -p 8080:80 web-kelas:v2
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:
FROM alpine ENTRYPOINT ["echo"] CMD ["halo"]
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:
FROM alpine ENV NAMA_SEKOLAH="SMKN 7 Samarinda" CMD ["sh", "-c", "echo Selamat datang di $NAMA_SEKOLAH"]
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
- ENV โ tertanam di image dan tetap ada saat container berjalan; bisa ditimpa dengan
-esaat run. Dipakai untuk konfigurasi: nama database, zona waktu, mode aplikasi. - ARG โ hanya berlaku saat build (
docker build --build-arg VERSI=2), tidak ikut ke container. Dipakai untuk memilih versi saat membangun. - Kata sandi jangan dimasukkan sebagai ENV di Dockerfile โ akan terbaca semua orang lewat
docker history/inspect. Kata sandi diberikan saat run/compose (Fase 4 membahas berkas.env).
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:
# 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:
.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:
# ---- 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
- Hasil akhir umumnya menyusut dari ยฑ1 GB menjadi ยฑ55 MB.
- Image produksi tidak membawa kode sumber mentah, perkakas build, dan dependensi pengembangan โ permukaan serangan lebih kecil.
- Pola yang sama dipakai untuk Go, Java, dan bahasa terkompilasi lain: kompilasi di tahap build, jalankan biner kecil di tahap akhir (sering berbasis
alpineatauscratch).
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)
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:
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
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
- โ
Berbasis image resmi dan versi pasti (
nginx:1.27-alpine), bukanlatesttanpa cadangan. - โ
Sekecil yang masuk akal: varian
alpine/slim, multi-stage bila ada tahap build. - โ Satu container = satu tugas utama (web saja, database saja) โ bukan satu container berisi semuanya.
- โ
Ada
.dockerignore; tidak ada kata sandi/berkas.envdi dalam image. - โ Urutan instruksi ramah cache: dependensi sebelum kode.
๐ฏ Proyek Fase 2 โ Image Web Profil Kelas
- Buat halaman web profil kelas (HTML sederhana: nama kelas, wali kelas, daftar piket โ bebas berkreasi) sebagai
index.html. - Tulis Dockerfile dari
nginx:alpineyang menyalin halaman itu, lengkap denganEXPOSEdan.dockerignore. - Bangun dua versi:
web-profil:v1dan (setelah satu perbaikan tampilan)web-profil:v2. - Dorong
v1ke registry lokal (Bab 7) dan buktikan server/teman lain dapatpulldari sana. - Laporan: tampilkan
docker historyimage 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.
โ 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.