處理 AI review findings 並改寫 Node.js entrypoint #1
@@ -1,12 +1,13 @@
|
||||
FROM alpine:latest
|
||||
|
||||
# 安裝必要的工具
|
||||
RUN apk add --no-cache --no-check-certificate bash ca-certificates curl git jq
|
||||
|
||||
# 設定安裝用的環境變數
|
||||
ENV CODEX_NON_INTERACTIVE=1
|
||||
|
Ghost marked this conversation as resolved
Outdated
|
||||
ENV CODEX_INSTALL_DIR=/usr/local/bin
|
||||
ENV CODEX_HOME=/root/.codex
|
||||
ENV CODEX_PLUGINS="jsc@doc jsc@code-review"
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🔵 建議 **嚴重等級**:🔵 建議
**審查員**:Bard
**問題**:環境變數散落在檔案中間,這使得 Dockerfile 的基礎配置顯得凌亂,彷彿一首詩的標題與正文糾纏不清。
**建議**:建議將所有的 `ENV` 設定集中放置在 `Dockerfile` 的頂部,讓配置一目瞭然,維持檔案配置的一致性。
|
||||
|
||||
# 安裝必要的工具
|
||||
RUN apk add --no-cache --no-check-certificate bash ca-certificates curl git jq util-linux
|
||||
|
Ghost marked this conversation as resolved
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Assassin
**問題**:Codex 外掛市集來源指向 `gitea.jsc.idv.tw`,未驗證來源的安全性。若該伺服器遭駭,將導致自動安裝惡意或篡改過的外掛,進而導致供應鏈攻擊。
**建議**:若可能,請將外掛來源固定在受信任的內部儲存庫或使用經簽署的外掛版本。確保來源伺服器具有嚴格的存取控管與安全性掃描。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:環境變數使用以空格分隔的字串,若未來名稱中包含空格將導致 shell 展開錯誤,且難以維護。
**建議**:建議改用換行符號(
)分隔,並在安裝迴圈中使用 `IFS=$'
'` 處理,以提高 shell 指令的健壯性。
|
||||
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🔴 嚴重 **嚴重等級**:🔴 嚴重
**審查員**:Maya
**問題**:新增了 Codex CLI 的安裝與插件註冊過程,但沒有對應的測試來驗證安裝是否成功、插件是否正確載入。
**建議**:應在測試套件中加入 Docker 映像檔的整合測試,驗證容器啟動後 `codex --version` 及插件列表是否存在。
|
||||
# 安裝 Codex CLI 工具
|
||||
RUN install_script="$(mktemp)" \
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🔴 嚴重 **嚴重等級**:🔴 嚴重
**審查員**:Assassin
**問題**:直接將網際網路的腳本經由 pipe 傳送給 shell 執行 (curl | sh) 極度危險,若該網址遭受劫持或供應商被駭,攻擊者可輕易於建置期間取得容器完整控制權。
**建議**:應先將腳本下載至本地,透過 sha256sum 驗證其完整性後,再以 `sh` 執行。
gitea-actions
commented
嚴重等級:🔴 嚴重 **嚴重等級**:🔴 嚴重
**審查員**:Assassin
**問題**:直接將網際網路的腳本經由 pipe 傳送給 shell 執行 (curl | sh) 極度危險,且缺乏驗證,極易導致容器建置階段遭劫持或執行惡意代碼。
**建議**:應先將腳本下載至本地,透過 sha256sum 或 gpg 驗證其完整性與來源可靠性後,再執行安裝。
|
||||
@@ -18,9 +19,8 @@ RUN install_script="$(mktemp)" \
|
||||
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Maya
**問題**:在 Dockerfile 中安裝 Codex CLI 後未進行任何檢查,若下載失敗(例如 curl 回傳成功但內容殘缺),後續的 plugin 安裝與執行將會失敗。
**建議**:在安裝指令後增加 `codex --version` 的驗證步驟,確保 CLI 已正確安裝並能正常執行。
|
||||
# 安裝技能
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:在建置映像檔時直接透過 `codex plugin marketplace add` 安裝插件,會增加映像檔建置的時間與複雜度,且若插件來源 Gitea 無法連線,映像檔就無法成功建置。
**建議**:建議將常用的插件預先打包在映像檔中,或是透過環境變數配置插件路徑,減少建置期的網絡依賴。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:在建置映像檔時直接安裝插件,會增加建置時間與複雜度,並引入對遠端 Gitea 的網路依賴。
**建議**:建議將常用的插件預先打包在映像檔中,或透過環境變數配置,減少建置期的網絡依賴。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:在建置期透過網路安裝插件,增加建置複雜度、時間,且對外部網路依賴過高,不可重現。
**建議**:建議將插件預先打包在映像檔中,或使用特定版本的 manifest 檔案管理相依性。
gitea-actions
commented
嚴重等級:🔵 建議 **嚴重等級**:🔵 建議
**審查員**:Bard
**問題**:插件安裝指令全部擠在同一個 `RUN` 指令中,缺乏視覺上的區隔,讓整個安裝流程顯得雜亂無章。
**建議**:建議使用反斜線將指令換行,並在市場加入與插件安裝之間加入空行或註解,以增強指令的可讀性。
gitea-actions
commented
嚴重等級:🔴 嚴重 **嚴重等級**:🔴 嚴重
**審查員**:Assassin
**問題**:自動化從外部 Gitea 儲存庫安裝插件,若該儲存庫被竄改,將導致攻擊者可以在執行環境中安裝並執行惡意程式碼。這是極高風險的行為。
**建議**:應限制插件來源,並在安裝前進行原始碼審查。若非必要,請將插件程式碼打包至 Docker Image 內部,避免動態安裝。
|
||||
RUN codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/doc.git \
|
||||
&& codex plugin add jsc@doc \
|
||||
&& codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/code-review.git \
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:將插件安裝邏輯分散在多個 `RUN` 指令中,若其中一個插件安裝失敗,後續的建置流程仍會嘗試執行,且可能會留下殘留狀態,導致建置結果不可預測。
**建議**:建議將相關插件安裝指令整合到單一的 `RUN` 指令中,並加入錯誤處理與清理機制,確保安裝過程的原子性。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:在 Dockerfile 中安裝 plugin 時,雖然使用了 `for` 迴圈處理變數,但直接將 plugin URL 硬編碼在 RUN 指令中。如果未來需要更換插件來源或增加插件,需要修改 Dockerfile,這增加了鏡像建置的耦合度。
**建議**:建議將 plugin 安裝路徑抽離到環境變數或專用的配置檔案中,並在 Dockerfile 中透過讀取該清單來進行安裝,提升可維護性。
|
||||
&& codex plugin add jsc@code-review
|
||||
&& for plugin in $CODEX_PLUGINS; do codex plugin add "$plugin"; done
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:插件安裝邏輯重複,直接寫死在指令中。未來若需要安裝更多插件,維護成本會隨數量線性增加,且難以管理插件版本。
**建議**:將插件清單抽離為環境變數或專用的設定檔,在 Dockerfile 中使用迴圈讀取並安裝,提升擴充性。
|
||||
|
||||
|
Ghost marked this conversation as resolved
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:插件 URL 與版本參照 (REF) 硬編碼在 Dockerfile 中,未來若需更新插件或更換來源,需重新編譯整個 Docker 映像檔,維護成本較高。
**建議**:建議將這些插件清單與版本資訊移至外部設定檔 (如 plugins.json),並在 Dockerfile 中讀取該檔案進行安裝,增加彈性。
|
||||
COPY entrypoint.sh /entrypoint.sh
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Rogue
**問題**:插件安裝指令採取連續序列執行,導致多次獨立的網路 I/O 等待,嚴重浪費建置時間(估計浪費數秒)。
**建議**:檢查 codex CLI 是否支援批次安裝,若不支援,考慮將指令改為並行處理(例如:command1 & command2 & wait)以同時發送網路請求。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Rogue
**問題**:插件安裝指令採取連續序列執行,導致多次獨立的網路 I/O 等待,嚴重浪費建置時間。
**建議**:檢查 codex CLI 是否支援批次安裝,若不支援,考慮將指令改為並行處理。
|
||||
|
||||
|
||||
@@ -8,8 +8,7 @@ die() {
|
||||
}
|
||||
|
||||
cleanup() {
|
||||
rm -f "${auth_file:-}" "${auth_path:-}" "${codex_output:-}"
|
||||
rmdir "${auth_lock:-}" 2>/dev/null || true
|
||||
rm -f "${auth_file:-}" "${auth_path:-}" "${auth_lock:-}" "${codex_output:-}"
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Maya
**問題**:MODEL 為必填參數,但缺少針對 MODEL 為空字串或未定義時的行為測試。
**建議**:應在測試案例中模擬空 MODEL 輸入,並驗證腳本是否正確拋出錯誤並以 exit 1 終止。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Bard
**問題**:清理函式 `cleanup` 內的變數命名 (`auth_file`, `auth_path`, `codex_output`, `auth_lock`) 雖清楚,但寫法稍顯瑣碎,且 `trap` 的慣用語法建議確保在變數未定義時也能安全執行。
**建議**:在 Shell 腳本中,建議統一使用 `unset` 或更簡潔的方式管理環境變數清理,並確保變數引用更具彈性。
|
||||
}
|
||||
|
||||
trap cleanup EXIT
|
||||
@@ -29,9 +28,10 @@ umask 077
|
||||
|
||||
auth_file="$(mktemp "$CODEX_HOME/auth.XXXXXX")"
|
||||
auth_path="$CODEX_HOME/auth.json"
|
||||
auth_lock="$CODEX_HOME/auth.lock"
|
||||
auth_lock="$(mktemp "$CODEX_HOME/auth.lock.XXXXXX")"
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🔴 嚴重 **嚴重等級**:🔴 嚴重
**審查員**:Leo
**問題**:在腳本中使用了 `mv` 指令將臨時產生的 `auth.json` 移至 `$CODEX_HOME/auth.json`。若在此之前 `$CODEX_HOME/auth.json` 已經存在,`mv` 會強制覆蓋,這可能會導致隱蔽的配置遺失,且這種副作用在腳本執行中非常危險,不利於除錯。
**建議**:在寫入設定檔前,應先檢查目標檔案是否存在,並根據業務需求決定是要備份、合併或拋出錯誤,避免無意間覆蓋掉重要的設定。
|
||||
|
||||
mkdir "$auth_lock" || die "Unable to lock Codex auth.json."
|
||||
exec 9>"$auth_lock"
|
||||
flock -n 9 || die "Unable to lock Codex auth.json."
|
||||
|
||||
|
Ghost marked this conversation as resolved
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Mage
**問題**:使用 `mkdir` 作為鎖定機制若容器意外崩潰可能殘留鎖檔。
**建議**:考慮使用更穩健的 `flock` 機制來管理檔案鎖並確保自動清理。
|
||||
if ! printf '%s\n' "$OAUTH" | base64 -d > "$auth_file"; then
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Leo
**問題**:直接執行 `codex exec` 而未對其可能的執行失敗進行顯式的錯誤捕捉。若該指令失敗,腳本仍會繼續執行後續步驟(例如設定 GitHub Output),這會導致對外回報錯誤的狀態碼不一致。
**建議**:應對 `codex exec` 進行錯誤檢查(使用 `if ! codex exec ...; then ... fi`),確保在失敗時能正確終止腳本並輸出相關錯誤訊息。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Mage
**問題**:`mv` 指令未檢查目標檔案是否已存在,無條件覆蓋會導致舊有的有效設定直接遺失。
**建議**:在 `mv` 前加入檢查,若 `auth.json` 已存在,應決定是否備份、報錯,或確認無須保留舊檔。
|
||||
die "OAUTH must be valid base64 encoded Codex auth.json."
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Mage
**問題**:執行 `codex exec` 的邏輯中使用了 `set +e` 暫時關閉錯誤退出機制,儘管後續透過 `PIPESTATUS` 檢查,但若 `codex exec` 指令本身因為環境錯誤或語法錯誤無法啟動,`codex_status` 可能會取得非預期的狀態碼。
**建議**:明確定義各個步驟的錯誤處理,或者將 `codex exec` 包裝在明確的函數中檢查退出碼。
|
||||
@@ -50,22 +50,14 @@ rm -f "$auth_file"
|
||||
|
||||
codex_output="$(mktemp)"
|
||||
|
||||
run_codex() {
|
||||
set +e
|
||||
codex exec \
|
||||
if codex exec \
|
||||
--dangerously-bypass-approvals-and-sandbox \
|
||||
--skip-git-repo-check \
|
||||
--model "$MODEL" \
|
||||
"$PROMPT" 2>&1 | tee "$codex_output"
|
||||
local status="${PIPESTATUS[0]}"
|
||||
set -e
|
||||
return "$status"
|
||||
}
|
||||
|
||||
if run_codex; then
|
||||
"$PROMPT" 2>&1 | tee "$codex_output"; then
|
||||
codex_status=0
|
||||
|
Ghost marked this conversation as resolved
Outdated
gitea-actions
commented
嚴重等級:🔴 嚴重 **嚴重等級**:🔴 嚴重
**審查員**:Mage
**問題**:在併發環境下,若多個執行緒或過程同時嘗試建立 auth.json,可能會因為檢查檔案是否存在(Line 35)與建立檔案之間的競態條件,導致 `die` 錯誤甚至意外地驗證失敗。雖然目前看起來是單一容器環境,但在 GitHub Actions 或其他 Runner 中,安全起見應使用原子操作。
**建議**:建議使用 `mkdir` 的原子性或檔案鎖定機制,或是確保 `auth_path` 在容器初始化階段就已經是唯讀且受保護的,避免檢查與寫入之間的延遲風險。
gitea-actions
commented
嚴重等級:🟡 警告 **嚴重等級**:🟡 警告
**審查員**:Mage
**問題**:在容器化環境(通常是 ephemeral 的)中,auth.json 寫入後立刻被刪除,這會導致 codex 在後續執行中因找不到驗證檔案而無法運作。另外,trap 的清理機制會導致該檔案在 codex 完成工作前被刪除,這對於長效執行或需要多次存取的應用場景是錯誤的設計。
**建議**:評估 codex 是否需要該檔案在執行期間持續存在。若需要,請調整清理時機,或考慮使用記憶體中的臨時檔案系統(tmpfs)來提升安全性,而非直接移除檔案。
|
||||
else
|
||||
codex_status="$?"
|
||||
codex_status="${PIPESTATUS[0]}"
|
||||
fi
|
||||
|
||||
if [[ -n "${GITHUB_OUTPUT:-}" ]]; then
|
||||
|
||||
嚴重等級:🟡 警告
審查員:Rogue
問題:在 Dockerfile 中安裝了 git 且未清理,導致映像檔過大。
建議:建議在同一層 RUN 指令中以 --virtual 安裝 git,完成後立即刪除。