<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p>この記事は <a href="https://qiita.com/advent-calendar/2022/babyjob" target="_blank" rel="nofollow noopener noreferrer">BABY JOB Advent Calendar 2022</a> の 7 日目の記事です。</p>
</div></aside>
<h1 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h1>
<p>弊社ではGitHub Actionsを使用してCIを構築しており、Pull Requestの作成時やpush時にコードフォーマットやテストを実行しています。<br>
普段はうまく動いてくれているのですが、時々「ローカルではテストが通るのに、なぜかCIではコケる」という問題が起こっていました。<br>
なんでだろうな〜と気になって調査した結果、原因がわかったのでまとめておきます。</p>
<h1 id="%E4%BD%95%E3%81%8C%E8%B5%B7%E3%81%93%E3%81%A3%E3%81%9F%E3%81%8B">
<a class="header-anchor-link" href="#%E4%BD%95%E3%81%8C%E8%B5%B7%E3%81%93%E3%81%A3%E3%81%9F%E3%81%8B" aria-hidden="true"></a> 何が起こったか</h1>
<h2 id="%E9%96%8B%E7%99%BA%E3%83%95%E3%83%AD%E3%83%BC">
<a class="header-anchor-link" href="#%E9%96%8B%E7%99%BA%E3%83%95%E3%83%AD%E3%83%BC" aria-hidden="true"></a> 開発フロー</h2>
<p>以下のようなフローで開発しているとします。</p>
<ol>
<li>最新のdevelopブランチからfeatureブランチを作成</li>
<li>featureブランチでいくつかコミット</li>
<li>developブランチに対して、Pull Requestを作成</li>
</ol>
<h2 id="ci%E3%81%A7%E3%81%AE%E3%81%BF%E3%83%86%E3%82%B9%E3%83%88%E3%81%8C%E3%82%B3%E3%82%B1%E3%82%8B">
<a class="header-anchor-link" href="#ci%E3%81%A7%E3%81%AE%E3%81%BF%E3%83%86%E3%82%B9%E3%83%88%E3%81%8C%E3%82%B3%E3%82%B1%E3%82%8B" aria-hidden="true"></a> CIでのみテストがコケる</h2>
<p>いつも通り開発して、Pull Requestを作成した後、CIがコケていることに気づきました。<br>
ログを見ても自分が加えた変更とは関係なさそうなところで落ちています。<br>
一方、ローカルではテストが通っています。<br>
Why？🤷</p>
<p>developブランチに変更が加わっていたので、取り込んで再度テストを実行してみました。<br>
するとローカルでもCIと同じエラーが起きました。<br>
Why?🤷</p>
<h1 id="%E5%8E%9F%E5%9B%A0%E3%81%AF%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%82%A2%E3%82%A6%E3%83%88%E3%81%99%E3%82%8B%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81">
<a class="header-anchor-link" href="#%E5%8E%9F%E5%9B%A0%E3%81%AF%E3%83%81%E3%82%A7%E3%83%83%E3%82%AF%E3%82%A2%E3%82%A6%E3%83%88%E3%81%99%E3%82%8B%E3%83%96%E3%83%A9%E3%83%B3%E3%83%81" aria-hidden="true"></a> 原因はチェックアウトするブランチ</h1>
<p>下記のように特に設定をせずチェックアウトしていたので、自分の作成したfeatureブランチをチェックアウトしていると思い込んでいましたが、これが誤りでした🤦</p>
<div class="code-block-container"><pre class="language-yml"><code class="language-yml"><span class="token key atrule">jobs</span><span class="token punctuation">:</span>
  <span class="token key atrule">test</span><span class="token punctuation">:</span>
    <span class="token key atrule">runs-on</span><span class="token punctuation">:</span> ubuntu<span class="token punctuation">-</span>latest
    <span class="token key atrule">steps</span><span class="token punctuation">:</span>
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Checkout
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> actions/checkout@v2
</code></pre></div><p>先述の事象から、CIではマージ先のブランチ（ここではdevelop）をマージ元のブランチ（ここではfeature）に取り込んだブランチ・コードベースでテストしているのでは🤔と考えて、GitHub Actionsのログを見ると <code>refs/pull/&lt;pr_number&gt;/merge</code> というブランチをチェックアウトしていました。</p>
<p>この <code>refs/pull/&lt;pr_number&gt;/merge</code> がなんぞやということですが、Pull Requestのマージ後の状態を表すGitHubが作成するブランチで、このブランチを作成することでコンフリクトしないか、正常にマージできるかを判断してるっぽいです。</p>
<blockquote>
<p>pull/xxx/merge はマージ対象のブランチとマージした結果の状態を持つブランチである。</p>
</blockquote>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__70e9494c84efd" src="https://embed.zenn.studio/card#zenn-embedded__70e9494c84efd" data-content="https%3A%2F%2Fqiita.com%2Fsonots%2Fitems%2F16df445132e704198e3e" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://qiita.com/sonots/items/16df445132e704198e3e" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://qiita.com/sonots/items/16df445132e704198e3e</a></p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__50b8a727c2fb3" src="https://embed.zenn.studio/card#zenn-embedded__50b8a727c2fb3" data-content="https%3A%2F%2Fstackoverflow.com%2Fquestions%2F63594658%2Fgit-refs-merge-vs-head-in-pull-request" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://stackoverflow.com/questions/63594658/git-refs-merge-vs-head-in-pull-request" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://stackoverflow.com/questions/63594658/git-refs-merge-vs-head-in-pull-request</a></p>
<p>また、<code>actions/checkout</code> のコードをみると、<code>ref</code> を指定しない場合は、<code>github.context.ref</code> が設定されるようです。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-github"><iframe id="zenn-embedded__b265b5246896e" src="https://embed.zenn.studio/github#zenn-embedded__b265b5246896e" data-content="https%3A%2F%2Fgithub.com%2Factions%2Fcheckout%2Fblob%2Fe6d535c99c374d0c3f6d8cd8086a57b43c6c700a%2Fsrc%2Finput-helper.ts%23L63" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/actions/checkout/blob/e6d535c99c374d0c3f6d8cd8086a57b43c6c700a/src/input-helper.ts#L63" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/actions/checkout/blob/e6d535c99c374d0c3f6d8cd8086a57b43c6c700a/src/input-helper.ts#L63</a></p>
<p>そして、Pull Requestがトリガーの場合 <code>github.context.ref</code> は <code>refs/pull/&lt;pr_number&gt;/merge</code> になると<a href="https://docs.github.com/en/actions/learn-github-actions/contexts#github-context" target="_blank" rel="nofollow noopener noreferrer">ドキュメント</a>に記載されています。</p>
<blockquote>
<p>The ref given is fully-formed, meaning that for branches the format is <code>refs/heads/&lt;branch_name&gt;</code>, for pull requests it is <code>refs/pull/&lt;pr_number&gt;/merge</code>,</p>
</blockquote>
<p>つまり、Pull Requestがトリガーの場合のデフォルトのチェックアウト先は、<code>refs/pull/&lt;pr_number&gt;/merge</code>ということですね！</p>
<p>ちなみに、featureブランチのコードベースでテストを行いたい場合は以下のようにして、Pull Requestの HEAD コミットを <code>ref</code> に指定します。</p>
<div class="code-block-container"><pre class="language-yml"><code class="language-yml"><span class="token punctuation">-</span> <span class="token key atrule">uses</span><span class="token punctuation">:</span> actions/checkout@v2
  <span class="token key atrule">with</span><span class="token punctuation">:</span>
    <span class="token key atrule">ref</span><span class="token punctuation">:</span> $<span class="token punctuation">{</span><span class="token punctuation">{</span> github.event.pull_request.head.sha <span class="token punctuation">}</span><span class="token punctuation">}</span>
</code></pre></div><p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__56ff336844a05" src="https://embed.zenn.studio/card#zenn-embedded__56ff336844a05" data-content="https%3A%2F%2Fgithub.com%2Factions%2Fcheckout%2Ftree%2Freleases%2Fv2%23checkout-pull-request-head-commit-instead-of-merge-commit" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/actions/checkout/tree/releases/v2#checkout-pull-request-head-commit-instead-of-merge-commit" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/actions/checkout/tree/releases/v2#checkout-pull-request-head-commit-instead-of-merge-commit</a></p>
<h1 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB">
<a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> おわりに</h1>
<p>checkoutの挙動をちゃんと理解してなかった自分が悪いんですが、デフォルトの設定が自分の感覚と違っている場合はハマりやすいな〜と思いました。<br>
使用しているツールやライブラリのデフォルトの挙動は把握しておきたいものです。<br>
ただ、ハマったのをきっかけに色々学べたので逆によかったかも？</p>


ローカルで通るテストがGitHub Actionsでコケてハマった

原因はチェックアウトするブランチ

Discussion