套件管理工具
Package Manager
什麼是套件管理工具?
- 外部函式庫安裝與管理工具
- npm・pip 等
- 相依套件管理
套件管理工具真正改變的,不是取得函式庫的方式,而是記錄的方式。過去大家得各自下載所需檔案,複製到專案資料夾裡,幾個月後就沒有人說得出是誰、為什麼放入了哪個版本。現在儲存庫裡不再放零件本體,只放所需零件的清單檔,實際安裝則交給指令處理。因此新進工程師第一天上班,下載儲存庫、執行一次安裝指令,就能建立與資深同事完全相同的開發環境。
實務上最容易混淆的,是宣告檔與鎖定檔的差異。在 package.json 寫下 `^4.17.1`,意思是 '4.x 版之中最新的任何版本都可以',因此同一個指令昨天和今天執行,可能會裝到不同版本。package-lock.json、poetry.lock 這類鎖定檔則會把每一行固定下來。部署到伺服器時,要改用 ci 系列指令取代 install,只依照鎖定檔安裝。另外,也要把測試工具這類只在開發時使用的套件,與實際會上線執行的套件分開記錄。若公司需要通過資安審查,就設置內部 Proxy 儲存庫(Nexus・Artifactory),只放行經核准的套件。
事故大多發生在三個地方。第一,把鎖定檔(lock file)當成自動產生的檔案,直接加進 .gitignore。「我的電腦可以跑,伺服器上就是不行」,很多都是從這裡來的。第二,AI 有時會很有自信地提出實際上不存在的套件名稱。攻擊者會搶先註冊那個看似合理的名稱並上傳惡意程式碼,所以安裝前必須親自確認每週下載數與最後更新日期。第三是授權。把 GPL 系列函式庫放進要交付給客戶的產品,可能會被要求公開原始碼,在合約階段就會成為問題。只要忘了一行指令會連同數百個間接相依套件一起帶進來,我從未寫過的程式碼就會變成我們產品的責任範圍。
它逐步發展成自動安裝相依套件的工具。2010 年出現的 npm(JavaScript)建立了全球最大的套件生態系,並因此普及開來。
舉一個假設的案例。全體員工 180 人規模的食材流通商 A 公司,決定把原本用手動 Excel 處理的分店訂單業務,改為公司內部的網頁服務。沒有外包,由兩位開發人員自行花 4 個月開發。開發過程很順利,但每次部署到正式伺服器都出現原因不明的錯誤。3 週內 5 次部署全部失敗,上線日程因此延後了 2 週。
- 開發主管查看記錄後發現,同樣的安裝指令,開發電腦裝的是 4.17 版,正式伺服器裝的卻是 4.18 版。問題根源在於儲存庫裡沒有固定版本的鎖定檔。
- 負責的開發人員表示:「我以為那是自動產生的檔案,不必上傳。」組長把鎖定檔從 .gitignore 移除、改為提交進儲存庫,並把部署腳本的 install 指令換成只依照鎖定檔安裝的 ci 指令。
- 資安人員執行漏洞檢查指令,找出 12 件問題。其中 2 件高風險的,已在當週把相關函式庫升級到上一版本並處理完成。其餘 10 件屬於開發用套件,對正式環境沒有影響,已記錄在案。
- 驗證 AI 程式開發工具建議的 7 個套件時,發現了 1 個實際不存在的名稱。團隊將「每週下載量 1 萬次以上、近 6 個月內有更新」訂為安裝前的確認標準,並貼在知識庫上。
- 檢視授權條款時發現有 1 個 GPL 系列函式庫,經法務審查後,改換為MIT 授權的替代套件。這套服務要發布給分店使用,若照原樣保留,可能會收到公開原始碼的要求。
- 整理後的 3 個月內,21 次部署中因環境差異造成的失敗為 0 次,新進開發人員的環境設定時間也從半天縮短到 20 分鐘。
朴雪英
金鍾赫