パッケージマネージャー
Package Manager
パッケージマネージャーとは?
- 外部ライブラリのインストール・管理ツール
- npm・pipなど
- 依存関係の管理
パッケージマネージャーが実際に変えるのは、ライブラリを「取ってくる」方法ではなく「書き留める」方法です。以前は必要なファイルをそれぞれダウンロードしてプロジェクトフォルダにコピーして入れていたため、数か月たつと誰がどのバージョンをなぜ入れたのか説明できる人がいませんでした。今は、リポジトリに部品の実物ではなく 必要な部品の一覧ファイルだけを置き、実際のインストールはコマンドが代わりに行います。そのため新人開発者は、初出社の日にリポジトリを取得してインストールコマンドを一度打つだけで、先輩とまったく同じ開発環境を作ることができます。
実務で最も混同しやすいのは、宣言ファイルとロックファイルの違いです。package.json に `^4.17.1` と書くと「4系の中で最新であれば何でも」という意味になるため、同じコマンドを昨日と今日実行しても、違うバージョンが入ることがあります。これを一つひとつ固定してくれるのが package-lock.json・poetry.lock のようなロックファイルで、デプロイ サーバーでは install ではなく ci 系のコマンドを使い、ロックファイルどおりにだけインストールされるよう制限します。さらに、テスト用ツールのように開発時だけ使うパッケージと、運用環境に実際に載るパッケージを分けて記載します。セキュリティ審査を受ける会社であれば、社内プロキシリポジトリ(Nexus・Artifactory)を設け、承認されたパッケージだけを通すようにします。
事故は大抵三か所で起きます。一つ目は、ロックファイルを自動生成物だと思い .gitignore に入れてしまうケースです。「自分のPCでは動くのにサーバーでだけ動かない」の多くはここから来ます。二つ目は、AIが実在しないパッケージ名を自信満々に提示するケースです。攻撃者はそのもっともらしい名前をあらかじめ押さえて悪意あるコードを置くこともあるため、インストール前に週間ダウンロード数と最終更新日を目で確認する必要があります。三つ目はライセンスです。GPL系のライブラリを顧客企業に納品する製品に入れると、ソース公開を求められる可能性があり、契約段階で問題になります。一行のコマンドが数百の間接依存関係を一緒に引き込むことを忘れると、自分が書いたことのないコードが自社製品の責任範囲に入ってしまいます。
依存関係のインストールを自動化するツールとして発展し、2010年に登場したnpm(JavaScript)が世界最大のパッケージエコシステムを形成して普及しました。
仮想の事例で見てみましょう。従業員180名規模の食材流通会社A社は、手作業のExcelで回していた支店の注文業務を社内のWebサービスに移すことにし、外注せずに開発者2名が4か月かけて直接作りました。開発は順調でしたが、運用サーバーに載せるたびに原因不明のエラーが出ました。3週間で5回のデプロイがすべて失敗し、開始日程は2週間遅れました。
- 開発チームのリーダーがログを調べたところ、同じインストールコマンドなのに、開発PCには4.17版が、運用サーバーには4.18版が入っていました。バージョンを固定するロックファイルがリポジトリになかったことが原因でした。
- 担当の開発者は「自動で生成されるファイルなので、わざわざ上げる必要はないと思っていました」と話しました。チーム長はロックファイルを .gitignore から外してコミットさせ、デプロイスクリプトの install コマンドを ロックファイルどおりにだけインストールする ci コマンドに変えました。
- 情報セキュリティ担当者が脆弱性点検コマンドを実行して12件を発見し、このうち高リスク2件は該当ライブラリを上位バージョンに上げて、その週のうちに整理しました。残り10件は開発用パッケージのため、運用への影響なしとして記録に残しました。
- AIコーディングツールが提案したパッケージ7件を検証していたところ、実在しない名前が1件見つかりました。チームは「週間ダウンロード1万件以上、直近6か月以内に更新」を、インストール前の確認基準として定め、Wikiに掲載しています。
- ライセンスを見直していて、GPL系のライブラリが1つ入っていることを確認し、法務審査を経て MITライセンスの代替パッケージに交換しました。支店向けに配布されるサービスなので、そのまま残していればソース公開を求められかねない状況でした。
- 整理後の3か月間、デプロイ21回のうち環境の違いによる失敗は0件で、新規入社の開発者の環境セットアップ時間も 半日から20分に短縮されました。
パク・ソリョン
金鍾赫