{
 "byKey": {
  "cover": [
   { "say": "大家好,歡迎回到容器管理與應用。前面提過,容器一刪除,裡面的資料就不見了。這一章我們就來解決這個問題,學會用 volume 和 bind mount 把資料留下來,還要處理很容易卡關的權限問題。", "item": 0 }
  ],
  "為什麼資料會消失?三種儲存方式#1": [
   { "say": "先回想一下,容器的檔案系統是暫時的。映像檔的每一層都是唯讀的,容器寫入的內容,全部落在最上面的可寫層,而可寫層的壽命,是和容器綁在一起的。這會帶來幾個後果。", "item": 0 },
   { "say": "第一,刪除容器,資料就全沒了。要注意,docker restart 不會讓資料消失,但是 docker R M 會。", "item": 1 },
   { "say": "第二,可寫層的效能比較差。它是透過儲存驅動,做寫入時複製,如果要頻繁寫入大量的資料,並不理想。", "item": 2 },
   { "say": "第三,資料很難共用。別的容器沒辦法方便地讀到某個容器的可寫層。", "item": 3 },
   { "say": "第四,升級很困難。要換新版的映像檔,就得刪掉舊容器,資料也跟著一起沒了。", "item": 4 },
   { "say": "所以我們的原則是,容器本身應該可以隨時丟掉、隨時重建,需要保留的資料,就放在容器外面。", "item": 4 }
  ],
  "為什麼資料會消失?三種儲存方式#2": [
   { "say": "Docker 提供三種方式,把容器外面的儲存空間接進容器。", "item": 0 },
   { "say": "第一種是 volume,由 Docker 幫你管理的儲存空間。你只要用名字來引用它,不需要知道它實際放在主機的哪個路徑。", "item": 1 },
   { "say": "第二種是 bind mount,把主機上你指定的目錄或檔案,直接掛進容器,路徑由你自己決定。比如說,把家目錄底下的 site 資料夾,掛到 engine X 放網頁的目錄。", "item": 2 },
   { "say": "第三種是 T M P F S,它是放在主機記憶體裡的暫存空間,容器一停止就消失,不會寫進磁碟。適合放敏感的暫存資料,或是需要高速讀寫的暫存檔。", "item": 3 }
  ],
  "為什麼資料會消失?三種儲存方式#3": [
   { "say": "我們用一張表,把三種方式比較一下。", "item": 0 },
   { "say": "表格的三欄,依序是 volume、bind mount,還有 T M P F S。", "item": 1 },
   { "say": "先看誰來管理。volume 是 Docker 管,bind mount 是你自己管,因為用的是主機的路徑,T M P F S 則是放在記憶體裡。", "item": 2 },
   { "say": "典型的用途。volume 適合資料庫和需要長期保存的資料,bind mount 適合開發時同步程式碼,或是掛設定檔,T M P F S 就是放暫存和機密的暫存資料。", "item": 3 },
   { "say": "備份和遷移。volume 透過 docker 指令就很容易處理,bind mount 是直接操作主機上的檔案,T M P F S 則根本不保存。", "item": 4 }
  ],
  "為什麼資料會消失?三種儲存方式#4": [
   { "say": "還有兩個比較的項目。", "item": 0 },
   { "say": "對主機路徑的依賴。volume 沒有,所以搬到別台機器也能用。bind mount 有,那個路徑必須真的存在。", "item": 1 },
   { "say": "權限問題。volume 通常比較少遇到,bind mount 則很容易碰到擁有者或權限對不上的狀況,這個我們第三單元會專門處理。", "item": 2 }
  ],
  "為什麼資料會消失?三種儲存方式#5": [
   { "say": "那實際上要怎麼選呢?記住這四個情境就好。", "item": 0 },
   { "say": "資料庫、使用者上傳的檔案,還有任何需要長期保存的資料,優先用 volume。Docker 的官方文件,也建議正式環境優先使用 volume。", "item": 1 },
   { "say": "開發的時候,希望改了主機上的檔案,容器裡馬上就看得到,那就用 bind mount。", "item": 2 },
   { "say": "只需要讀取的設定檔,像是 engine X 的設定檔,用 bind mount 再搭配唯讀。", "item": 3 },
   { "say": "不想寫到磁碟上的暫存資料,就用 T M P F S。", "item": 4 }
  ],
  "為什麼資料會消失?三種儲存方式#6": [
   { "say": "掛載有兩種語法,一種是減號 V,一種是兩個減號 mount。", "item": 0 },
   { "say": "兩種寫法都能達到同樣的目的。", "item": 1 },
   { "say": "減號 V 是簡短的寫法。", "item": 2 },
   { "say": "像這一行,冒號前面是 volume 的名字 D B data,冒號後面是容器裡要掛載的路徑,也就是 Maria D B 存放資料的目錄。", "item": 3 },
   { "say": "兩個減號 mount 是比較明確的寫法,建議寫在腳本裡的時候使用。", "item": 4 },
   { "say": "它把類型、來源和目標,一項一項用名稱寫清楚,雖然比較長,但是一看就懂。", "item": 5 },
   { "say": "兩者還有一個差別。用減號 V 掛一個不存在的主機路徑,Docker 會自動幫你建一個屬於 root 的目錄。用 mount 指定 bind 類型則會直接報錯,比較不會因為路徑打錯,悄悄多出一堆奇怪的目錄。", "item": 5 }
  ],
  "為什麼資料會消失?三種儲存方式#7": [
   { "say": "做個小結。", "item": 0 },
   { "say": "容器的可寫層是暫時的。要持久保存資料用 volume,開發同步和掛設定檔用 bind mount,暫存用 T M P F S。下一個單元,我們專心練習 volume 的操作,還會用資料庫當例子。", "item": 1 }
  ],
  "Volume 操作:資料庫持久化實例#1": [
   { "say": "好,來看 volume 的管理指令,都是 docker volume 開頭,詳細的在下一頁。", "item": 0 },
   { "say": "先知道一件事,你不一定要事先建立 volume。在 docker run 用減號 V 指定一個還不存在的名字,Docker 會自動幫你建立。", "item": 1 }
  ],
  "Volume 操作:資料庫持久化實例#2": [
   { "say": "我們一個一個看。", "item": 0 },
   { "say": "docker volume create,後面接名字,建立一個叫 D B data 的 volume。", "item": 1 },
   { "say": "docker volume L S,列出目前所有的 volume。", "item": 2 },
   { "say": "輸出有兩欄,驅動程式和 volume 的名稱。", "item": 3 },
   { "say": "可以看到我們剛建立的 D B data,驅動是 local,代表存在本機。", "item": 4 },
   { "say": "docker volume inspect,可以看詳細資訊,例如它在主機上實際的掛載點。", "item": 5 }
  ],
  "Volume 操作:資料庫持久化實例#3": [
   { "say": "再來是兩個刪除的指令。", "item": 0 },
   { "say": "docker volume R M 是刪除指定的 volume,前提是沒有任何容器正在使用它。", "item": 1 },
   { "say": "docker volume prune,會刪除所有沒有被容器使用的 volume。這個指令很危險,資料刪了就回不來,執行之前請一定要先確認。", "item": 2 }
  ],
  "Volume 操作:資料庫持久化實例#4": [
   { "say": "接下來做一個實例,讓 Maria D B 的資料活下來。Maria D B 的官方映像檔,把資料放在容器裡的一個固定目錄,我們就把一個具名的 volume 掛在那裡。啟動的時候要給三個選項。", "item": 0 },
   { "say": "第一個用減號 E 設定 root 的密碼。畫面上的密碼只是占位符,請自己用密碼管理器產生一組強密碼,不要用簡單的密碼。", "item": 1 },
   { "say": "第二個也是減號 E,指定一開始要建立的資料庫,名字叫 app D B。", "item": 2 },
   { "say": "第三個是減號 V,把 D B data 這個 volume,掛到資料庫存放資料的目錄。這一行就是資料能不能留下來的關鍵。", "item": 3 }
  ],
  "Volume 操作:資料庫持久化實例#5": [
   { "say": "我們實際操作一次。", "item": 0 },
   { "say": "先用 docker run 在背景啟動容器,名字取做 D B,後面帶上剛剛說的那三個選項。", "item": 1 },
   { "say": "接著用 docker exec 加減號 I T,在容器裡執行資料庫的用戶端程式,用 root 登入 app D B 這個資料庫。", "item": 2 },
   { "say": "它會請你輸入密碼,打上剛剛設定的那一組就可以進去了。", "item": 3 }
  ],
  "Volume 操作:資料庫持久化實例#6": [
   { "say": "進到資料庫之後,寫一筆資料進去。", "item": 0 },
   { "say": "第一句 S Q L 是建立一張叫 notes 的資料表,裡面有編號和內容兩個欄位。", "item": 1 },
   { "say": "第二句是新增一筆資料,內容寫的是,資料要活下來。", "item": 2 },
   { "say": "然後輸入 exit 離開。", "item": 3 }
  ],
  "Volume 操作:資料庫持久化實例#7": [
   { "say": "現在來驗證資料是不是真的留得住。", "item": 0 },
   { "say": "先用 docker R M 加減號 F,把整個容器強制刪掉。", "item": 1 },
   { "say": "再用 docker run 建一個全新的容器,重點是,接上同一個 volume。", "item": 2 },
   { "say": "然後進去查詢 notes 這張表,你會發現資料還在。這就證明,資料的生命週期已經和容器脫鉤了。", "item": 3 },
   { "say": "所以以後要換新版的映像檔,資料也能保留。不過提醒一下,資料庫要升級大版本之前,請先備份,並且讀過官方的升級說明。", "item": 3 }
  ],
  "Bind Mount、tmpfs 與權限問題#1": [
   { "say": "第三個單元來看 bind mount,把主機的目錄接進容器。最經典的用法,就是讓 engine X 提供主機上某個目錄裡的網頁。這樣你直接改主機上的檔案,重新整理網頁就看得到變化,不用重建容器,也不用重建映像檔。", "item": 0 },
   { "say": "關鍵是這一行減號 V。冒號前面是主機上的 site 目錄,中間是容器裡放網頁的目錄,最後還多了一段 R O。", "item": 1 },
   { "say": "有幾個要點。第一,來源一定要寫絕對路徑,可以用 HOME 變數或 P W D 指令來展開。不然它會被當成一個具名 volume 的名字。", "item": 2 },
   { "say": "第二,結尾的 R O 代表唯讀。容器只需要讀的東西,像設定檔、靜態網站,一律加上唯讀,萬一被入侵,能造成的損害就小很多。", "item": 3 },
   { "say": "第三,路徑裡面有空白的話,記得加上引號。", "item": 4 },
   { "say": "同樣的掛載,也可以用兩個減號 mount 來寫,把類型指定為 bind,寫上來源和目標,最後加上 readonly。", "item": 5 }
  ],
  "Bind Mount、tmpfs 與權限問題#2": [
   { "say": "實際做一次。", "item": 0 },
   { "say": "先用 M K D I R 在家目錄底下建立 site 這個資料夾。", "item": 1 },
   { "say": "再用 echo 搭配大於符號,寫一個簡單的首頁檔進去,內容是一行標題,寫著 Bind mount works。", "item": 2 },
   { "say": "然後用 docker run 啟動 engine X,把主機的八零八零號埠對到容器的八十號埠,並且帶上剛才那一行唯讀的掛載。", "item": 3 }
  ],
  "Bind Mount、tmpfs 與權限問題#3": [
   { "say": "來驗證一下。", "item": 0 },
   { "say": "用 curl 連本機的八零八零號埠。", "item": 1 },
   { "say": "回來的就是我們剛剛寫的那一行標題,表示容器讀到的,確實是主機上的檔案。", "item": 2 }
  ],
  "Bind Mount、tmpfs 與權限問題#4": [
   { "say": "bind mount 不只能掛目錄,也可以只掛單一個檔案,最常見的就是設定檔。", "item": 0 },
   { "say": "像這一行,把目前目錄底下的 engine X 設定檔,用唯讀的方式,掛到容器裡設定檔原本的位置。", "item": 1 },
   { "say": "其他部分和剛才啟動 engine X 的指令一樣。", "item": 2 },
   { "say": "要注意一個陷阱。如果這個設定檔在主機上不存在,用減號 V 的話,Docker 會建立一個同名的目錄,而不是檔案,結果 engine X 就啟動失敗。所以請先確認檔案存在,或是改用 mount 寫法,它會直接報錯提醒你。", "item": 2 }
  ],
  "Bind Mount、tmpfs 與權限問題#5": [
   { "say": "用 bind mount 最常遇到的,就是權限問題。Linux 是用數字的 U I D 和 G I D 來判斷檔案的擁有者,容器和主機共用同一套數字,只是對應的名字可能不同。", "item": 0 },
   { "say": "常見的狀況有兩種。第一種,容器裡的程式用一千號使用者執行,可是掛進去的主機目錄屬於 root,容器就寫不進去,出現 Permission denied。", "item": 1 },
   { "say": "第二種剛好相反。容器用 root 寫進 bind mount,主機上就出現一堆 root 擁有的檔案,你自己反而改不了。", "item": 2 },
   { "say": "處理的方式有三個。第一個,讓容器用和主機相符的使用者來執行,也就是在 docker run 加上減號 U,帶入你自己的 U I D 和 G I D。", "item": 3 }
  ],
  "Bind Mount、tmpfs 與權限問題#6": [
   { "say": "再看另外兩個處理方式。", "item": 0 },
   { "say": "第二個,用 sudo chown 調整主機目錄的擁有者,改成容器裡使用的那個編號。執行之前請確認路徑,千萬別打錯。", "item": 1 },
   { "say": "第三個,乾脆用具名 volume 取代 bind mount,交給 Docker 管理,常常就能避開這類麻煩。", "item": 2 },
   { "say": "千萬不要為了讓它能寫,就把權限全部開成七七七,那等於把大門整個打開。", "item": 2 },
   { "say": "另外補充,在有啟用 S E Linux 的系統上,bind mount 可能要在後面多加一個 Z 的選項才讀得到。還有,Docker Desktop 的檔案共享效能比較差,大量小檔案的操作,建議放在 volume。", "item": 2 }
  ],
  "Bind Mount、tmpfs 與權限問題#7": [
   { "say": "最後要提醒,bind mount 讓容器碰得到主機的檔案,所以有些掛法非常危險。", "item": 0 },
   { "say": "第一,永遠不要把根目錄、系統設定目錄、root 的家目錄,或是你自己的整個家目錄,掛進不信任的容器。", "item": 1 },
   { "say": "第二,不要把 docker 點 sock 掛進容器,除非你非常清楚後果。能操作這個 socket 的容器,就等於控制了整台主機。", "item": 2 },
   { "say": "第三,要把含有機密的路徑,像是放 S S H 金鑰的目錄,掛給容器之前,請再三確認。", "item": 3 }
  ],
  "closing": [
   { "say": "這一章就到這裡。你已經知道資料為什麼會消失,會用 volume 保存資料庫的資料,會用 bind mount 掛目錄和設定檔,也知道權限對不上的時候該怎麼處理。", "item": 0 },
   { "say": "接下來,請到實作練習親手操作一次,再完成章末小測驗,看看自己學會了多少。我們下一章見!", "item": 1, "pause": 1 }
  ]
 }
}
