O ENTRYPOINT
especifica um comando que sempre será executado quando o contêiner for iniciado.
O CMD
especifica argumentos que serão alimentados para o ENTRYPOINT
.
Se você quiser criar uma imagem dedicada a um comando específico, usará ENTRYPOINT ["/path/dedicated_command"]
Caso contrário, se desejar criar uma imagem para uso geral, você pode deixar ENTRYPOINT
não especificado e usá- CMD ["/path/dedicated_command"]
lo, pois poderá substituir a configuração fornecendo argumentos para docker run
.
Por exemplo, se o seu Dockerfile for:
FROM debian:wheezy
ENTRYPOINT ["/bin/ping"]
CMD ["localhost"]
A execução da imagem sem nenhum argumento fará ping no host local:
$ docker run -it test
PING localhost (127.0.0.1): 48 data bytes
56 bytes from 127.0.0.1: icmp_seq=0 ttl=64 time=0.096 ms
56 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.088 ms
56 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.088 ms
^C--- localhost ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss
round-trip min/avg/max/stddev = 0.088/0.091/0.096/0.000 ms
Agora, executar a imagem com um argumento fará ping no argumento:
$ docker run -it test google.com
PING google.com (173.194.45.70): 48 data bytes
56 bytes from 173.194.45.70: icmp_seq=0 ttl=55 time=32.583 ms
56 bytes from 173.194.45.70: icmp_seq=2 ttl=55 time=30.327 ms
56 bytes from 173.194.45.70: icmp_seq=4 ttl=55 time=46.379 ms
^C--- google.com ping statistics ---
5 packets transmitted, 3 packets received, 40% packet loss
round-trip min/avg/max/stddev = 30.327/36.430/46.379/7.095 ms
Para comparação, se o seu Dockerfile for:
FROM debian:wheezy
CMD ["/bin/ping", "localhost"]
A execução da imagem sem nenhum argumento fará ping no host local:
$ docker run -it test
PING localhost (127.0.0.1): 48 data bytes
56 bytes from 127.0.0.1: icmp_seq=0 ttl=64 time=0.076 ms
56 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.087 ms
56 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.090 ms
^C--- localhost ping statistics ---
3 packets transmitted, 3 packets received, 0% packet loss
round-trip min/avg/max/stddev = 0.076/0.084/0.090/0.000 ms
Mas executar a imagem com um argumento executará o argumento:
docker run -it test bash
root@e8bb7249b843:/#
Consulte este artigo de Brian DeHamer para obter mais detalhes:
https://www.ctl.io/developers/blog/post/dockerfile-entrypoint-vs-cmd/