{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到容器管理與應用,這是我們的最後一章。容器上線之後,真正的工作才開始。這一章要學怎麼看日誌、容器出問題的時候怎麼除錯,還有磁碟清理、更新和監控這些日常維運,最後把整門課做一個總整理。", "item": 0 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#1": [
   { "say": "先建立容器日誌的基本原則。", "item": 0 },
   { "say": "在容器的世界,標準的做法是,應用程式把日誌寫到標準輸出和標準錯誤,交給容器引擎來收集。", "item": 1 },
   { "say": "不要在容器裡把日誌寫成檔案,再自己想辦法撈出來。因為容器隨時可能被刪除,檔案也就跟著不見。而且 docker logs 和後面的集中式日誌系統,都只認標準輸出和標準錯誤。", "item": 1 },
   { "say": "很多官方映像檔已經幫你處理好了。像 engine X 的官方映像檔,就把存取日誌和錯誤日誌,分別連結到標準輸出和標準錯誤。", "item": 2 },
   { "say": "自己寫的應用程式,也請設定成輸出到標準輸出。Python 記得設定 unbuffered 那個環境變數,不然輸出可能被緩衝,延遲才出現。", "item": 2 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#2": [
   { "say": "docker logs 我們在第二章學過,這裡複習一下,再補充幾個進階的用法,指令在後面幾頁。先講兩個重點。", "item": 0 },
   { "say": "第一個重點是,docker logs 會保留原本標準輸出和標準錯誤的分流。所以用管線搭配 grep 篩選的時候,要先把標準錯誤併進標準輸出,不然來自容器標準錯誤的內容,不會進到 grep 裡面。", "item": 1 },
   { "say": "第二,Compose 也有對應的指令,就是 docker compose logs。", "item": 2 },
   { "say": "它會把多個服務的日誌交錯顯示,並且在每一行前面加上服務名稱。很適合用來追蹤一個請求,是怎麼流過 proxy、app 和 D B 的。", "item": 3 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#3": [
   { "say": "先快速複習基本用法。", "item": 0 },
   { "say": "docker logs 接容器名稱,看全部的日誌。", "item": 1 },
   { "say": "加減號 F,持續追蹤。", "item": 2 },
   { "say": "加兩個減號 tail 一百,只看最後一百行。", "item": 3 },
   { "say": "加兩個減號 since 三十 M,只看最近三十分鐘。", "item": 4 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#4": [
   { "say": "再來是進階一點的。", "item": 0 },
   { "say": "since 可以搭配 until,兩個都給完整的日期和時間,就能精確地只看某一段時間,例如某一天早上九點到十點之間的日誌。", "item": 1 },
   { "say": "加減號 T,在每一行前面顯示時間戳記。", "item": 2 },
   { "say": "最後這一行,就是剛才說的重點。先寫二、大於符號、and、一,把標準錯誤併到標準輸出,再用管線符號接 grep,不分大小寫地找出含有 error 的行。", "item": 3 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#5": [
   { "say": "Compose 的版本長這樣。", "item": 0 },
   { "say": "docker compose logs,加上減號 F 和 tail 五十,最後接服務名稱 app,就是持續追蹤 app 這個服務,從最後五十行開始看。", "item": 1 },
   { "say": "不寫服務名稱,只加 since 十 M,就是看所有服務最近十分鐘的日誌。", "item": 2 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#6": [
   { "say": "那日誌到底存在哪裡呢?Docker 的日誌是由 logging driver,也就是日誌驅動來處理的。預設的驅動叫 JSON file,每個容器的日誌,會存成主機上的一個 JSON 檔。除了它之外,還有幾個常見的驅動。", "item": 0 },
   { "say": "local,是 Docker 自己最佳化過的格式,預設就會做輪替。不需要和外部系統整合的時候,很適合用它。", "item": 1 },
   { "say": "journal D,是把日誌交給 system D 的 journal 來管理。", "item": 2 },
   { "say": "還有 sys log、fluent D 這一類,會把日誌直接送到外部的日誌系統。", "item": 3 },
   { "say": "要注意,不同的驅動,對 docker logs 的支援程度不一樣,行為也會隨 Docker 的版本而不同。正式採用之前,請先實際測試。", "item": 3 }
  ],
  "容器日誌:docker logs、日誌驅動與輪替#7": [
   { "say": "怎麼查看目前用的是哪一個驅動呢?", "item": 0 },
   { "say": "用 docker info 搭配 format,只取出 Logging Driver 這個欄位。", "item": 1 },
   { "say": "結果是 JSON file,就是預設值。", "item": 2 },
   { "say": "如果想看某一個容器自己的日誌設定,就用 docker inspect,取出它的 Log Config 欄位。", "item": 3 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#1": [
   { "say": "第二個單元是除錯實戰。容器出問題的時候,不要亂猜,請照下面的順序收集證據。", "item": 0 },
   { "say": "第一步,docker P S 加減號 A,看容器的狀態。是正常執行中、已經結束,還是一直在重啟?", "item": 1 },
   { "say": "第二步,docker logs 看最後一百行,它最後輸出了什麼錯誤?", "item": 2 },
   { "say": "第三步,docker inspect,看結束碼、是不是因為記憶體不足被砍掉,還有環境變數、掛載和網路的設定。", "item": 3 },
   { "say": "第四步,用 docker exec 或是臨時的容器進去,親眼確認檔案、權限和網路。", "item": 4 },
   { "say": "第五步,修改之後重新建置或啟動,驗證問題是不是真的解決了。", "item": 5 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#2": [
   { "say": "除錯的時候,結束碼是很重要的線索。我們來看常見的幾個。", "item": 0 },
   { "say": "零,代表正常結束。可能是任務跑完了,但也可能是它不該結束卻結束了。", "item": 1 },
   { "say": "一,是應用程式一般性的錯誤,請去看日誌。", "item": 2 },
   { "say": "一二五,是 docker run 本身出錯,例如選項寫錯,或是 daemon 有問題。", "item": 3 },
   { "say": "一二六,是指令存在,但是沒辦法執行。可能是沒有執行權限,或者它根本不是執行檔。", "item": 4 },
   { "say": "一二七,是找不到指令。可能是命令拼錯、PATH 不對,或是映像檔裡根本沒有這支程式。", "item": 5 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#3": [
   { "say": "再來是三個比較大的數字。有一個規則,大於一二八的結束碼,通常等於一二八加上訊號的編號。", "item": 0 },
   { "say": "一三七,是一二八加九,代表被 SIG KILL 強制終止。常見的原因是 docker stop 逾時被強制砍掉,或是記憶體不足,被系統的 O O M Killer 殺掉。", "item": 1 },
   { "say": "一三九,是一二八加十一,代表 Segmentation fault,程式存取了不該碰的記憶體。", "item": 2 },
   { "say": "一四三,是一二八加十五,代表收到 SIG TERM 而終止。這通常是正常的優雅關閉,不用擔心。", "item": 3 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#4": [
   { "say": "結束碼要怎麼查呢?", "item": 0 },
   { "say": "用 docker inspect 搭配格式設定,一次取出三個欄位,狀態、結束碼,還有是不是被 O O M 砍掉。", "item": 1 },
   { "say": "這個例子的結果是,狀態 exited,結束碼一三七,O O M 是 true。三個放在一起看就很清楚,這個容器是記憶體不夠用,被系統殺掉的。", "item": 2 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#5": [
   { "say": "來看一個最常見的情境,容器一啟動就馬上結束。", "item": 0 },
   { "say": "照剛才的流程,先看狀態,再看日誌。這個例子的日誌很明確,Python 說找不到 flask 這個模組。", "item": 1 },
   { "say": "也就是缺套件。這時候要檢查 requirements 檔,還有 Dockerfile 裡安裝套件的步驟,然後重新建置。建置的時候可以加上 no cache 選項,排除快取的干擾。", "item": 2 },
   { "say": "其他常見的原因還有,設定檔的路徑錯了、環境變數沒有傳進去、連不上資料庫所以程式自己結束,或是主程序跑到背景去執行,前景一結束,容器就跟著結束。", "item": 2 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#6": [
   { "say": "對照畫面上的輸出。", "item": 0 },
   { "say": "先下 docker P S 減號 A。", "item": 1 },
   { "say": "看表頭,有容器 I D、映像檔、執行的指令、狀態和名稱。", "item": 2 },
   { "say": "my app 這個容器的狀態是 Exited,括號裡的一就是結束碼,而且是三秒鐘前才結束的,也就是一啟動就掛了。", "item": 3 },
   { "say": "所以接著用 docker logs 看它說了什麼。", "item": 4 }
  ],
  "除錯實戰:容器啟動失敗與結束碼#7": [
   { "say": "日誌的內容是這樣。", "item": 0 },
   { "say": "Traceback 開頭,這是 Python 的錯誤追蹤訊息。", "item": 1 },
   { "say": "關鍵在最後一行,Module Not Found Error,找不到名叫 flask 的模組。看 Python 的錯誤,記得從最後一行看起。", "item": 2 }
  ],
  "日常維運:磁碟、更新、監控與備份#1": [
   { "say": "第三個單元是日常維運,第一個議題最常見,就是磁碟空間。Docker 的映像檔、容器的可寫層、volume、建置快取和日誌,預設都放在同一個目錄底下,久了一定會膨脹。清理之前,請記住四條安全守則。", "item": 0 },
   { "say": "第一,先用 docker system D F 看清楚狀況,再決定要清什麼。", "item": 1 },
   { "say": "第二,清 volume 之前,先確認有備份。而且要知道,未使用不等於不重要。一個暫時停掉的資料庫容器,它的 volume 也算是未使用。", "item": 2 },
   { "say": "第三,不要在尖峰時段,把映像檔全部清掉之後,又馬上重新拉一大堆回來。", "item": 3 },
   { "say": "第四,磁碟快滿的時候,第一個要檢查的是日誌。用 D U 指令找出最肥的那幾個日誌檔。正確的處理方式是設定日誌輪替,而不是直接刪掉正在使用中的日誌檔。", "item": 4 },
   { "say": "清理也可以用排程自動化,例如每個星期自動清一次映像檔和建置快取。但是 volume 的清理,請不要自動化。", "item": 4 }
  ],
  "日常維運:磁碟、更新、監控與備份#2": [
   { "say": "先看現況。", "item": 0 },
   { "say": "輸入 docker system D F。", "item": 1 },
   { "say": "表頭有類型、總數、使用中的數量、大小,還有最後一欄可以回收的空間。", "item": 2 },
   { "say": "映像檔有二十五個,只有五個在用,佔了八點二 G B,其中六點一 G B 可以回收。", "item": 3 },
   { "say": "容器有八個,四個在執行,佔的空間不大。", "item": 4 },
   { "say": "本機的 volume 有六個,三個在用,佔二點四 G B。", "item": 5 },
   { "say": "建置快取有三點五 G B,全部都可以回收。當然,這些數字只是示意。", "item": 6 }
  ],
  "日常維運:磁碟、更新、監控與備份#3": [
   { "say": "接著是清理的指令,由輕到重排列。", "item": 0 },
   { "say": "在剛才的指令後面加上減號 V,可以看到每一項的明細。", "item": 1 },
   { "say": "docker container prune,清掉已經停止的容器。", "item": 2 },
   { "say": "docker image prune,清掉 dangling 的映像檔,也就是沒有標籤、沒人引用的那些。", "item": 3 },
   { "say": "加上減號 A 範圍就更大,所有沒有被容器使用的映像檔,都會被清掉。", "item": 4 }
  ],
  "日常維運:磁碟、更新、監控與備份#4": [
   { "say": "繼續往下。", "item": 0 },
   { "say": "docker builder prune,清掉建置快取。", "item": 1 },
   { "say": "docker volume prune,清掉未使用的 volume。再提醒一次,這個指令可能讓資料消失。", "item": 2 },
   { "say": "docker system prune 是綜合版,一次清掉停止的容器、沒在用的網路、dangling 的映像檔,還有建置快取。", "item": 3 }
  ],
  "日常維運:磁碟、更新、監控與備份#5": [
   { "say": "最後是範圍最大的一個。", "item": 0 },
   { "say": "docker system prune 同時加上減號 A 和兩個減號 volumes,連沒在用的映像檔和 volume 都一起清掉。這個指令請務必謹慎使用。", "item": 1 }
  ],
  "日常維運:磁碟、更新、監控與備份#6": [
   { "say": "第二個議題是更新,包含映像檔和 Docker 本身。", "item": 0 },
   { "say": "先看怎麼更新應用,前提是你用的是固定的 tag。", "item": 1 },
   { "say": "Compose 很聰明,只會重建映像檔有變動的服務。更新之前先備份,更新之後記得檢查服務的狀態和日誌。", "item": 2 },
   { "say": "步驟是,先用 docker compose pull,把新的映像檔拉下來。", "item": 3 },
   { "say": "再用 docker compose up 減號 D,套用更新。", "item": 4 },
   { "say": "最後用 docker image prune 加減號 F,清掉換下來的舊映像檔。", "item": 5 },
   { "say": "請保留上一版的 tag。萬一出問題,只要把 tag 改回舊的,再 up 一次就能回滾,這也是不要用 latest 的原因。", "item": 5 },
   { "say": "另外,基底映像檔會有安全修補,所以要定期重新建置自己的映像檔。至於 Docker Engine 本身,請依照官方文件用套件管理器升級,重大版本升級之前,先在測試環境演練過。", "item": 5 }
  ],
  "日常維運:磁碟、更新、監控與備份#7": [
   { "say": "第三個議題是監控。提早知道出事,比出事之後才發現重要得多。", "item": 0 },
   { "say": "輕量的工具有幾個。docker stats 可以即時看每個容器的 C P U、記憶體、網路和磁碟讀寫。docker P S 可以篩選出不健康的容器。docker events 可以監看容器結束之類的事件。", "item": 1 },
   { "say": "長期的監控和告警,通常要靠專門的系統。例如 Prometheus 搭配 C Advisor 蒐集容器指標,用 Grafana 做儀表板,或是用雲端的監控服務,再加上集中式的日誌系統。", "item": 2 },
   { "say": "最基本要監控的項目有,容器是不是活著和重啟的次數、C P U、記憶體和磁碟、錯誤日誌的比例、應用的健康檢查端點,還有映像檔的漏洞掃描結果。", "item": 2 }
  ],
  "課程總整理與下一步#1": [
   { "say": "恭喜你,走到這裡,代表你已經完成了容器管理與應用這門課。我們回頭看看這八章,你其實走完了一條完整的容器化路徑。", "item": 0 },
   { "say": "第一章是觀念。容器是被隔離、資源受限制的程序。映像檔是唯讀的模板,容器是它的執行個體,而 registry 負責分發。", "item": 1 },
   { "say": "第二章是日常操作。pull、run、P S、logs、exec、stop、R M,還有重啟策略、資源限制和清理。", "item": 2 },
   { "say": "第三章是建置。寫 Dockerfile、善用建置快取、分清楚 C M D 和 ENTRYPOINT、使用點 dockerignore,還有多階段建置。", "item": 3 }
  ],
  "課程總整理與下一步#2": [
   { "say": "接著是後面五章。", "item": 0 },
   { "say": "第四章是儲存。容器的可寫層是暫時的,資料要放 volume,開發同步用 bind mount,暫存用 T M P F S。", "item": 1 },
   { "say": "第五章是網路。bridge、用減號 P 發布埠、自訂網路和名稱解析,還有分層和內部網路。", "item": 2 },
   { "say": "第六章是 Compose。用一個 compose 檔描述多服務的應用,搭配健康檢查和 secrets。", "item": 3 },
   { "say": "第七章是最佳化和安全。瘦身、不用 root、機密不進映像檔、掃描,還有 registry 和標籤策略。", "item": 4 },
   { "say": "第八章,也就是這一章,是維運。日誌、用結束碼除錯、清理、更新、監控和備份。", "item": 5 }
  ],
  "課程總整理與下一步#3": [
   { "say": "如果要把整門課濃縮成十個習慣,會是下面這些。先看前五個。", "item": 0 },
   { "say": "第一,映像檔用明確的版本 tag 或 digest,不要拿 latest 上正式環境。", "item": 1 },
   { "say": "第二,容器裡用非 root 的使用者來執行。", "item": 2 },
   { "say": "第三,機密不進映像檔,也不進 Git,執行的時候才注入。", "item": 3 },
   { "say": "第四,資料放在 volume,而且要實際演練過備份和還原。", "item": 4 },
   { "say": "第五,只對外發布必要的埠,資料庫和內部服務不要對外。", "item": 5 }
  ],
  "課程總整理與下一步#4": [
   { "say": "再看後五個。", "item": 0 },
   { "say": "第六,服務之間用名稱互連,不要寫死 I P,也不要用 localhost 去連別的容器。", "item": 1 },
   { "say": "第七,日誌輸出到標準輸出和標準錯誤,並且設定輪替。", "item": 2 },
   { "say": "第八,替容器設定資源上限和重啟策略,替服務設定健康檢查。", "item": 3 },
   { "say": "第九,Dockerfile 和 compose 檔都放進版本控制,讓環境可以重現。", "item": 4 },
   { "say": "第十,定期掃描和更新映像檔,並且守好 docker 群組和 docker 點 sock。這十個習慣,值得你花一點時間想想,自己做到了幾個。", "item": 5, "pause": 3 }
  ],
  "課程總整理與下一步#5": [
   { "say": "學完 Docker,下一步是什麼呢?單機的 Docker 和 Compose 很好用,但是遇到下面這些需求,就會開始吃力。", "item": 0 },
   { "say": "第一,多台主機。一台機器放不下,或是需要容錯的時候。", "item": 1 },
   { "say": "第二,自我修復。容器掛了要自動補上,整台節點掛了,要把工作搬到別的節點。", "item": 2 },
   { "say": "第三,滾動更新和回滾。更新的時候不停機,出問題可以一鍵退回。", "item": 3 },
   { "say": "第四,自動擴縮。流量大的時候自動增加副本,流量小的時候再縮減。", "item": 4 }
  ],
  "課程總整理與下一步#6": [
   { "say": "還有一類需求。", "item": 0 },
   { "say": "像是服務發現和負載平衡、設定和機密的集中管理,還有跨節點的儲存管理。這些正是 Kubernetes 要解決的問題,它常常縮寫成 K 八 S,是容器編排實際上的標準。", "item": 1 }
  ],
  "課程總整理與下一步#7": [
   { "say": "最後,把 Docker 的觀念和 Kubernetes 對照一下。", "item": 0 },
   { "say": "你學過的東西不會白費,每一項都有對應。容器在 Kubernetes 裡是跑在 Pod 裡面,Pod 是最小的部署單位。compose 的 service 對應 Deployment。發布埠和名稱互連,對應 Service 和 Ingress。", "item": 1 },
   { "say": "環境變數對應 ConfigMap,機密對應 Secret,volume 對應 Persistent Volume,健康檢查對應各種 Probe,而 compose 檔,則對應一組 YAML 的資源清單。", "item": 1 },
   { "say": "至於映像檔、registry 和 Dockerfile,則是完全相同。也就是說,你在這門課做出來的映像檔,可以原封不動地交給 Kubernetes 去跑。", "item": 2 },
   { "say": "到時候真正新的,是宣告式管理和叢集的觀念。你描述想要的狀態,系統會持續讓現實往它靠近。", "item": 2 }
  ],
  "closing": [
   { "say": "整門課就到這裡。從第一個 hello world 容器,到建置映像檔、保存資料、串起網路、用 Compose 管理多個服務,再到安全和維運,你已經具備把應用程式容器化的完整能力了。", "item": 0 },
   { "say": "請記得完成這一章的實作練習和章末小測驗。後面還有期末總複習,把八章的內容再走一遍。謝謝你一路的參與,我們總複習見!", "item": 1, "pause": 1 }
  ]
 }
}
