HCL Domino 容器化轉型中的 One-Touch Setup (OTS) 優化：等待逾時配置化方案

隨著企業 IT 架構向雲原生（Cloud Native）演進，HCL Domino 的部署模式也從傳統的實體機或虛擬機（VM）轉向容器化。在自動化部署流程中，One-Touch Setup (OTS) 是實現無人值守安裝與配置的核心機制。然而，在複雜的企業級網路環境或資源受限的邊緣運算場景中，啟動過程中的資源競爭常導致 OTS 逾時失敗。本文將深入探討如何透過配置化方案解決 Domino 容器在 OTS 階段的等待逾時問題，並結合 Podman 等新一代容器引擎的安全性優勢進行架構優化。

容器啟動瓶頸：OTS 等待機制的必要性

在 Domino 容器啟動時，系統會偵測是否存在 setup.json 檔。如果偵測到該檔案，Domino 會啟動 OTS 流程來自動配置伺服器 ID、組織名稱及網路設定。但在實際運作中，資料庫初始化、磁碟 I/O 延遲或網路驗證（如連接到現有的 Domino Domain）往往需要時間。如果容器內部的啟動腳本設置的逾時時間（Timeout）過於僵化，系統可能會在資源尚未完全就緒時判定失敗，導致啟動循環（Crash Loop）。

這種現象在資料科學與實驗設計領域中也有類似的類比：過早的判定「失敗」往往是基於人為設定的任意分界點（Arbitrary Cut-off），而忽略了環境變數的波動 (Domino Blog)。在 IT 工程實務中，我們不應讓硬編碼（Hard-coded）的等待時間成為系統穩定性的絆腳石，而是需要一套靈活的配置化方案。

配置化解決方案：顯式等待與隱式等待的應用

為了提高 Domino 容器的魯棒性（Robustness），我們可以參考自動化測試框架（如 Selenium）中的等待策略。在容器啟動腳本（通常是 entrypoint.sh）中，應引入以下三種等待邏輯：

強制等待（Static Sleep）： 最簡單但效率最低，不論資源是否就緒都固定等待特定秒數。
隱式等待（Implicit Wait）： 設定一個全域的最大等待時間，在該時間內不斷輪詢資源狀態。
顯式等待（Explicit Wait）： 針對特定條件（如 names.nsf 是否已建立或特定 Port 是否開放）進行偵測，一旦條件達成即停止等待並繼續執行 (Alibaba Cloud)。

在 Domino 容器環境中，建議透過環境變數（Environment Variables）來實現 OTS 的逾時配置化。例如，定義 OTS_TIMEOUT_SECONDS 與 OTS_POLL_INTERVAL，讓運維工程師能根據底層硬體效能動態調整參數，避免因網路抖動或磁碟延遲引發的配置中斷。

📂 收合（點我收起）

# 範例：在 entrypoint 腳本中實現配置化等待
TIMEOUT=${OTS_TIMEOUT_SECONDS:-300}
INTERVAL=${OTS_POLL_INTERVAL:-5}
ELAPSED=0

while [ ! -f "/local/notesdata/names.nsf" ] && [ $ELAPSED -lt $TIMEOUT ]; do
    echo "等待 Domino OTS 初始化中... ($ELAPSED/$TIMEOUT)"
    sleep $INTERVAL
    ELAPSED=$((ELAPSED + INTERVAL))
done

if [ $ELAPSED -ge $TIMEOUT ]; then
    echo "錯誤：OTS 初始化逾時"
    exit 1
fi

安全性架構升級：從 Docker 轉向 Podman

在探討 OTS 配置化的同時，資安工程師必須關注容器運行的權限問題。傳統 Docker 依賴 root 權限運行的守護進程，這在嚴格的企業內網環境中常被視為資安風險。Podman 作為一種無守護進程（Daemonless）且支援無 root 模式（Rootless）的容器引擎，正逐漸成為企業部署 Domino 的首選 (Tangly 學習筆記)。

使用 Podman 運行 Domino 容器時，OTS 流程會在非 root 用戶空間內執行。這意味著即使 OTS 腳本因逾時配置不當或潛在漏洞被利用，攻擊者也難以獲取主機系統的 root 權限。這種架構符合「最小權限原則」（Principle of Least Privilege），能有效降低企業在容器化轉型過程中的攻擊面。

風險移轉與合規性考量

在大型企業的 IT 服務委外或跨國部署中，系統的可用性（Availability）往往涉及契約法律中的「危險移轉」概念。若系統因配置逾時頻繁崩潰，可能引發交付爭議 (臺灣大學 TDR)。因此，建立一套標準化、可觀測的 OTS 啟動日誌與逾時處理機制，不僅是技術問題，更是合規與風險管理的重要環節。透過透明的逾時配置，IT 部門可以更清晰地界定是「軟體邏輯失敗」還是「底層基礎設施效能不足」。