{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到容器管理與應用。這一章要練的是每天都會用到的基本功,包括怎麼取得和查看映像檔、容器的生命週期和 docker run 的常用選項,還有怎麼看日誌、怎麼進到容器裡面。", "item": 0 }
  ],
  "管理映像檔:pull、tag、digest 與清理#1": [
   { "say": "第一步,先學怎麼取得映像檔,用的指令是 docker pull。", "item": 0 },
   { "say": "上一章我們看過,docker run 在本機找不到映像檔的時候,會自動幫你 pull。不過先自己 pull 有好處,可以提前確認映像檔真的存在,也先下載好,部署的時候就不用等。", "item": 1 },
   { "say": "如果想搜尋映像檔,建議直接到 Docker Hub 的網站,看它的說明、支援哪些 tag、是誰在維護,會比 docker search 指令查到的結果完整得多。", "item": 1 }
  ],
  "管理映像檔:pull、tag、digest 與清理#2": [
   { "say": "我們實際拉一個映像檔看看。", "item": 0 },
   { "say": "輸入 docker pull,後面接 engine X,冒號,一點二七 alpine,明確指定我們要的版本。", "item": 1 },
   { "say": "第一行告訴你,它正從 library 底下的 engine X 拉取這個標籤。", "item": 2 },
   { "say": "接著印出 Digest,是一長串 S H A 二五六的雜湊值,代表這份映像檔的確切內容。", "item": 3 },
   { "say": "然後是 Status,告訴你已經下載了比較新的映像檔。", "item": 4 }
  ],
  "管理映像檔:pull、tag、digest 與清理#3": [
   { "say": "輸出的最後還有一行。", "item": 0 },
   { "say": "這就是映像檔的完整名稱,倉庫、命名空間、名稱、標籤四段都寫出來了,和上一章學的讀法一模一樣。", "item": 1 }
  ],
  "管理映像檔:pull、tag、digest 與清理#4": [
   { "say": "拉下來之後,要怎麼知道本機有哪些映像檔呢?用 docker images 就可以列出來,它還有一個新式的寫法,叫 docker image L S,兩個是一樣的。", "item": 0 },
   { "say": "另外還有幾個常用的篩選和格式用法,我們在接下來幾頁一個一個看。", "item": 1 }
  ],
  "管理映像檔:pull、tag、digest 與清理#5": [
   { "say": "先看最基本的用法。", "item": 0 },
   { "say": "輸入 docker images。", "item": 1 },
   { "say": "表頭有五欄,分別是映像檔的名稱、標籤、映像檔的 I D、建立的時間,還有大小。", "item": 2 },
   { "say": "第一筆就是我們剛剛拉的 engine X,標籤是一點二七 alpine,大小大約四十八 M B。", "item": 3 }
  ],
  "管理映像檔:pull、tag、digest 與清理#6": [
   { "say": "繼續往下看。", "item": 0 },
   { "say": "第二筆是 alpine 三點二零,只有八 M B 左右,非常小。", "item": 1 },
   { "say": "提醒一下,畫面上的大小和日期都只是示意,你看到的數字可能不一樣。", "item": 2 },
   { "say": "如果在 docker images 後面加上名稱,比如說 engine X,就只會列出 engine X 的映像檔。", "item": 3 }
  ],
  "管理映像檔:pull、tag、digest 與清理#7": [
   { "say": "再看三個進階一點的用法。", "item": 0 },
   { "say": "第一個是加上兩個減號 format,自己決定要顯示哪些欄位。畫面上這一段的意思是,用表格的方式,只列出名稱、標籤和大小。", "item": 1 },
   { "say": "第二個是 docker image inspect,它會用 JSON 格式,印出這個映像檔完整的詳細資訊。", "item": 2 },
   { "say": "第三個是 docker image history,可以看到映像檔的每一層是怎麼來的。上一章說映像檔是分層的,用這個指令就能親眼看到。", "item": 3 }
  ],
  "容器生命週期與 docker run 常用選項#1": [
   { "say": "好,映像檔看完了,接下來看容器。容器在它的一生當中,會經過幾種狀態。", "item": 0 },
   { "say": "第一種是 created,已經建立,但是還沒啟動。用 docker create 就會得到這個狀態。", "item": 1 },
   { "say": "第二種是 running,正在執行中。", "item": 2 },
   { "say": "第三種是 paused,被暫停了,也就是用 docker pause 把裡面的程序凍結起來。", "item": 3 },
   { "say": "第四種是 exited,已經結束。不管是正常結束還是出錯,都可以再用 docker start 把它啟動起來。", "item": 4 },
   { "say": "另外還有重啟中的 restarting,和 dead 這類比較少見的狀態。", "item": 5 },
   { "say": "這裡有一個非常重要的觀念。容器只要它的主程序,也就是一號程序結束了,容器就結束。容器不是一台長期開著的小電腦,它是在跑一個主程序。", "item": 5 }
  ],
  "容器生命週期與 docker run 常用選項#2": [
   { "say": "用這張圖把狀態串起來。", "item": 0 },
   { "say": "created 經過 start 變成 running,running 經過 stop 變成 exited,而 exited 可以再 start,重新啟動同一個容器。執行中的容器,也可以用 pause 和 unpause,在 running 和 paused 之間切換。", "item": 1 }
  ],
  "容器生命週期與 docker run 常用選項#3": [
   { "say": "接下來是最常用的指令,docker run。它其實就是 docker create 加上 docker start,一次做完。它的選項很多,我們分三頁來看。", "item": 0 },
   { "say": "減號 D,是讓容器在背景執行,不會佔住你的終端機。", "item": 1 },
   { "say": "減號 I T,是開一個互動式的終端機。其中 I 是保留標準輸入,T 是配置一個終端機,兩個通常一起用。", "item": 2 },
   { "say": "兩個減號 name,是幫容器取名字。同一台主機上,名字不能重複。", "item": 3 },
   { "say": "兩個減號 R M,是容器一結束就自動刪除,很適合跑一次性的工作。", "item": 4 },
   { "say": "減號 P,是發布連接埠,冒號前面是主機的埠,後面是容器的埠。前面還可以再指定綁定的位址,例如只綁在本機,這樣就只有這台機器自己連得到。", "item": 5 }
  ],
  "容器生命週期與 docker run 常用選項#4": [
   { "say": "繼續看第二組選項。", "item": 0 },
   { "say": "減號 E,用來設定環境變數,寫法是變數名稱等於值。變數很多的話,也可以改用 env file 這個選項,從檔案讀進來。", "item": 1 },
   { "say": "減號 V,是掛載 volume 或目錄,冒號前面是來源,後面是容器裡的目標位置。這是第四章的主題。", "item": 2 },
   { "say": "兩個減號 network,是讓容器加入指定的網路,第五章會詳細說明。", "item": 3 },
   { "say": "兩個減號 restart,是設定重啟策略,決定容器停掉之後要不要自動再起來。", "item": 4 },
   { "say": "減號 W,是指定容器裡面的工作目錄。", "item": 5 }
  ],
  "容器生命週期與 docker run 常用選項#5": [
   { "say": "最後兩個。", "item": 0 },
   { "say": "減號 U,是指定用哪一個使用者的身分來執行,可以寫使用者和群組的編號,例如一千冒號一千。", "item": 1 },
   { "say": "還有 memory 和 C P U S 這兩個選項,用來限制容器能用的記憶體和處理器,下一個單元會提到。", "item": 2 }
  ],
  "容器生命週期與 docker run 常用選項#6": [
   { "say": "把幾個選項組合起來,看一個完整的例子。", "item": 0 },
   { "say": "這一行的意思是,用 engine X 一點二七 alpine 這個映像檔,在背景啟動一個容器,名字叫做 web,並且把主機的八零八零號埠,對應到容器的八十號埠。", "item": 1 }
  ],
  "容器生命週期與 docker run 常用選項#7": [
   { "say": "容器跑起來之後,要怎麼查看呢?用 docker P S。", "item": 0 },
   { "say": "什麼都不加,只會列出執行中的容器。", "item": 1 },
   { "say": "加上減號 A,連已經結束的也會列出來。找不到容器的時候,記得加這個選項看看。", "item": 2 },
   { "say": "加上減號 Q,只會印出容器的 I D,很方便拿來搭配其他指令使用。", "item": 3 },
   { "say": "加上兩個減號 filter,可以依條件篩選。畫面上的例子,是只列出狀態為 exited 的容器。", "item": 4 },
   { "say": "也可以和剛才一樣用 format 自訂欄位,例如用表格只顯示名稱、狀態和連接埠。", "item": 5 }
  ],
  "進入容器、查看日誌與資源限制#1": [
   { "say": "第三個單元,我們來看容器裡面發生了什麼事。第一個工具是 docker logs,用來看容器的輸出。", "item": 0 },
   { "say": "容器的主程序,寫到標準輸出和標準錯誤的內容,Docker 都會幫你收集起來,用 docker logs 就可以看到。", "item": 1 },
   { "say": "engine X 的官方映像檔,已經把存取日誌導到標準輸出,錯誤日誌導到標準錯誤,所以用 docker logs 看得到。", "item": 2 },
   { "say": "但是如果你的應用程式,是把日誌寫到容器裡的檔案,docker logs 就看不到了。所以建議讓應用程式直接輸出到標準輸出和標準錯誤,第八章會再深入說明。", "item": 2 }
  ],
  "進入容器、查看日誌與資源限制#2": [
   { "say": "來看 docker logs 的幾種用法。", "item": 0 },
   { "say": "docker logs 後面接容器名稱 web,會印出全部的日誌。", "item": 1 },
   { "say": "加上減號 F,會持續追蹤新的輸出。要離開的時候按 Control C,放心,這樣不會把容器停掉。", "item": 2 },
   { "say": "加上兩個減號 tail 和數字五十,就只看最後五十行。", "item": 3 }
  ],
  "進入容器、查看日誌與資源限制#3": [
   { "say": "還有兩個選項。", "item": 0 },
   { "say": "兩個減號 since,可以指定時間範圍。畫面上寫的十 M,就是只看最近十分鐘的日誌。", "item": 1 },
   { "say": "減號 T,會在每一行前面加上時間戳記,排查問題的時候很有用。", "item": 2 }
  ],
  "進入容器、查看日誌與資源限制#4": [
   { "say": "第二個工具是 docker exec,它可以在執行中的容器裡面跑指令。", "item": 0 },
   { "say": "要注意,精簡的映像檔,像 Alpine 或 distroless,常常沒有 bash,要改用 S H,有些甚至連 S H 都沒有。", "item": 1 },
   { "say": "還有,docker exec 只能用在執行中的容器。如果容器已經結束了,可以用 docker run 搭配 entrypoint 選項,另外起一個新的容器進去看看。", "item": 1 },
   { "say": "另外一個重點。你在容器裡做的修改,像是裝套件、改設定,都只存在這個容器的可寫層,不是長久之計。", "item": 2 },
   { "say": "想要永久修改,應該去改 Dockerfile,重新建置映像檔,或是用 volume 把設定檔掛進去,而不是進到容器裡手動改。", "item": 2 }
  ],
  "進入容器、查看日誌與資源限制#5": [
   { "say": "看三個實際的例子。", "item": 0 },
   { "say": "第一個,docker exec 接容器名稱 web,後面直接寫要跑的指令。這裡是請 engine X 印出自己的版本,跑完就結束。", "item": 1 },
   { "say": "第二個,加上減號 I T,最後接 S H,就會開一個互動式的 shell,讓你進到容器裡面操作。", "item": 2 },
   { "say": "第三個,再加上減號 U root,就是指定用 root 這個使用者的身分進去。", "item": 3 }
  ],
  "進入容器、查看日誌與資源限制#6": [
   { "say": "第三個工具是 docker inspect,用來查看容器的詳細設定。", "item": 0 },
   { "say": "它可以搭配減號 F,也就是 format,用 Go template 的語法,只取出你要的欄位。", "item": 1 },
   { "say": "這裡要特別留意安全。inspect 會顯示環境變數、掛載和網路等資訊。也就是說,只要能執行 docker inspect,就看得到你用減號 E 傳進去的密碼。", "item": 1 }
  ],
  "進入容器、查看日誌與資源限制#7": [
   { "say": "來看指令的樣子。", "item": 0 },
   { "say": "docker inspect 接容器名稱,會印出完整的 JSON,內容很長。", "item": 1 },
   { "say": "加上減號 F,指定 State 底下的 Status 欄位,就只會印出容器目前的狀態,例如 running。", "item": 2 },
   { "say": "同樣的方式,換成 Exit Code 這個欄位,就能查到容器的結束碼,判斷它是正常結束還是出錯。", "item": 3 }
  ],
  "closing": [
   { "say": "這一章就到這裡。你已經會拉取和查看映像檔,了解容器的各種狀態,也會用 docker run、logs、exec 和 inspect 來操作和觀察容器了。", "item": 0 },
   { "say": "接下來,請到實作練習親手操作一次,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1 }
  ]
 }
}
