{
 "byKey": {
  "cover": [
   {"say":"大家好,歡迎回到 Linux A I 助理開發實戰。這一章要做服務管理。我們會用 system D 查詢服務狀態,檢查 Apache 和 Nginx,檢查 MySQL 和 MongoDB,最後做一個受到嚴格控管的服務重啟功能。","item":0}
  ],
  "systemd 與 systemctl 唯讀查詢#1": [
   {"say":"Nginx 還活著嗎?有沒有服務掛掉?這是維運人員每天都在問的問題。Ubuntu 用 system D 管理服務,查詢的入口是 system C T L。","item":0},
   {"say":"要給程式讀的時候,請用 show 這個子指令,它的輸出是一行一組的屬性和值,不要去解析給人看的 status。有幾個重要的細節。","item":0},
   {"say":"第一,就算服務不存在,show 還是會執行成功,退出碼是零,只是載入狀態會顯示找不到。所以一定要檢查載入狀態,不能只看退出碼。","item":1},
   {"say":"第二,活動狀態常見的值有 active、inactive、failed,還有啟動中和停止中。子狀態會更細,像是 running、exited、dead。","item":2},
   {"say":"第三,有一個屬性記錄自動重啟的次數,很適合用來發現那種一直當掉、又被拉起來的服務。Ubuntu 二二點零四和二四點零四的版本都有支援。","item":3},
   {"say":"第四,單元檔狀態如果是 enabled,代表開機會自動啟動。這跟它現在有沒有在執行,是兩件事。","item":4}
  ],
  "systemd 與 systemctl 唯讀查詢#2": [
   {"say":"再來看列出失敗服務時的指令選項,還有常見的錯誤。","item":0},
   {"say":"列出失敗服務的時候,我們加了三個選項。一個去掉表頭和頁尾,一個去掉前面的圓點符號,還有一個是不要使用分頁器。沒有加最後這個,指令可能會卡在分頁器等待輸入,一直到逾時。所以請養成習慣,一律加上。","item":1},
   {"say":"常見錯誤的第一個,就是去解析 status 的文字輸出。它有顏色、有縮排,格式還會隨版本改變。","item":2},
   {"say":"第二個,只看退出碼。前面說過,找不到的服務,退出碼也是零。","item":3},
   {"say":"第三個,把 inactive 一律當成故障。有些只跑一次的服務,執行完本來就會是已結束,或是 inactive 的狀態。","item":4}
  ],
  "systemd 與 systemctl 唯讀查詢#3": [
   {"say":"還有兩個設計上的錯誤要避免。","item":0},
   {"say":"第一,假設服務名稱在所有發行版都一樣。像 S S H 服務,在 Ubuntu 和 Red Hat 系列的名稱就不同,MySQL 和 MariaDB 的單元名稱也不一樣。名稱的對照要放在設定裡,不要直接寫死在程式邏輯中。","item":1},
   {"say":"第二,讓同一個工具同時支援查狀態和重啟。查詢和變更,一定要是不同的工具,這樣才能分別設定風險等級和確認機制。","item":2}
  ],
  "systemd 與 systemctl 唯讀查詢#4": [
   {"say":"我們先看 show 指令實際的輸出。","item":0},
   {"say":"這一行指令,是查詢 nginx 這個服務,並且用屬性選項,指定只要四個欄位,最後加上不使用分頁器。","item":1},
   {"say":"第一行輸出是載入狀態,loaded 代表單元檔有正確載入。","item":2},
   {"say":"第二行是活動狀態,active 代表啟用中。","item":3},
   {"say":"第三行是子狀態,running 代表正在執行。","item":4},
   {"say":"第四行是主程序的編號。每一行都是屬性名稱、等號、再接上值,程式非常好解析。","item":5}
  ],
  "systemd 與 systemctl 唯讀查詢#5": [
   {"say":"接著來看服務工具的程式,它放在 tools 資料夾的 services 檔案裡。","item":0},
   {"say":"第一行,從註冊中心匯入 register 和 Tool Error。","item":1},
   {"say":"第二行,從第五章的安全執行模組,匯入 run C M D 這個函式。","item":2},
   {"say":"然後定義一個受管理的服務清單。裡面列了 nginx、apache、mysql、mariadb、mongo D 和 S S H,每一個都對應到它的單元名稱和連接埠。最安全的設計,就是由這份設定來決定可以管理哪些服務。","item":3}
  ],
  "systemd 與 systemctl 唯讀查詢#6": [
   {"say":"清單後面,還有一個常數。","item":0},
   {"say":"大括號結束,服務清單就定義完成了。","item":1},
   {"say":"這個常數列出我們要查的屬性,包含載入狀態、活動狀態、子狀態、是否開機啟動、主程序編號、重啟次數、結果,還有進入啟用狀態的時間。","item":2}
  ],
  "systemd 與 systemctl 唯讀查詢#7": [
   {"say":"接下來是三段函式。","item":0},
   {"say":"第一個小函式負責呼叫 show,把輸出的每一行,用第一個等號切開,整理成字典。","item":1},
   {"say":"第二段是登錄工具,名稱是查詢服務狀態。參數的服務名稱用列舉值限制,只能從受管理的清單裡面選。這同時也是給模型的提示,它就不會憑空編造服務名稱。","item":2},
   {"say":"函式本體先查狀態。如果找不到,就回傳沒有安裝。有安裝的話,回傳是否執行中、是否開機啟動、主程序編號、重啟次數這些資訊。因為單元名稱來自我們的字典,不是模型給的,所以不可能被注入。使用之前,記得把 system C T L 放進第五章的執行檔白名單。","item":3}
  ],
  "Apache 與 Nginx 檢查#1": [
   {"say":"第二個單元,檢查 Apache 和 Nginx。要先有一個觀念,system D 顯示 active,只代表主程序還在,不等於服務正常。使用者連不連得上,還要看三層。連接埠有沒有在監聽、H T T P 有沒有回應、設定檔正不正確。越底層的越先檢查。來看常見的錯誤。","item":0},
   {"say":"第一,只看到 active,就回報一切正常。","item":1},
   {"say":"第二,讓模型提供網址。這樣攻擊者就能誘導助理,去存取雲端的中繼資料位址,或是內網的服務,這種攻擊叫做 S S R F。所以網址一定要完全由程式決定,而且不跟隨轉址。","item":2},
   {"say":"第三,為了讓設定檔檢查的指令可以通過,就用 root 來執行整個助理。正確的做法是精準授權單一指令。","item":3},
   {"say":"第四,忽略了 Nginx 和 Apache 同時存在、搶同一個八十埠的情況。這時候其中一個會啟動失敗,在日誌裡會看到位址已經被使用的訊息。","item":4}
  ],
  "Apache 與 Nginx 檢查#2": [
   {"say":"還有一個很容易誤會的地方。","item":0},
   {"say":"就是把設定檔語法檢查通過,當成服務可以正常運作。語法正確,不代表憑證檔存在,也不代表上游的服務連得上。","item":1}
  ],
  "Apache 與 Nginx 檢查#3": [
   {"say":"我們來看三層檢查的程式。第一層是連接埠。","item":0},
   {"say":"先匯入 socket 模組。","item":1},
   {"say":"這個函式會直接嘗試連線到本機的指定埠,兩秒逾時,連得上就回傳 True,連不上就回傳 False,完全不需要提升權限。要注意,如果服務只綁定在特定的位址,連本機位址會失敗,可是服務其實是正常的,所以結果要跟設定檔一起解讀。","item":2}
  ],
  "Apache 與 Nginx 檢查#4": [
   {"say":"第二層是 H T T P 探測。","item":0},
   {"say":"先匯入計時用的 time,還有標準函式庫裡處理網址請求和錯誤的模組。","item":1},
   {"say":"然後定義一個不跟隨轉址的處理器。這是刻意的設計,不然一個轉址,就可能把請求帶到外部去。","item":2}
  ],
  "Apache 與 Nginx 檢查#5": [
   {"say":"接著用這個處理器來發出請求。","item":0},
   {"say":"這一行建立一個專用的開啟器,套用剛剛不跟隨轉址的設定。","item":1},
   {"say":"探測函式只接受埠號,網址由程式自己組出來,固定連到本機。它會記錄狀態碼和花費的毫秒數。就算拿到四開頭或五開頭的狀態碼,也代表伺服器有回應。五開頭要視為異常,四開頭通常只是首頁沒有內容,要看情境判斷。","item":2}
  ],
  "Apache 與 Nginx 檢查#6": [
   {"say":"第三層是設定檔的語法檢查。在重新載入之前先測試設定,是避免把線上服務搞壞的關鍵。","item":0},
   {"say":"這個字典記錄兩種伺服器的測試指令。Nginx 是執行檔加上減號 T,Apache 是 apache 二 C T L 加上 config test,而且都用絕對路徑。","item":1},
   {"say":"然後登錄工具,描述寫明是測試設定檔語法是否正確,不會套用變更。服務名稱同樣用列舉值,只能選 nginx 或 apache。","item":2}
  ],
  "Apache 與 Nginx 檢查#7": [
   {"say":"最後看這個工具的函式本體。","item":0},
   {"say":"它透過 sudo 來執行測試指令,因為這兩個指令,一般使用者通常沒辦法執行,需要 sudoers 的精準授權。sudo 加上減號 N,代表不要詢問密碼,沒有授權就馬上失敗,不會卡在密碼提示那邊。","item":1},
   {"say":"另外,測試結果是寫在錯誤輸出裡的,所以要把標準輸出和錯誤輸出合併起來看,最後只回傳最後面一千五百個字元。至於網站日誌的讀取和遮罩,我們留到第八章處理。","item":1}
  ],
  "MySQL 與 MongoDB 狀態檢查#1": [
   {"say":"第三個單元,資料庫的檢查。資料庫比網站服務更敏感,因為裡面是業務資料。所以檢查的設計是由淺入深,盡量不用帳號密碼。","item":0},
   {"say":"第一層,看 system D 的狀態,單元是不是 active。MySQL、MariaDB、MongoDB 的單元名稱各不相同,實際的名稱請在你的系統上確認,再放進設定。","item":1},
   {"say":"第二層,看連接埠連不連得上。MySQL 預設是三三零六埠,MongoDB 預設是二七零一七埠。這一步完全不需要帳號密碼。","item":2},
   {"say":"第三層是應用層的 ping,這是選配的。需要憑證的時候,要使用專用的低權限監控帳號。","item":3},
   {"say":"也就是在資料庫裡建立一個只有最低權限的監控帳號,例如只允許從本機連線,只能執行狀態查詢。實際的授權語法會因為版本而不同,請以各資料庫的官方文件為準。","item":4}
  ],
  "MySQL 與 MongoDB 狀態檢查#2": [
   {"say":"關於憑證的處理,還有兩個建議,以及兩個絕對不要犯的錯。","item":0},
   {"say":"第一個建議,密碼由環境變數提供,或是放在權限六零零的設定檔裡。","item":1},
   {"say":"第二個建議,查詢語句是程式裡固定的常數。模型只能選擇要不要檢查,不能決定要查什麼。","item":2},
   {"say":"常見錯誤的第一個,是用資料庫的 root 帳號來做監控。","item":3},
   {"say":"第二個,是把密碼放在指令的參數裡。這樣任何人只要列出程序,就看得到密碼。","item":4}
  ],
  "MySQL 與 MongoDB 狀態檢查#3": [
   {"say":"再看三個常見錯誤。","item":0},
   {"say":"第一,把資料庫綁定到所有的網路位址,又沒有防火牆,而助理只回報連接埠可以連線,所以正常。這個埠該不該對外開放,是第十二章資安檢查要處理的另一個問題。","item":1},
   {"say":"第二,以為 MariaDB 和 MySQL 的單元名稱、狀態查詢指令完全一樣,沒有查證就寫死。","item":2},
   {"say":"第三,重啟資料庫。資料庫重啟的風險很高,這門課的助理不提供這個操作。","item":3}
  ],
  "MySQL 與 MongoDB 狀態檢查#4": [
   {"say":"來看資料庫檢查的程式。","item":0},
   {"say":"先登錄工具,描述是檢查資料庫服務是不是在執行中,而且連接埠可以連線。資料庫名稱一樣用列舉值限制。","item":1},
   {"say":"函式本體沿用前面的服務清單和連接埠檢查,回傳是否安裝、活動狀態、重啟次數,還有埠是否可以連線。如果服務是 active,埠卻連不上,助理應該提示去看日誌,而不是自己猜原因。","item":2},
   {"say":"下面開始是 MySQL 的深入檢查,這是選配的,需要另外安裝 py mysql 這個套件,所以先匯入 O S 和它。","item":3}
  ],
  "MySQL 與 MongoDB 狀態檢查#5": [
   {"say":"接著看兩種資料庫的應用層檢查。","item":0},
   {"say":"MySQL 的深入檢查函式,帳號和密碼都從環境變數讀取,連線和讀取都設了三秒逾時。它只執行一句固定的狀態查詢,看目前有幾個連線,最後一定會把連線關掉。","item":1},
   {"say":"再來是 MongoDB 的範例,同樣是選配。先匯入 O S。","item":2},
   {"say":"再從 py mongo 套件匯入 Mongo Client。","item":3}
  ],
  "MySQL 與 MongoDB 狀態檢查#6": [
   {"say":"最後是 MongoDB 的 ping 函式。","item":0},
   {"say":"它的連線字串裡含有帳號密碼,所以也是放在環境變數裡,並且設定兩秒逾時,然後對資料庫送出一個 ping 指令,結束時把連線關閉。","item":1},
   {"say":"提醒一下,回傳給模型的只要結論就好,例如連線成功、目前有十二個連線。不要回傳資料表內容、使用者清單,或是完整的連線字串。錯誤訊息也要簡化成無法連線這樣的短句。","item":1}
  ],
  "受控的服務重啟#1": [
   {"say":"最後一個單元,受控的服務重啟。重啟服務會中斷連線,設定有錯的話,甚至會啟動不起來。如果讓模型想重啟就重啟,一次誤判或是一次提示詞注入,就可能造成事故。所以我們訂了五條規則。","item":0},
   {"say":"第一,預設唯讀。會改變狀態的工具要另外標記,註冊中心會強制要求人工確認。","item":1},
   {"say":"第二,只提供必要、而且風險可以控制的動作,也就是 Nginx 和 Apache 的重新載入和重新啟動。資料庫不提供重啟,需要的時候由人直接操作。","item":2},
   {"say":"第三,執行之前先做設定檢查,執行之後再檢查一次狀態。","item":3},
   {"say":"第四,要有冷卻時間,避免模型在迴圈裡連續重啟。","item":4},
   {"say":"第五,用專用的低權限帳號執行,提升權限只靠 sudoers 的精準授權。","item":5}
  ],
  "受控的服務重啟#2": [
   {"say":"sudoers 的規則怎麼寫,有四個要點。","item":0},
   {"say":"第一,命令一定要寫絕對路徑,參數也要一個一個列出來。有列參數的條目,sudoers 會要求完全相符。路徑請在你自己的系統上確認。","item":1},
   {"say":"第二,絕對不要用星號萬用字元,也不要寫成免密碼執行所有指令。更不要授權 shell、編輯器,或是複製檔案這一類的萬用工具,因為它們可以被用來逃逸成 shell。","item":2},
   {"say":"第三,這個檔案的權限要設成四四零。可以用 V I sudo 檢查語法,再用 sudo 的列表功能,檢視這個帳號被授權了什麼。","item":3},
   {"say":"第四,另外一種做法是用 polkit 的規則,授權特定單元的管理,適合不想用 sudo 的情境。細節請參考官方文件。","item":4}
  ],
  "受控的服務重啟#3": [
   {"say":"這個單元的常見錯誤有五個。","item":0},
   {"say":"第一,授權 sudo 的時候偷懶,用了萬用字元。","item":1},
   {"say":"第二,讓助理帳號擁有完整的 sudo 權限。","item":2},
   {"say":"第三,確認訊息由模型來產生。確認畫面要顯示的,是實際的工具和參數。","item":3},
   {"say":"第四,沒有冷卻時間和審計。一旦模型陷入迴圈,服務就會被連續重啟。","item":4},
   {"say":"第五,重啟之前沒有先測試設定。設定壞了,就把原本正常運作的舊程序換掉了。","item":5}
  ],
  "受控的服務重啟#4": [
   {"say":"我們來看實際的設定步驟。先建立專用帳號。","item":0},
   {"say":"第一行指令,建立一個系統帳號,有家目錄,但是登入的 shell 設成不能登入。","item":1},
   {"say":"第二行,把它加進兩個群組,目的是讓它可以讀取日誌,第八章會用到。","item":2},
   {"say":"第三行,用 V I sudo 編輯 sudoers 目錄底下的專屬檔案。一定要用 V I sudo 來編輯,因為語法一旦寫錯,整個 sudo 都會壞掉。","item":3}
  ],
  "受控的服務重啟#5": [
   {"say":"檔案的內容,先定義兩組指令別名。","item":0},
   {"say":"第一組是設定測試,包含 Nginx 和 Apache 的設定檢查指令。","item":1},
   {"say":"第二組是服務控制,只列出四個指令,就是 Nginx 和 Apache 各自的重新載入和重新啟動。每一個都是絕對路徑,加上完整的參數。","item":2}
  ],
  "受控的服務重啟#6": [
   {"say":"別名定義好之後,就可以授權了。","item":0},
   {"say":"這一行的意思是,助理帳號可以用 root 的身分,免密碼執行剛剛那兩組指令,除此之外什麼都不能做。","item":1},
   {"say":"接著回到 Python 的工具實作,先匯入 time 模組。","item":2},
   {"say":"然後定義可以重啟的服務清單,只有 nginx 和 apache 兩個。","item":3}
  ],
  "受控的服務重啟#7": [
   {"say":"再來是冷卻機制和工具的登錄。","item":0},
   {"say":"這個字典用來記錄每個服務上一次操作的時間。","item":1},
   {"say":"冷卻時間設定為六十秒。","item":2},
   {"say":"然後登錄管理服務的工具,描述寫明會中斷服務、需要人工確認,並且把唯讀設成 False。函式會先檢查冷卻時間,再測試設定檔,失敗就中止。通過才用 sudo 執行,最後回傳執行之後的服務狀態。優先建議用重新載入,因為它不會中斷連線,風險比重新啟動低。","item":3}
  ],
  "closing": [
   {"say":"好,第七章就到這裡。我們的助理現在會查服務狀態、檢查網站和資料庫,也有了一個需要人工確認、有冷卻時間的重啟功能。","item":0},
   {"say":"請記得動手做練習,再完成章末的小測驗,檢查自己學會了多少。我們下一章見。","item":1}
  ]
 }
}
