update

Author: smlsunxie

Diff for: SUMMARY.md

@@ -20,6 +20,8 @@
   - [Repository](docker/000-intro/repository/README.md)
   - [Registry](docker/000-intro/registry/README.md)
 
+- [command reference](docker/basic/command_ref/README.md)
+
 - [Lab 101: Docker Image](docker/basic/101-image/README.md)
 
   - [help](docker/basic/101-image/help/README.md)
@@ -38,11 +40,15 @@
   - [exec, attach](docker/basic/102-container/exec/README.md)
   - [rm](docker/basic/102-container/rm/README.md)
 
-- [Lab 104: Registry](docker/basic/103-registry/README.md)
+- [Lab 103: Registry](docker/basic/103-registry/README.md)
 
   - [distribution private](docker/basic/103-registry/distribution-private/README.md)
   - [distribution public](docker/basic/103-registry/distribution-public/README.md)
 
+- Lab 104: dockerfile
+
+  - [CMD vs entrypoint](docker/basic/104-dockerfile/entrypoint/README.md)
+
 - [Lab 201: Docker volume](docker/basic/201-volume/README.md)
 
   - [create, inspect](docker/basic/201-volume/create/README.md)
@@ -94,6 +100,10 @@
   - [運行](docker/project/java/mvn-run/README.md)
   - [打包](docker/project/java/mvn-package/README.md)
 
+- Lab 702: docker-compose
+  - [run and up](docker/compose/run_up/README.md)
+  - [其他指令](docker/compose/other_command/README.md)
+
 - Lab 703: java 範例專案使用 docker-compose 進行建置 (1 hour)
 
   - [練習：製作 dev mode service](docker/pratice/compose-dev-mode.md)

Diff for: docker/basic/104-dockerfile/entrypoint/README.md

@@ -0,0 +1,82 @@
+CMD 與 ENTRYPOINT 的差別
+========================
+
+下列內容來源：[論docker中 CMD 與 ENTRYPOINT 的區別](http://www.programfish.com/blog/?p=151)
+
+Dockerfile裏有 CMD 與 ENTRYPOINT 兩個功能咋看起來很相似的指令，開始的時候覺得兩個互用沒什麽所謂，但其實並非如此。
+
+CMD
+---
+
+> The main purpose of a CMD is to provide defaults for an executing container.
+
+CMD在容器運行的時候提供一些命令及參數，用法如下：
+
+### type 1
+
+`CMD ["executable","param1","param2"](exec form, this is the preferred form)`
+
+運行一個可執行的文件並提供參數。
+
+### type 2
+
+`CMD ["param1","param2"](as default parameters to ENTRYPOINT)`
+
+為ENTRYPOINT指定參數。
+
+### type 3
+
+`CMD command param1 param2 (shell form)`
+
+(shell form)：是以”/bin/sh -c”的方法執行的命令。
+
+ENTRYPOINT 　
+-------------
+
+字面意思是進入點，而它的功能也恰如其意。
+
+> An ENTRYPOINT allows you to configure a container that will run as an executable.
+
+它可以讓你的容器功能表現得像一個可執行程序一樣。
+
+容器功能表現得像一個可執行程序一樣，這是什麽意思呢？
+
+使用下面的 ENTRYPOINT 建置 image：
+
+`ENTRYPOINT ["/bin/echo"]`
+
+docker build 出來的鏡像以後的容器功能就像一個 /bin/echo
+
+比如我 build 出來的鏡像名稱叫 imageecho，那麽我可以這樣用它：
+
+docker run -it imageecho “this is a test”
+
+`ENTRYPOINT ["/bin/cat"]`
+
+build 出來的鏡像你可以這樣運行 (假設名為 st)：
+
+`docker run -it st /etc/fstab`
+
+這樣相當： /bin/cat /etc/fstab 這個命令的作用。運行之後就輸出 `/etc/fstab` 裏的內容。
+
+ENTRYPOINT有兩種寫法：
+
+### type 1
+
+ENTRYPOINT ["executable", "param1", "param2"](the preferred exec form)
+
+### type 2
+
+ENTRYPOINT command param1 param2 (shell form)
+
+你也可以在 docker run 命令時使用 --entrypoint 指定（但是只能用 type 1）。
+
+CMD 可以為 ENTRYPOINT 提供參數，ENTRYPOINT 本身也可以包含參數， 但是你可以把那些可能需要變動的參數寫到 CMD 裏而把那些不需要變動的參數寫到 ENTRYPOINT 裏面例如：
+
+```
+FROM ubuntu:14.10
+ENTRYPOINT ["top", "-b"]
+CMD ["-c"]
+```
+
+把可能需要變動的參數寫到 CMD 裏面。然後你可以在 docker run 裏指定參數，這樣 CMD 裏的參數(這裏是 -c) 就會被覆蓋掉而 ENTRYPOINT 裏的不被覆蓋。

Diff for: docker/basic/command_ref/README.md

@@ -0,0 +1,5 @@
+# 指令圖解
+
+![](docker-hub.png)
+
+![](docker-stages.png)

Diff for: docker/basic/command_ref/docker-hub.png

@@ -0,0 +1,25 @@
+其他有用指令
+------
+
+### extends
+
+可以繼承於某一個特定的 docker-compose-yml
+
+ex:
+
+```
+extends:
+  file: common.yml
+  service: webapp
+```
+
+### Variable substitution
+
+與 extends 類似，不過可以透過 env 變數進行相關參數替換
+
+ex:
+
+```
+db:
+  image: "postgres:${POSTGRES_VERSION}"
+```

Diff for: docker/basic/command_ref/docker-stages.png

@@ -0,0 +1,30 @@
+run and up
+==========
+
+run
+---
+
+使用 run 時，預設將沒辦法讓共享的 port 可以被 expose 出去
+
+也就是說假若妳用 run 啟動了一個 web 將沒有辦法讓啟動完成的 docker 可以被外部連結
+
+但使用 docker compose 用於在 jenkins 自動化測試時，在 docker 內運行的錯誤將可以被正確回傳 exit code
+
+如此一來，就可以正確反應 test 狀態。
+
+不過運行 run 不能 expose 的問題已被解決，目前可以使用：
+
+1.	希望開啟特定 service 的 port 但不想被掛到 host: service-ports
+
+	EX: docker-compose run --service-ports mysql web
+
+2.	要將特定 port 掛到 host 可以使用： --publish or -p
+
+	docker-compose run --publish 1337:1337 web
+
+up
+--
+
+基本上就會將在 docker compose 中有開啟的 port 還有掛載到 host 的 port，
+
+以及對應 links 相關的 Containers 一次啟動完成。