Instruksi Dockerfile

Tabel perintah pada Chapter Perintah Docker CLI mengurus apa yang kita ketik di terminal, sedangkan Dockerfile mengurus apa yang dibawa oleh image itu sendiri — dan kosakata penulisan Dockerfile adalah tujuh belas instruksi yang sudah kita bedah satu per satu di Section Dockerfile dan dipakai intensif di Section Image Build dan Optimisasi. Chapter ini memampatkan seluruhnya menjadi satu tabel rujukan berkolom Instruksi, Bentuk, Fungsi, dan Contoh, lalu menambahkan tiga hal yang sering dicari saat menulis Dockerfile sungguhan: parser directive # syntax, flag modern pada COPY, ADD, dan RUN, serta perbedaan bentuk exec dan shell. Contoh pada setiap baris sengaja memakai image dan berkas yang akrab dengan kita — node:22-alpine, package.json, server.js — supaya tabel ini terbaca sebagai potongan Dockerfile yang nyata.

Tujuh Belas Instruksi #

Instruksi Dockerfile ditulis huruf kapital dan dibaca builder dari atas ke bawah; setiap instruksi RUN, COPY, dan ADD membentuk satu layer baru, sedangkan sisanya menempel sebagai metadata image — pembagian yang kita telaah pada Chapter Struktur Dockerfile. Tabel berikut adalah peta lengkap seluruh instruksi yang dikenal Dockerfile modern:

Satu instruksi pada tabel itu menyimpan empat nilai bawaan yang perlu kita ingat saat menulisnya tanpa opsi: HEALTHCHECK. Tanpa opsi tambahan, pemeriksaan berjalan dengan --interval=30s --timeout=30s --start-period=0s --retries=3 — artinya probe ditembakkan tiap 30 detik, diberi 30 detik untuk menjawab, tanpa masa tenggang startup, dan container baru dianggap unhealthy setelah tiga kegagalan beruntun. Mekanisme status healthy dan unhealthy yang lahir dari instruksi ini kita bedah tuntas pada Chapter HEALTHCHECK dan dipakai sebagai gerbang kesiapan di Compose.

Parser Directive #

Baris pertama sebuah Dockerfile dapat diisi directive yang menentukan frontend mana yang membaca berkas tersebut. Directive yang kita pakai sepanjang Course adalah # syntax:

# syntax=docker/dockerfile:1
FROM node:22-alpine

Mari kita telaah tiga hal penting dari blok tersebut:

1. docker/dockerfile:1 — nama image frontend BuildKit yang bertugas menerjemahkan Dockerfile; angka 1 adalah kanal stabil generasi pertama, yang selalu menunjuk rilis terbaru dari generasi itu.
2. Posisi wajib di baris pertama — komentar apa pun yang muncul di atasnya membuat directive ikut dibaca sebagai komentar biasa dan frontend yang diminta tidak pernah aktif, jebakan yang kita buktikan pada Chapter Struktur Dockerfile.
3. Buah pinning kanal stabil — fitur modern seperti heredoc, COPY --chmod, dan COPY --link tersedia tanpa perlu menunggu daemon diperbarui, karena frontend-nya diambil sebagai image dari registry.

Flag Modern pada COPY, ADD, dan RUN #

BuildKit tidak hanya membawa engine build yang lebih cepat — engine ini juga memperluas ketiga instruksi pembentuk layer dengan flag yang memecahkan masalah lama: kepemilikan berkas, izin, cache dependensi, dan rahasia build. Flag-flag berikut sudah kita praktikkan di Section Image Build dan Optimisasi; tabel-tabel ini mengumpulkannya menjadi satu pandangan.

Flag COPY #

Flag ADD #

Flag --checksum dipakai bersama digest penuh agar unduhan URL bisa diverifikasi — pola pinning dari Chapter Reproducible Build. Bentuk nyatanya terlihat seperti ini:

ADD --checksum=sha256:8f14e45fceea167a5a36dedd4bea2543f7a8c2b6e8f7c5d4a3b2c1d0e9f8a7b6 https://example.com/data.csv ./

Flag RUN #

Bentuk Exec dan Bentuk Shell #

Lima instruksi bisa ditulis dalam dua wujud — RUN, CMD, ENTRYPOINT, SHELL, dan COPY dalam konteks tertentu — dan pilihan wujud menentukan bagaimana perintah dieksekusi serta siapa yang menerima sinyal. Tabel berikut merangkum lima aspek perbedaannya, pemetaan lengkap dari Chapter CMD dan ENTRYPOINT:

Konsekuensi baris keempat adalah alasan memilih exec form untuk aplikasi produksi: docker stop mengirim SIGTERM ke PID 1, dan hanya bentuk exec yang menempatkan aplikasi kita pada posisi itu — dasar dari graceful shutdown yang kita praktikkan pada Chapter Graceful Shutdown, serta pembahasan proxy sinyal lewat init: true pada Chapter Container Init Process.

Tujuh belas instruksi dan flag modernnya kini terhimpun dalam satu chapter. Tetapi Dockerfile hanya mengurus satu image — begitu aplikasi kita membutuhkan web server, database, dan cache yang saling terhubung, konfigurasi berpindah ke compose.yaml dengan kosakata kuncinya sendiri. Chapter berikutnya, Kunci compose.yaml, menyusun kunci-kunci tersebut menjadi tabel rujukan dengan tipe nilai dan fungsinya.

Referensi #

• Dockerfile reference — sintaks resmi seluruh instruksi beserta flag BuildKit.
• Best practices untuk Dockerfile — panduan gaya penulisan Dockerfile yang sehat.
• BuildKit — mesin di balik flag modern RUN --mount dan COPY --link.