<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p data-line="2" class="code-line">1Passwordのssh agentは生体認証でコミット署名できる点がいいよね。<br>
しかし、1Password推奨の方法で<code>~/.gitconfig</code>を設定すると、そのマシン上で操作する分には困らないがVS CodeのDev container内でコミット署名をする際には、以下のようなエラーが発生する。</p>
<div class="code-block-container"><pre class="language-message"><code class="language-message code-line" data-line="5">Git: fatal: cannot exec 'C:/Users/ユーザー名/AppData/Local/1Password/app/8/op-ssh-sign.exe': No such file or directory
</code></pre></div><p data-line="9" class="code-line">そこで今回は、その仕組みについての解説と、具体的な改善案がいくつか出てきたので、それをまとめてみる。</p>
<h2 id="%E5%AF%BE%E8%B1%A1%E8%AA%AD%E8%80%85" data-line="11" class="code-line">
<a class="header-anchor-link" href="#%E5%AF%BE%E8%B1%A1%E8%AA%AD%E8%80%85" aria-hidden="true"></a> 対象読者</h2>
<ul data-line="13" class="code-line">
<li data-line="13" class="code-line">VS CodeのDev containerを使っている人</li>
<li data-line="14" class="code-line">1PasswordのSSH Agent
<ul data-line="15" class="code-line">
<li data-line="15" class="code-line">関連する話題として、GPG Agentも同様の問題が発生する</li>
</ul>
</li>
<li data-line="16" class="code-line">それらが動作する各種OS</li>
</ul>
<h2 id="%E6%A0%B9%E6%9C%AC%E5%8E%9F%E5%9B%A0" data-line="18" class="code-line">
<a class="header-anchor-link" href="#%E6%A0%B9%E6%9C%AC%E5%8E%9F%E5%9B%A0" aria-hidden="true"></a> 根本原因</h2>
<p data-line="20" class="code-line">まず結論を先に言うと、Dev container内でコミットする際にコンテナー内のgitが参照する設定ファイル<code>~/.gitconfig</code>がホスト側からコピーして持ってきているというのが根本的な原因だ。</p>
<h3 id=".gitconfig%E3%81%AE%E3%82%B3%E3%83%94%E3%83%BC%E3%81%AE%E6%8C%99%E5%8B%95%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" data-line="22" class="code-line">
<a class="header-anchor-link" href="#.gitconfig%E3%81%AE%E3%82%B3%E3%83%94%E3%83%BC%E3%81%AE%E6%8C%99%E5%8B%95%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> .gitconfigのコピーの挙動について</h3>
<p data-line="24" class="code-line">まず大前提として、Dev containerを作る際、通常はホストの<code>~/.gitconfig</code>をそのままコピーしている。<br>
これはVS Codeのオプション<br>
設定 &gt; 拡張機能 &gt; 開発コンテナー &gt; Dev Containers: Copy Git Config<br>
の初期値がtrueになっているためこのような挙動をする。<br>
このオプションは以下の順番でコピー元を自動的に探し、最初に見つかった方をコンテナーにコピーして使用する。</p>
<ol data-line="30" class="code-line">
<li data-line="30" class="code-line">
<code>~/.gitconfig</code> ※デフォルトのパス</li>
<li data-line="31" class="code-line">
<code>~/.config/git/config</code> ※XDG BASE Directoryに則ったパス</li>
</ol>
<p data-line="33" class="code-line">2のパターンが見つかった場合、Dev containerでもそのディレクトリ構造が保持されるため、Dev container内でも<code>~/.config/git/config</code>になる。</p>
<p data-line="35" class="code-line">これらのパターンが存在しない場合にマシン単位の<code>/etc/git/config</code>などがコピー対象になるのかは不明。</p>
<p data-line="37" class="code-line">コピーする場合は内容が丸ごとコピーされるため、1Passwordのssh agentへのパス設定も込みでホストOSのものがコピーされてしまう。<br>
Dev containerのGitがこのconfigを読み込んでSSHを実行したりする場合にそんなパスは存在しないためエラーが発生する。</p>
<p data-line="40" class="code-line">以下はWindowsで1Password推奨の<code>~/.gitconfig</code>定義のスニペットだ。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="42">[user]
  signingkey = ssh-ed25519 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

[gpg]
  format = ssh

[gpg "ssh"]
  program = "C:/Users/ユーザー名/AppData/Local/1Password/app/8/op-ssh-sign.exe"

[commit]
  gpgsign = true
</code></pre></div><p data-line="56" class="code-line">この定義をホストマシン（Windows）で設定した状態でDev containerを作り、コミットしようとすると以下のエラーが発生する。</p>
<div class="code-block-container"><pre class="language-message"><code class="language-message code-line" data-line="58">Git: fatal: cannot exec 'C:/Users/ユーザー名/AppData/Local/1Password/app/8/op-ssh-sign.exe': No such file or directory
</code></pre></div><p data-line="62" class="code-line">エラーの原因になっているのは下記のgpg.ssh.programの行だ。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="64">[gpg "ssh"]
  program = "C:/Users/ユーザー名/AppData/Local/1Password/app/8/op-ssh-sign.exe"
</code></pre></div><p data-line="69" class="code-line">コンテナー内で<code>~/.gitconfig</code>を開き、上記行をコメントアウトすればエラーは解消され、ホストマシンを経由して生体認証にアクセスされ、コミット署名もできるようになる。<br>
ホストと同期はしていないため、コンテナーごとにその作業が必要になる。</p>
<p data-line="72" class="code-line">この対処方法はWindows以外のOSでも同じ。</p>
<p data-line="74" class="code-line">このエラーについては1PasswordのSSH Agentに限った話ではなく、GPG Agentを使っている場合も発生する。<br>
エラーの根本原因は<code>~/.gitconfig</code>に存在しないパスが書かれているということであるためだ。<br>
以下のような記述があれば同様の問題が発生するはずだ。</p>
<div class="code-block-container"><pre><code class="code-line" data-line="78">[gpg]
  program = "C:/Program Files (x86)/GnuPG/bin/gpg.exe"
</code></pre></div><h3 id="%E3%83%9B%E3%82%B9%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E9%9A%9B%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF" data-line="83" class="code-line">
<a class="header-anchor-link" href="#%E3%83%9B%E3%82%B9%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E9%9A%9B%E3%81%AE%E4%BB%95%E7%B5%84%E3%81%BF" aria-hidden="true"></a> ホストの設定を利用する際の仕組み</h3>
<p data-line="85" class="code-line">Dev container内からコミット署名やSSH接続を行う際、ホスト側の構成を利用する設定値は自動的に書き込まれるようになっている。<br>
これは先ほどの<code>~/.gitconfig</code>のコピーとはまた別のオプションとして存在する。<br>
設定 &gt; 拡張機能 &gt; 開発コンテナー &gt; Dev Containers: Git Credential Helper Config Location<br>
初期値は<code>global</code>で、<code>~/.gitconfig</code>に書き込まれるようになっている。</p>
<div class="code-block-container"><pre class="language-gitconfig"><code class="language-gitconfig code-line" data-line="90">[credential]
    helper = "!f() ※長いので省略
</code></pre></div><p data-line="95" class="code-line">また、Gitがconfigを読み込む際は必ず</p>
<ol data-line="97" class="code-line">
<li data-line="97" class="code-line">
<code>~/.config/git/config</code> ※XDG BASE Directoryに則ったパス</li>
<li data-line="98" class="code-line">
<code>~/.gitconfig</code> ※デフォルトのパス</li>
</ol>
<p data-line="100" class="code-line">の順に読み込みが行われるようになっている。<br>
それぞれの設定がマージされ、キーが被る項目があった場合、優先されるのは<code>~/.gitconfig</code>だ。</p>
<h2 id="%E8%A7%A3%E6%B1%BA%E7%AD%96%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" data-line="103" class="code-line">
<a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA%E7%AD%96%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> 解決策について</h2>
<h3 id="%E8%A7%A3%E6%B1%BA%E7%AD%961%3A-%E3%83%9B%E3%82%B9%E3%83%88%E5%81%B4%E3%81%AEgitconfig%E3%82%92%E5%88%86%E5%89%B2%E3%81%97%E3%80%81ssh%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%82%92%E5%88%A5%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AB%E3%81%99%E3%82%8B" data-line="105" class="code-line">
<a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA%E7%AD%961%3A-%E3%83%9B%E3%82%B9%E3%83%88%E5%81%B4%E3%81%AEgitconfig%E3%82%92%E5%88%86%E5%89%B2%E3%81%97%E3%80%81ssh%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88%E3%81%AE%E8%A8%AD%E5%AE%9A%E3%82%92%E5%88%A5%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AB%E3%81%99%E3%82%8B" aria-hidden="true"></a> 解決策1: ホスト側のgitconfigを分割し、SSHエージェントの設定を別ファイルにする</h3>
<p data-line="107" class="code-line">どのような人にオススメか: 極力シンプルな設定にしておきたい人</p>
<p data-line="109" class="code-line">gitconfigのコピーは行われるが、その中で<code>include</code>によって別ファイルから設定値を読み取ってる場合、そのファイルのコピーまでは行われない。<br>
また、存在しないファイルを<code>include</code>してもエラーにはならないため、この仕組みを使ってマシンに依存する設定を分割することで、Dev container内にコピーされても問題ない<code>.gitconfig</code>が使用できる。</p>
<p data-line="112" class="code-line">たとえば以下のようにユーザー単位の設定と、マシンごとの固有設定をそれぞれ記述する</p>
<p data-line="114" class="code-line">自分（ユーザー）用の設定</p>
<div class="code-block-container"><pre><code class="code-line" data-line="116">[user]
    name = hoge
    email = hoge@example
    signingkey = ssh-ed25519:hogehoge
[commit]
    gpgsign = true
[gpg]
    format = ssh
[init]
    defaultBranch = main
[include]
    path = .gitconfig.local
</code></pre></div><p data-line="131" class="code-line">マシンごとに固有の設定</p>
<div class="code-block-container"><pre><code class="code-line" data-line="133">[core]
    sshCommand = "C:/windows/System32/OpenSSH/ssh.exe"

[gpg "ssh"]
    program = "C:/Users/ユーザー名/AppData/Local/1Password/app/8/op-ssh-sign.exe"
</code></pre></div><p data-line="141" class="code-line">ここで挙げた構成はあくまで一例であり、もっと細かい調整をすることもできる。<br>
たとえば、nameとemailだけ使いまわしたいが、signingkeyだけマシンごとに変えたい場合、signingkeyの項目をさらに別な<code>include</code>で読み込むこともできる。<br>
ただし、その場合でもコピーされるものは<code>.gitconfig</code>のみであるため、<code>include</code>対象のファイルはコピーされない。<br>
そのような単純でない構成を使っている場合は、次に挙げる解決策2を検討するほうが良いかもしれない。</p>
<h3 id="%E8%A7%A3%E6%B1%BA%E7%AD%962%3A-gitconfig%E3%81%AE%E3%82%B3%E3%83%94%E3%83%BC%E3%82%92%E7%84%A1%E5%8A%B9%E5%8C%96%E3%81%99%E3%82%8B" data-line="146" class="code-line">
<a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA%E7%AD%962%3A-gitconfig%E3%81%AE%E3%82%B3%E3%83%94%E3%83%BC%E3%82%92%E7%84%A1%E5%8A%B9%E5%8C%96%E3%81%99%E3%82%8B" aria-hidden="true"></a> 解決策2: gitconfigのコピーを無効化する</h3>
<p data-line="148" class="code-line">どのような人にオススメか: 複雑な設定をしている人、あるいはdotfilesを使っている人</p>
<p data-line="150" class="code-line">VS Codeのオプションをそもそもオフにすることで、ホストのgitconfigをDev containerにコピーしないようにすることもできる。<br>
その場合、Dev container内でのgitconfigの設定は、Dev container内で直接設定する必要がある。<br>
コンテナーを作るたび、ビルドするたびに毎回設定をする必要があるが、スクリプトで自動化することもできる。<br>
たとえばDotfilesリポジトリがある場合、VS Codeの設定でdotfilesの自動クローン機能とインストール機能があるためそれを使ってセットアップすることができる。</p>
<ul data-line="155" class="code-line">
<li data-line="155" class="code-line">設定 &gt; 拡張機能 &gt; 開発コンテナー &gt; Dotfiles: Repository</li>
</ul>
<p data-line="157" class="code-line">dotfilesリポジトリのURLを入力する。<br>
クローンは後述のパスに対して行われる。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="160">https://github.com/hoge/dotfiles.git
</code></pre></div><ul data-line="164" class="code-line">
<li data-line="164" class="code-line">設定 &gt; 拡張機能 &gt; 開発コンテナー &gt; Dotfiles: Target Path</li>
</ul>
<p data-line="166" class="code-line">dotfilesリポジトリのクローン先のパスを入力する。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="168">~/dotfiles
</code></pre></div><ul data-line="172" class="code-line">
<li data-line="172" class="code-line">設定 &gt; 拡張機能 &gt; 開発コンテナー &gt; Dotfiles: Install Command</li>
</ul>
<p data-line="174" class="code-line">dotfilesリポジトリをクローンした後に実行するコマンドを入力する。</p>
<div class="code-block-container"><pre class="language-bash"><code class="language-bash code-line" data-line="176">~/dotfiles/install.sh
</code></pre></div><p data-line="180" class="code-line">これらを駆使することで、Dev container内での設定を自動化することができる。</p>
<p data-line="182" class="code-line">もしInstallCommandで<code>~/.gitconfig</code>をホームに展開するスクリプトを書いている場合、追記モードで実行すること。<br>
そうでないと自動でVS Code（Dev container?）が書き込むホストへの転送設定まで上書きされてしまい、ホスト側への転送が効かなくなる。<br>
これはXDG Base Directoryに則ったパス<code>~/.config/git/config</code>に展開する場合は発生せず、両立できる。</p>
<p data-line="186" class="code-line">筆者はdotfilesを使っているため、この方法を使っている。</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="188" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h2>
<p data-line="190" class="code-line">ここまで挙げた解決策のいずれかを使うことでコンテナーごとに毎回Gitのエラーを対処する必要がなくなるはずだ。</p>
<p data-line="192" class="code-line">ここ2年くらいずっとDev container内の<code>.gitconfig</code>を直接書き換える手法で作業していたが、この方法を使えばもっと楽に設定できることがわかった。<br>
たまにはVS Codeの設定を流し読みしてみるのもいいものだね。</p>


Dev containerでの1Password SSH Agentを使ったコミット署名時のエラーを対処する

.gitconfigのコピーの挙動について

ホストの設定を利用する際の仕組み

解決策1: ホスト側のgitconfigを分割し、SSHエージェントの設定を別ファイルにする

Discussion