Penjelasan Docker ENTRYPOINT: Penggunaan, Sintaks, dan Praktik Terbaik

Docker ENTRYPOINT adalah instruksi Dockerfile yang mendefinisikan dan mengendalikan perintah bawaan yang dijalankan setiap kali kontainer Anda dimulai. Menguasai ENTRYPOINT memudahkan pengembangan kontainer yang dapat diprediksi, dapat direproduksi, dan mudah dipelihara yang berperilaku sesuai harapan. 

Panduan ini bertujuan membantu insinyur DevOps tingkat menengah, pengembang backend, dan insinyur perangkat lunak menggunakan ENTRYPOINT dengan percaya diri dan menghindari jebakan umum.

Jika Anda baru mengenal Docker, lihat pengantar kami ke tutorial Docker, karena tutorial ini mengasumsikan Anda sudah memahami Docker pada tingkat tertentu. Untuk praktik langsung dengan Docker, lihat kursus Introduction to Docker kami. 

Apa itu Docker ENTRYPOINT?

ENTRYPOINT mendefinisikan perintah yang dijalankan secara bawaan setiap kali kontainer Docker Anda diluncurkan. Tidak seperti menggunakan CMD, instruksi ENTRYPOINT memastikan konsistensi dengan menyediakan perintah yang berjalan setiap kali kontainer dimulai.

Bagaimana cara kerja Docker ENTRYPOINT?

ENTRYPOINT dalam sebuah Dockerfile mendefinisikan perintah utama yang selalu berjalan saat Anda memulai kontainer dari sebuah image. Ini seperti mengatakan: “Apa pun argumen yang diberikan pengguna saat menjalankan kontainer ini, selalu mulai dengan perintah ini.”

Kami membahas lebih detail tentang Dockerfile dalam tutorial Cara Mengkontainerkan Aplikasi Menggunakan Docker. 

Contohnya, dalam sebuah Dockerfile:

ENTRYPOINT ["python", "app.py"]Didukung oleh

Sekarang, saat Anda menjalankan:

docker run myimageDidukung oleh

Itu akan selalu mengeksekusi:

python app.pyDidukung oleh

Berikut adalah diagram alur bagaimana ENTRYPOINT bekerja:

+---------------------------+

|       Dockerfile          |

+---------------------------+

|                           |

|  ENTRYPOINT ["app"]       |

|  CMD ["--default-arg"]    |

+---------------------------+

             |

             v

+---------------------------+

|   Build Docker Image      |

+---------------------------+

             |

             v

+---------------------------+

|    Run Container          |

|   (docker run image)      |

+---------------------------+

             |

             v

+---------------------------+

| Executed Command:         |

|   app --default-arg       |

+---------------------------+

Override CMD at Runtime:

(docker run image --custom-arg)

             |

             v

+---------------------------+

| Executed Command:         |

|   app --custom-arg        |

+---------------------------+

Override ENTRYPOINT at Runtime:

(docker run --entrypoint /bin/bash image)

             |

             v

+---------------------------+

| Executed Command:         |

|   /bin/bash               |

+---------------------------+Didukung oleh

Dasar-Dasar Docker ENTRYPOINT

Memahami dasar-dasarnya akan sangat meningkatkan kepercayaan diri Anda dalam menggunakan ENTRYPOINT secara efektif.

Kerangka konsep

ENTRYPOINT menentukan executable atau skrip yang berjalan secara otomatis saat kontainer Anda dimulai. Inilah proses utama kontainer Anda, yang mengarahkan perilaku kontainer secara dapat diprediksi.

Sintaks inti

Sintaks Dockerfile untuk ENTRYPOINT sederhana dan biasanya digunakan bersama CMD untuk menyediakan argumen atau parameter bawaan. ENTRYPOINT mendefinisikan executable, sedangkan CMD menentukan argumen bawaan yang digunakan oleh ENTRYPOINT.

Memahami konsep Docker seperti ENTRYPOINT penting untuk sukses dalam wawancara data science. Jelajahi pertanyaan umum wawancara di 26 Pertanyaan dan Jawaban Wawancara Docker Teratas untuk 2025. 

Bentuk Sintaks ENTRYPOINT

Docker ENTRYPOINT hadir dalam dua bentuk berbeda: shell dan exec. Mengetahui perbedaannya membantu Anda memilih dengan tepat.

Bentuk shell

Contoh sintaks: 

ENTRYPOINT /usr/bin/ping -c 3 localhost

Bentuk shell memudahkan integrasi fitur shell (substitusi variabel, manipulasi environment).

Namun, ini dapat menyebabkan penanganan sinyal yang buruk; ia berjalan di dalam proses perantara /bin/sh alih-alih langsung sebagai PID 1, sehingga menimbulkan masalah saat menghentikan dan memulai ulang kontainer.

PID 1 adalah proses pertama yang dimulai saat boot sistem. Di Docker, proses PID 1 mengelola semua proses lain di dalam kontainer. 

Bentuk exec

Contoh sintaks: 

ENTRYPOINT ["/usr/bin/ping", "-c", "3"]

Bentuk exec memastikan eksekusi perintah secara langsung sebagai PID 1, sehingga penanganan sinyal dan kontrol menjadi andal.

Namun, tidak ada dukungan shell langsung atau ekspansi variabel environment otomatis; diperlukan skrip tambahan untuk mendapatkan perilaku seperti shell.

ENTRYPOINT vs CMD: Perbedaan Utama dan Use Case

Membedakan ENTRYPOINT dari CMD mencegah kebingungan dan memungkinkan perilaku kontainer yang dapat diprediksi.

Prioritas eksekusi

ENTRYPOINT menetapkan executable yang selalu dijalankan, sementara CMD menyediakan argumen bawaan. Jika keduanya didefinisikan, ENTRYPOINT memiliki prioritas dan berjalan menggunakan nilai CMD sebagai argumennya kecuali secara eksplisit dioverride saat runtime.

Skenario use case

ENTRYPOINT sebaiknya digunakan saat Anda menginginkan eksekusi yang konsisten dan dipaksakan pada setiap peluncuran, seperti kontainer perintah tunggal atau skrip pembungkus untuk aplikasi lama. Sebaliknya, CMD cocok untuk menentukan argumen bawaan, memungkinkan fleksibilitas lebih dengan override saat runtime.

Artikel 18 Perintah Docker Teratas untuk Membangun, Menjalankan, dan Mengelola Kontainer membahas perintah Docker penting, dari dasar kontainer hingga volume dan jaringan, sehingga Anda dapat mengelola aplikasi lintas lingkungan dengan percaya diri.

Contoh praktis

Kombinasi khas ENTRYPOINT dan CMD ditunjukkan oleh Dockerfile berikut:

FROM ubuntu
ENTRYPOINT ["/usr/bin/ping", "-c", "3"]
CMD ["localhost"]Didukung oleh

Kontainer Docker ini secara bawaan mengirim tiga ping ke localhost. Pengguna dapat mengoverride target bawaan ini saat runtime dengan host lain dengan mudah, tetap mempertahankan perilaku eksekusi ENTRYPOINT yang dapat diprediksi:

docker run ping-container google.comDidukung oleh

Anda dapat mempelajari lebih lanjut tentang deployment aplikasi dengan Docker melalui kursus Containerization and Virtualization with Docker and Kubernetes kami. 

Menggabungkan ENTRYPOINT dengan CMD

Menggabungkan ENTRYPOINT dengan CMD secara tepat menawarkan fleksibilitas tanpa mengorbankan konsistensi.

CMD sebagai argumen bawaan

Menetapkan ENTRYPOINT mendefinisikan perintah utama secara andal; CMD memasok parameter bawaan untuk memudahkan override tanpa membangun ulang image.

Override argumen saat runtime

Argumen yang ditentukan selama docker run hanya menimpa bawaan yang ditentukan oleh CMD. ENTRYPOINT tetap konsisten, sehingga menyederhanakan pengalaman pengguna.

Meng-override ENTRYPOINT Saat Runtime

Docker memungkinkan mengoverride ENTRYPOINT secara langsung saat runtime, sehingga Anda dapat melakukan debugging tanpa membangun ulang image Dockerfile Anda.

Penggunaan flag entrypoint

Docker menyediakan flag sederhana --entrypoint yang mengubah perilaku kontainer sementara.

docker run -it --entrypoint /bin/bash my-containerDidukung oleh

Override sementara memungkinkan pemecahan masalah menggunakan shell, menyelesaikan masalah startup umum tanpa membangun ulang image atau penundaan yang signifikan.

Menyesuaikan Perilaku ENTRYPOINT

Docker menawarkan fleksibilitas saat ENTRYPOINT memerlukan kustomisasi yang lebih lanjut.

Meng-override ENTRYPOINT saat runtime

Anda dapat mengoverride perintah ENTRYPOINT secara dinamis saat runtime menggunakan docker run --entrypoint untuk debugging atau mengubah konteks dengan cepat tanpa berulang kali memodifikasi Dockerfile Anda.

ENTRYPOINT dengan argumen

Argumen yang diteruskan ke kontainer menjadi parameter ENTRYPOINT saat runtime; praktik terbaik menyarankan agar kompleksitas ENTRYPOINT seminimal mungkin bersama CMD untuk kejelasan dan kontrol maksimum.

Skrip pembungkus

Skrip Bash yang diperkenalkan sebagai perintah ENTRYPOINT dapat mengeksekusi logika startup kondisional, menunggu layanan yang bergantung (seperti database), menangani tugas penyiapan, dan lainnya, sambil mempertahankan sintaks Dockerfile yang bersih.

Contoh dan Pola Dunia Nyata

Aplikasi ENTRYPOINT yang praktis dapat menggambarkan penggunaan yang umum dan realistis. Mari kita lihat beberapa di antaranya.

Kontainer perintah tunggal 

Untuk penyiapan aplikasi Flask:

FROM python:3.11-alpine
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
ENTRYPOINT ["python", "app.py"]
CMD ["--port", "8080"]Didukung oleh

Pada Dockerfile di atas:

• ENTRYPOINT ["python", "app.py"]  menetapkan executable bawaan. Inilah yang dijalankan saat kontainer mulai.
• CMD ["--port", "8080"]  menyediakan argumen bawaan (--port 8080) untuk perintah ENTRYPOINT.

Perintah bawaan lengkap yang dieksekusi akan menjadi:

python app.py --port 8080Didukung oleh

 Jika Anda mengoverride CMD saat menjalankan kontainer (mis., docker run myimage --port 9090), itu akan menggantikan --port 8080.

Skrip sebagai ENTRYPOINT 

Ini digunakan untuk menyiapkan logika kondisional pendukung: 

entrypoint.sh:

#!/bin/sh
until nc -z db_host 5432; do
  echo "Waiting for database to become available."
  sleep 2
done
exec python app.py "$@"Didukung oleh

Dockerfile:

FROM python:3.11-alpine
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
COPY entrypoint.sh .
RUN chmod +x entrypoint.sh
ENTRYPOINT ["./entrypoint.sh"]
CMD ["--port", "8080"]Didukung oleh

Pada berkas di atas:

• entrypoint.sh digunakan untuk menunggu koneksi database.
• exec python app.py "$@"  menggantikan proses shell saat ini dengan python app.py, meneruskan argumen tambahan apa pun. "$@" berasal dari parameter CMD atau docker run.
• COPY entrypoint.sh  menyalin skrip entrypoint.sh ke direktori /app kontainer.
• ENTRYPOINT ["./entrypoint.sh"] menetapkan entrypoint.sh sebagai skrip startup bawaan saat kontainer berjalan.
• CMD ["--port", "8080"] menyediakan argumen bawaan yang akan diteruskan ke skrip entrypoint.sh dan akhirnya ke python app.py. Perintah akhir yang dieksekusi akan terlihat seperti: python app.py --port 8080. 

Penanganan Sinyal dan PID 1

Bentuk ENTRYPOINT berdampak signifikan pada kemampuan Docker menangani sinyal karena pentingnya PID 1. Mari kita bahas lebih rinci: 

Bentuk exec dan PID 1

Bentuk exec menjalankan perintah langsung sebagai proses PID 1 Docker, yang meningkatkan keandalan penerusan sinyal serta perilaku penghentian atau pemulaian ulang yang tepat.

Keterbatasan bentuk shell

Bentuk shell menambahkan proses shell perantara. Ini mencegah sinyal terminasi mencapai proses aplikasi, menciptakan risiko kontainer macet atau tidak responsif.

Debugging Perilaku ENTRYPOINT

Pemecahan masalah konfigurasi entrypoint menjadi lebih mudah dengan teknik dan trik tertentu. Mari kita temukan di bawah ini. 

Menggunakan --entrypoint untuk debugging

Override sementara dengan cepat memungkinkan shell debugging interaktif di dalam kontainer Anda tanpa membangun ulang image. Ini memungkinkan Anda menguji berbagai hal dalam aplikasi tanpa membangun ulang image. 

Melihat log ENTRYPOINT

Memeriksa log output dengan docker logs mempermudah penelusuran riwayat eksekusi dan menemukan masalah konfigurasi dengan jelas dan cepat.

Hindari memodifikasi Dockerfile untuk pengujian sementara

Override ENTRYPOINT saat runtime yang ramah debugging memungkinkan Anda mengisolasi dan memperbaiki masalah tanpa berulang kali memodifikasi dan membangun ulang image kontainer.

Teknik Optimasi dan Praktik Terbaik

Di bawah ini beberapa optimasi yang direkomendasikan untuk meningkatkan keandalan dan kemudahan pemeliharaan ENTRYPOINT.

Gunakan bentuk exec untuk penanganan sinyal

Selalu utamakan bentuk exec untuk sinyal terminasi yang tepat serta keandalan dan pengelolaan kontainer yang lebih baik secara keseluruhan.

Menggabungkan ENTRYPOINT dan CMD secara efektif

Pisahkan executable Anda (ENTRYPOINT) dari argumen runtime bawaan (CMD) dan manfaatkan override saat runtime untuk fleksibilitas maksimum dan kemudahan pengelolaan.

Minimalkan kompleksitas di ENTRYPOINT

Jaga ENTRYPOINT tetap sederhana, delegasikan logika atau kondisi startup yang kompleks ke skrip terpisah untuk memastikan pengelolaan kompleksitas yang tepat dan meningkatkan kejelasan.

Use Case dan Pola Lanjutan

Mari jelajahi beberapa use case dan pola ENTRYPOINT tingkat lanjut.

Build multi-stage dengan ENTRYPOINT

ENTRYPOINT pada tahap akhir Docker menegakkan eksekusi yang andal, menghadirkan build yang lebih bersih dan disesuaikan khusus untuk tugas produksi dalam alur kerja CI/CD.

Skrip ENTRYPOINT dinamis

Skrip ENTRYPOINT dapat menyesuaikan logika startup secara dinamis sesuai variabel environment atau argumen runtime yang diberikan, beradaptasi mulus dalam berbagai konteks aplikasi.

ENTRYPOINT untuk pipeline CI/CD

Memanfaatkan ENTRYPOINT meningkatkan konsistensi di lingkungan pengujian dan produksi, memastikan perilaku runtime yang dapat diprediksi dan berulang. Misalnya, Anda dapat mengatur ENTRYPOINT ke skrip yang menjalankan pengujian secara otomatis. 

Aplikasi lain mencakup: 

• Sebuah ENTRYPOINT yang menunggu database, lalu menjalankan migrasi, dan akhirnya memulai app.
• Sebuah ENTRYPOINT yang mengompilasi aset, melakukan linting kode, atau memvalidasi konfigurasi secara otomatis.
• Skrip ENTRYPOINT dapat mendeteksi lingkungan (dev, staging, production) dan menyesuaikan pengaturan saat startup kontainer. 

Berikut contoh image Docker yang menjalankan pengujian secara otomatis:

FROM python:3.11
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
ENTRYPOINT ["pytest"]Didukung oleh

.gitlab-ci.yml akan terlihat seperti ini:

build-test:
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker build -t myapp-test .
    - docker run myapp-test  # <-- No need to specify 'pytest', ENTRYPOINT does itDidukung oleh

Saat docker run dijalankan, ini otomatis memicu pytest di dalam kontainer. Ini akan memastikan semua pengujian ditemukan dan langsung dijalankan. 

Ada beberapa keuntungan menggunakan ENTRYPOINT dalam CI/CD:

• Setiap kontainer mulai dan berperilaku dengan cara yang sama. 
• Menyederhanakan skrip CI/CD karena Anda tidak perlu meneruskan perintah lengkap setiap saat. 
• Mengotomatiskan pemeriksaan pra-mulai, menjalankan pengujian, dan migrasi, mengurangi kesalahan manusia. 

Jebakan Umum dan Pemecahan Masalah

ENTRYPOINT memiliki beberapa jebakan yang patut dihindari dalam alur kerja Anda.

Salah menggunakan bentuk shell

Bentuk shell menghambat sinyal dan pengelola kontainer; selalu utamakan bentuk exec untuk penanganan sinyal yang tepat, keluar kontainer yang benar, dan penghentian yang bersih.

Membuat ENTRYPOINT terlalu rumit

Skrip kompleks yang kurang jelas atau andal akan semakin menyulitkan saat debugging atau pemeliharaan berkelanjutan. Penyiapan ENTRYPOINT yang sederhana sangat memudahkan pemecahan masalah.

Kesimpulan

Memahami dan menerapkan Docker ENTRYPOINT secara efektif memungkinkan Anda membangun kontainer Docker yang dapat diprediksi, andal, dan mudah dipelihara untuk aplikasi Anda. Jika digunakan dengan benar, ENTRYPOINT menciptakan konsistensi tanpa mengorbankan fleksibilitas berkat sistem override Docker yang kuat. Bereksperimen secara cermat dengan pola ENTRYPOINT, sambil mematuhi praktik terbaik yang diuraikan di atas, akan sangat menyederhanakan penggunaan Docker dan menghasilkan siklus deployment serta pengelolaan yang lebih mulus di produksi.

Lihat kursus Docker kami untuk mengeksplorasi lebih banyak topik Docker, seperti:

• Introduction to Docker
• Containerization and Virtualization Concepts 
• Containerization and Virtualization with Docker and Kubernetes
• Intermediate Docker