fix(entrypoint): start ssh-agent without writing into the bind-mounted home

[so5]

背景

entrypoint.sh の ssh-agent 起動は 1cf80702（2025-08-06、HPCI-SS の E2E テスト追加と同時）で入りました。コミットメッセージは簡潔で、当時の意図が追いにくくなっています。追加されたのは次の 4 行です。

SSH_ENV_FILE=/root/ssh_env
ssh-agent -s > ${SSH_ENV_FILE}
source ${SSH_ENV_FILE}
echo "source ${SSH_ENV_FILE}" >> /root/.bashrc

compose.dev.yml および README の docker run 例は、いずれも ${HOME}:/root を bind mount します。この状態でこの entrypoint は、ホストの ~/ssh_env を生成し、コンテナ起動のたびにホストの ~/.bashrc へ source /root/ssh_env を 1 行ずつ追記します。macOS はログインシェルが zsh のため気づきにくいものの、~/.bashrc は同様に汚染されます。

調査結果（この仕組みが実際に必要としているもの）

• WHEEL サーバプロセス（node app/index）が SSH_AUTH_SOCK / SSH_AGENT_PID を持つこと。WHEEL は ssh-client-wrapper 経由で多数の ssh 子プロセスを spawn し、それらがサーバの環境を継承します。~/.ssh/config に AddKeysToAgent yes があり対象鍵がパスフレーズ付きの場合、エージェントがあればパスフレーズ入力（ブラウザのプロンプト）が 1 回で済み、ProxyJump チェーンや同一リモート間のファイル配送（-A）でもエージェント転送が効きます。
• 現行実装は source ${SSH_ENV_FILE} の後に npm start を実行しているため、サーバプロセスへは既にエージェント環境が渡っています。
• >> /root/.bashrc の唯一の目的は、docker exec ... bash の対話シェルが同じエージェントを参照できるようにすることです。通常運転には不要です。

ssh_env / SSH_ENV_FILE を参照する箇所は、テスト・CI を含めてこの 4 行のみでした。

変更内容

entrypoint.sh

該当 4 行を、固定・コンテナローカルなソケット上のエージェント起動に置き換えました。

export SSH_AUTH_SOCK=/tmp/wheel-ssh-agent.sock
rm -f "${SSH_AUTH_SOCK}"
ssh-agent -a "${SSH_AUTH_SOCK}" > /dev/null

exec npm start

• /tmp は bind mount されないため、ホームディレクトリへは一切書き込みません。
• 末尾を exec npm start とし、npm start をコンテナの PID 1 にしました（従来は非 exec で bash が PID 1）。

Dockerfile

イメージ内の /etc/bash.bashrc に 1 行追加し、当該ソケットが存在すれば SSH_AUTH_SOCK をエクスポートするようにしました（bind mount 外のためホスト非汚染）。docker exec -it wheel_dev bash（Debian の対話非ログイン bash）はこれを読み込み、同じエージェントに接続します。ソケットが無ければ何もしません。

動作確認（Linux ホスト、compose.dev.yml + ローカル override でビルド・再作成）

• コンテナ再作成の前後で ~/.bashrc の mtime・SHA256 が不変。~/ssh_env は生成されない。
• サーバプロセスの環境: SSH_AUTH_SOCK=/tmp/wheel-ssh-agent.sock。
• docker exec -it wheel_dev bash: SSH_AUTH_SOCK が設定され、ssh-add -l が応答。
• HTTP 200。PID 1 が npm start。

補足

• 変更対象はシェルスクリプトと Dockerfile のため、eslint（npm run lint）は非対象。entrypoint.sh に依存するユニットテストはありません。
• Issue は起票していません（本文に経緯を記載）。

🤖 Generated with Claude Code

https://claude.ai/code/session_01C3jKNM1qubomM8UTRdkEWu