Merge pull request #1523 from sudo-bmitch/pr-doc-cmd-entrypoint

Documenting ENTRYPOINT can empty value of CMD
docker · Nov 20, 2018 · 422baf6 · 422baf6
2 parents f7ea8e8 + cc316fd
commit 422baf6
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/reference/builder.md b/docs/reference/builder.md
@@ -1339,6 +1339,10 @@ The table below shows what command is executed for different `ENTRYPOINT` / `CMD
 | **CMD ["p1_cmd", "p2_cmd"]**   | p1_cmd p2_cmd              | /bin/sh -c exec_entry p1_entry | exec_entry p1_entry p1_cmd p2_cmd              |
 | **CMD exec_cmd p1_cmd**        | /bin/sh -c exec_cmd p1_cmd | /bin/sh -c exec_entry p1_entry | exec_entry p1_entry /bin/sh -c exec_cmd p1_cmd |
 
+> **Note**: If `CMD` is defined from the base image, setting `ENTRYPOINT` will
+> reset `CMD` to an empty value. In this scenario, `CMD` must be defined in the
+> current image to have a value.
+
 ## VOLUME
 
     VOLUME ["/data"]