{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到容器管理與應用。映像檔會做了,這一章要把它做得更好。我們會學怎麼幫映像檔瘦身,整理容器安全最重要的幾個做法,最後學會把映像檔推到 registry,和別人分享。", "item": 0 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#1": [
   { "say": "先說為什麼要瘦身,再看瘦身的第一步,選對基底映像檔。", "item": 0 },
   { "say": "映像檔越小,下載和部署越快,儲存和傳輸的成本越低,啟動也越快。更重要的是攻擊面越小。裡面少一個套件,就少一個可能有漏洞的元件,也少一個攻擊者能利用的工具。所以瘦身和安全,其實是同一件事。", "item": 1 },
   { "say": "同一個軟體,常常有好幾種變體。完整版以 Debian 為基礎,工具齊全,但是體積很大,動輒好幾百 M B。", "item": 2 },
   { "say": "slim 版把大部分非必要的套件拿掉,體積小很多,而且用的還是 G lib C,相容性好,是大多數情況下的好選擇。", "item": 3 },
   { "say": "alpine 版以 Alpine Linux 為基礎,基底只有幾 M B。但是它用的是 musl 和 busybox,有些預先編譯好的套件,特別是 Python 的二進位套件,還有除錯工具,可能會不相容,遇到問題要有心理準備。", "item": 4 },
   { "say": "最後是 distroless 和 scratch,裡面幾乎只有你的程式,沒有 shell,也沒有套件管理器,體積和攻擊面都最小,適合 Go、Rust 這類編譯成靜態執行檔的語言。缺點是除錯不方便,要另外靠除錯容器之類的工具輔助。", "item": 5 },
   { "say": "選擇的原則是,先從 slim 或官方的 alpine 開始。能靜態編譯,再考慮 scratch 或 distroless。不要為了追求極限,犧牲了可維護性。", "item": 5 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#2": [
   { "say": "我們實際比較一下大小。", "item": 0 },
   { "say": "輸入 docker image L S。", "item": 1 },
   { "say": "看名稱、標籤和大小這三欄。", "item": 2 },
   { "say": "python 三點一二的完整版,大約一 G B。", "item": 3 },
   { "say": "slim 版,只剩一百三十 M B 左右。", "item": 4 },
   { "say": "alpine 版更小,大約五十 M B。同一個 Python,差了二十倍。當然這些數字只是示意,實際大小以你拉到的版本為準。", "item": 5 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#3": [
   { "say": "第二個技巧是多階段建置,把編譯工具留在建置階段,最後的映像檔只放成品。我們用一個完整的 Go 範例來看。建置階段的映像檔可能有好幾百 M B,最終的映像檔只有一個靜態執行檔,通常才幾 M B。", "item": 0 },
   { "say": "第一個重點,建置的時候把 C G O 關掉,這樣產生的執行檔不依賴 C 函式庫,才能放進 scratch。", "item": 1 },
   { "say": "第二,scratch 是一個完全空的映像檔,裡面連使用者帳號的檔案都沒有。所以 USER 不能寫名稱,要用數字來指定一個非 root 的使用者。", "item": 2 },
   { "say": "第三,這樣的映像檔沒有 shell,所以想用 docker exec 進去開 S H 會失敗,這是正常的。", "item": 3 },
   { "say": "Python 和 Node 也可以用多階段。第一階段安裝和編譯相依套件,第二階段只把裝好的套件,複製到乾淨的 slim 映像檔裡。", "item": 3 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#4": [
   { "say": "逐行看這個 Dockerfile。", "item": 0 },
   { "say": "第一行是一個特殊的註解,用來指定 Dockerfile 語法的版本。", "item": 1 },
   { "say": "第一個 FROM,用 golang 一點二三 alpine 當基底,後面的 AS build,是替這個階段取名叫 build。", "item": 2 },
   { "say": "WORKDIR 設在斜線 S R C。", "item": 3 },
   { "say": "先複製 go 點 mod,這是 Go 的模組設定檔。", "item": 4 },
   { "say": "再複製主程式 main 點 go。", "item": 5 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#5": [
   { "say": "繼續往下。", "item": 0 },
   { "say": "RUN 這一行用 go build 進行編譯。前面把 C G O 關掉,後面的選項是去掉除錯資訊,讓執行檔更小,輸出到 out 目錄底下的 app。", "item": 1 },
   { "say": "接著出現第二個 FROM,這次是 scratch。從這裡開始是全新的第二階段,前面裝的編譯工具,通通不會帶過來。", "item": 2 },
   { "say": "COPY 加上兩個減號 from 等於 build,意思是從剛才那個 build 階段,只把編譯好的執行檔複製過來。這一行就是多階段建置的精髓。", "item": 3 },
   { "say": "USER 用數字指定使用者和群組,都是六五五三四,也就是一個沒有特權的身分。", "item": 4 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#6": [
   { "say": "最後兩行。", "item": 0 },
   { "say": "EXPOSE 宣告服務使用八零八零號埠。", "item": 1 },
   { "say": "ENTRYPOINT 指定容器啟動時,直接執行那個 app 執行檔。整個映像檔裡,就只有這一個檔案。", "item": 2 }
  ],
  "映像檔瘦身:基底選擇、多階段與快取#7": [
   { "say": "第三個技巧是減少層和清理。要知道,在某一層產生的檔案,就算下一層把它刪掉,還是佔著前一層的空間。所以安裝和清理,一定要放在同一個 RUN 裡面,用兩個 and 符號把指令串起來。", "item": 0 },
   { "say": "用 A P T get 安裝的時候,加上 no install recommends 這個選項,不要裝那些只是建議的套件。", "item": 1 },
   { "say": "裝完就把 A P T 的快取清單刪掉。同樣的道理,pip 要加不留快取的選項,N P M 則是用 N P M C I 並且略過開發用的套件。", "item": 2 },
   { "say": "不要為了方便除錯,就把 vim、curl 和各種網路工具,全部裝進正式的映像檔。", "item": 3 },
   { "say": "還有,A P T get update 一定要和 install 寫在同一個 RUN。否則 update 那一層被快取住,你就會用過期的套件清單去安裝。", "item": 4 }
  ],
  "容器安全最佳實務#1": [
   { "say": "第二個單元談安全。開始之前,先建立正確的心態。", "item": 0 },
   { "say": "容器共用主機的核心,隔離強度不如虛擬機。", "item": 1 },
   { "say": "所以安全要靠多層防禦。映像檔要乾淨,執行權限要最小,機密不能外洩,要持續掃描和更新,主機本身也要安全。接下來就是最重要的實務清單。", "item": 1 }
  ],
  "容器安全最佳實務#2": [
   { "say": "第一條,不要用 root 執行。", "item": 0 },
   { "say": "映像檔預設是用 root 執行的。這表示容器裡的程式一旦被攻破,攻擊者在容器裡就是 root,更容易搭配其他漏洞逃出容器。解法是在 Dockerfile 裡建立一個一般使用者,並且切換過去。", "item": 1 },
   { "say": "驗證的方法很簡單,用 docker run 跑映像檔,執行 I D 這個指令,看到的 U I D 不應該是零。", "item": 2 },
   { "say": "另外要注意兩件事。應用程式需要寫入的目錄,擁有者要改成這個使用者。還有不要綁一零二四以下的特權埠,改用八零八零這類的埠,再用減號 P 從主機的八十號埠對應進來。", "item": 2 }
  ],
  "容器安全最佳實務#3": [
   { "say": "建立使用者的寫法,不同的基底不太一樣。", "item": 0 },
   { "say": "如果是 Debian 或 Ubuntu 這一系,包含 python 的 slim 映像檔。", "item": 1 },
   { "say": "用 group add 和 user add,建立一個系統群組和系統使用者,名字叫 app。這個寫法我們在第三章看過。", "item": 2 },
   { "say": "然後用 USER app 切換過去。", "item": 3 },
   { "say": "如果是 Alpine 這一系,指令的名稱不一樣。", "item": 4 }
  ],
  "容器安全最佳實務#4": [
   { "say": "來看 Alpine 的寫法。", "item": 0 },
   { "say": "它用的是 add group 和 add user,順序反過來,加上減號大寫 S,表示建立系統帳號。", "item": 1 },
   { "say": "同樣再用 USER app 切換。", "item": 2 },
   { "say": "第三種方式是直接用數字的 U I D。用 scratch,或是不確定映像檔裡有哪些使用者名稱的時候,就用這種。", "item": 3 }
  ],
  "容器安全最佳實務#5": [
   { "say": "數字的寫法長這樣。", "item": 0 },
   { "say": "USER 後面直接寫使用者編號冒號群組編號,這裡兩個都是一萬零一。部分官方映像檔已經內建非 root 的使用者,像 node 映像檔裡的 node,那就直接拿來用。", "item": 1 }
  ],
  "容器安全最佳實務#6": [
   { "say": "第二條,執行的時候再把權限收緊。這一頁是一個 docker run 的範例,我們看它加了哪些選項,下一頁再解釋每一個的意思。", "item": 0 },
   { "say": "第一組,read only 加上 T M P F S,把根檔案系統設成唯讀,只留一個暫存目錄可以寫。", "item": 1 },
   { "say": "第二個,cap drop ALL,把所有的特殊權限都拿掉。", "item": 2 },
   { "say": "第三個,security opt 設定 no new privileges,禁止提升權限。", "item": 3 },
   { "say": "第四組是資源上限,限制程序的數量、記憶體和 C P U。", "item": 4 },
   { "say": "最後,埠只發布在本機位址上。", "item": 5 }
  ],
  "容器安全最佳實務#7": [
   { "say": "現在逐項說明。", "item": 0 },
   { "say": "read only 讓根檔案系統變成唯讀,攻擊者就沒辦法隨意寫入或竄改檔案。真的需要寫的目錄,用 T M P F S 或 volume 來提供。", "item": 1 },
   { "say": "cap drop ALL 會拿掉所有的 Linux capabilities,也就是細分的特權。有需要的再用 cap add 一個一個加回來,例如要綁特權埠的時候,才加上綁定網路埠的那一項。", "item": 2 },
   { "say": "no new privileges,是禁止程序透過 set U I D 這類方式提升權限。", "item": 3 },
   { "say": "設定資源上限,則是避免容器被拿來耗盡主機的資源。", "item": 4 },
   { "say": "還有兩個提醒。永遠避免使用 privileged 這個選項,它幾乎關掉所有隔離,容器等於拿到主機的 root 權限。另外,預設的 sec comp 和 AppArmor 設定檔是保護網,不要為了圖方便把它們關掉。", "item": 4 }
  ],
  "Registry:標記、推送與私有倉庫#1": [
   { "say": "第三個單元來談 registry。映像檔建好之後,要讓別的機器拿得到,像是測試機、正式機或同事的電腦,就得放到 registry。它就像程式碼的 Git 遠端倉庫。常見的選擇有這些。", "item": 0 },
   { "say": "Docker Hub,最大的公開 registry,也支援私有倉庫。不過免費方案的私有倉庫數量有限制,匿名拉取也有頻率的限制。", "item": 1 },
   { "say": "GitHub 和 GitLab 的 Container Registry,和程式碼平台整合在一起,搭配 C I 很方便。", "item": 2 },
   { "say": "各家雲端廠商也都有自己的 registry,像 A W S、Google 和 Azure。", "item": 3 },
   { "say": "也可以自己架。簡單的用官方的 registry 映像檔,企業級的可以用 Harbor,它有權限控管、漏洞掃描和複寫的功能。", "item": 4 }
  ],
  "Registry:標記、推送與私有倉庫#2": [
   { "say": "要推送,得先知道完整的映像檔名稱怎麼寫。", "item": 0 },
   { "say": "推送之前,映像檔的名稱必須帶有目標 registry 和命名空間。所以通常要先用 docker tag 取一個完整的名字,再 push。", "item": 1 },
   { "say": "格式是,registry 的主機,必要時加上埠號,斜線,命名空間,斜線,名稱,最後冒號接 tag。", "item": 2 },
   { "say": "第一個例子是推到 Docker Hub,某個組織底下的 web,版本一點零。", "item": 3 },
   { "say": "第二個例子,主機換成 GitHub 的 Container Registry。", "item": 4 },
   { "say": "第三個例子,是推到本機五千號埠上自己架的 registry。", "item": 5 }
  ],
  "Registry:標記、推送與私有倉庫#3": [
   { "say": "接下來以 Docker Hub 為例,說明登入和推送。指令在下一頁,這裡先講憑證的安全,這很重要。", "item": 0 },
   { "say": "第一,自動化流程請使用存取權杖,不要用帳號密碼。而且權杖的權限給到最小,例如只能讀,或是只能寫某個特定的倉庫。", "item": 1 },
   { "say": "第二,在 C I 裡面,用標準輸入把權杖傳進去,避免它出現在指令列和歷史紀錄裡。", "item": 2 },
   { "say": "第三,如果沒有設定 credential helper,登入資訊會用 base 六十四的形式,存在家目錄底下 docker 的設定檔裡。那等同於明文,請保護好這個檔案,並且設定 credential helper,例如使用系統的鑰匙圈。", "item": 3 },
   { "say": "第四,用完記得登出,指令是 docker logout。", "item": 4 }
  ],
  "Registry:標記、推送與私有倉庫#4": [
   { "say": "看實際的流程。", "item": 0 },
   { "say": "docker login 加上減號 U,後面接你的帳號。", "item": 1 },
   { "say": "它會請你輸入密碼,這裡請貼上存取權杖。", "item": 2 },
   { "say": "看到 Login Succeeded 就是登入成功。", "item": 3 },
   { "say": "接著用 docker tag,把本機的 my app 一點零,加上一個帶有你帳號的新名字。", "item": 4 },
   { "say": "再用 docker push,把這個新名字推上去。", "item": 5 }
  ],
  "Registry:標記、推送與私有倉庫#5": [
   { "say": "推上去之後。", "item": 0 },
   { "say": "在任何一台機器上,用 docker pull 加上同樣的名字,就可以把它拉下來。", "item": 1 },
   { "say": "第二行就是剛才說的 C I 寫法。用 echo 把存在變數裡的權杖印出來,透過管線符號交給 docker login,並且加上 password stdin 這個選項,讓它從標準輸入讀取密碼。", "item": 2 }
  ],
  "Registry:標記、推送與私有倉庫#6": [
   { "say": "映像檔的標籤該怎麼取,也是一門學問,我們來看標籤策略。", "item": 0 },
   { "say": "第一,用不可變的版本號,例如一點四點二這種語意化版本。另外可以再加上浮動的標籤,像一點四或是一,方便使用者跟上小版本的更新。", "item": 1 },
   { "say": "第二,和程式碼對應。在標籤後面加上 Git commit 的短雜湊,出問題的時候可以追溯到是哪一版程式碼。", "item": 2 },
   { "say": "第三,dev、staging、prod 這類環境標籤,不要當作唯一的識別。不同環境,應該用同一個不可變的映像檔,搭配不同的設定來區分。", "item": 3 },
   { "say": "第四,避免覆蓋已經發布的版本標籤。不然同一個 tag,在不同時間代表不同的內容,很難回溯和重現問題。", "item": 4 },
   { "say": "第五,latest 只當作方便用的標籤。正式部署,請引用明確的版本或是 digest。", "item": 5 }
  ],
  "Registry:標記、推送與私有倉庫#7": [
   { "say": "最後,我們自己架一個簡易的私有 registry。請注意,這個做法只限於學習和內部網路。用 docker run 啟動官方的 registry 映像檔,把五千號埠只發布在本機位址。", "item": 0 },
   { "say": "並且掛上一個叫 registry data 的 volume,用來保存推上來的映像檔。之後就可以把映像檔 tag 成 localhost 五千開頭的名字,推上去再拉回來試試看。", "item": 1 },
   { "say": "有幾個要點。對 localhost 的五千號埠,Docker 預設允許不使用 H T T P S。", "item": 2 },
   { "say": "但是要讓其他主機使用,就必須設定 T L S 憑證和帳號驗證。千萬不要把沒有驗證的 registry 暴露到網路上,否則任何人都可以拉取,甚至覆蓋你的映像檔。", "item": 3 },
   { "say": "也不建議為了方便,把它設成 insecure registry,關掉 T L S 驗證,那會讓傳輸的內容可能被竊聽或竄改。", "item": 4 },
   { "say": "正式的用途,建議使用雲端的 registry 或 Harbor,並且設定好權限、保留政策、漏洞掃描和備份。", "item": 4 }
  ],
  "closing": [
   { "say": "這一章就到這裡。你已經知道怎麼選基底、用多階段建置幫映像檔瘦身,記住了不用 root、收緊權限這些安全做法,也會把映像檔推到 registry 了。", "item": 0 },
   { "say": "接下來,請到實作練習親手操作一次,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1 }
  ]
 }
}
