<img src="https://storage.googleapis.com/zenn-user-upload/sd6mbsdseqv7b516rk2vvbx0xtk3" alt loading="lazy" class="md-img">
<h2 id="%E5%89%8D%E6%8F%90">
<a class="header-anchor-link" href="#%E5%89%8D%E6%8F%90" aria-hidden="true"></a> 前提</h2>
タイトル通り<code>brew update</code>をしようとするとhomebrew-coreがshallow cloneだと出て動かなかった。 
エラー文の解釈と解決方法についてのメモまとめたので以下に載せていく。 
※筆者も勉強中のため間違いがありましたらご指摘いただけると幸いです！
<h3 id="homebrew%E3%81%AE%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3">
<a class="header-anchor-link" href="#homebrew%E3%81%AE%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3" aria-hidden="true"></a> Homebrewのバージョン</h3>
<div class="code-block-container"><pre><code>$ brew --version
Homebrew 2.6.1
Homebrew/homebrew-core (git revision 6ba53; last commit 2020-12-09)
Homebrew/homebrew-cask (git revision 02bd60; last commit 2020-12-10)
</code></pre></div><h3 id="%E7%99%BA%E7%94%9F%E4%BA%8B%E8%B1%A1">
<a class="header-anchor-link" href="#%E7%99%BA%E7%94%9F%E4%BA%8B%E8%B1%A1" aria-hidden="true"></a> 発生事象</h3>
<code>brew update</code>をしようとすると下記のエラーが発生し出来ない。
<div class="code-block-container"><pre class="language-jsx"><code class="language-jsx">$ brew update
Error: homebrew-core is a shallow clone. To `brew update` first run:
git -C "/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core" fetch --unshallow
This restriction has been made on GitHub's request because updating shallow
clones is an extremely expensive operation due to the tree layout and traffic of
Homebrew/homebrew-core. We don't do this for you automatically to avoid
repeatedly performing an expensive unshallow operation in CI systems (which
should instead be fixed to not use shallow clones). Sorry for the inconvenience!
</code></pre></div><h2 id="%E3%82%A8%E3%83%A9%E3%83%BC%E3%82%92%E8%A7%A3%E6%B1%BA">
<a class="header-anchor-link" href="#%E3%82%A8%E3%83%A9%E3%83%BC%E3%82%92%E8%A7%A3%E6%B1%BA" aria-hidden="true"></a> エラーを解決</h2>
ここまで読んで「理屈はともかく早く治したい！」と言う方はエラー文にある通り下記のコマンドを打てば解決です。
<div class="code-block-container"><pre><code>-- 時間かかる...
$ git -C "/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core" fetch --unshallow
</code></pre></div><h2 id="%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AE%E8%A7%A3%E9%87%88">
<a class="header-anchor-link" href="#%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AE%E8%A7%A3%E9%87%88" aria-hidden="true"></a> エラーの解釈</h2>
<blockquote>
homebrew-core is a shallow clone. To <code>brew update</code> first run
</blockquote>
『homebrew-coreはshallow cloneです。先に(下記のスクリプトを)走らせてください。』とあります。
shallow cloneとはGitの機能でこれを使えば最新版のコミットのみpull<a href="#fn-99fa-1" id="fnref-99fa-1">[1]</a>して来ることが出来ます。
(より正確に言えば任意の深さ(バージョン)の所までpull出来る機能です。)
※参考：<a href="https://www.perforce.com/blog/vcs/git-beyond-basics-using-shallow-clones#:~:text=Git%20shallow%20clone%20lets%20you,a%20particular%20depth%20to%20pull" target="_blank" rel="nofollow noopener noreferrer">How to Use Git Shallow Clone to Improve Performance</a>
<blockquote>
This restriction has been made on GitHub's request because updating shallow 
clones is an extremely expensive operation due to the tree layout and traffic of 
Homebrew/homebrew-core.
</blockquote>
続きます。『この制限はGitHubのリクエストによるものです。というのもshallow cloneの実行はツリーレイアウトやHomebrew/homebrew-coreのトラフィック量を考えるとかなりの高コストな処理になってしまうためです。』
ここからshallow cloneがダメになったのはGitHubからの要請なのだ、と理解できます。
これについては<a href="https://github.com/Homebrew/discussions/discussions/225" target="_blank" rel="nofollow noopener noreferrer">Why shallow clone is expensive to perform?</a>というGitHub Discussion内に挙げられている<a href="https://github.com/CocoaPods/CocoaPods/issues/4989#issuecomment-193772935" target="_blank" rel="nofollow noopener noreferrer">リンク</a>先の中でのコメントでより詳細に説明されています。下記にて筆者が重要だと思った箇所のみ抜粋します。
<blockquote>
most of the initial clones are shallow, meaning that not the whole history is fetched, but just the top commit. But then subsequent fetches don't use the --depth=1 option. Ironically, this practice can be much more expensive than full fetches/clones, especially over the long term. It is usually preferable to pay the price of a full clone once, then incrementally fetch into the repository, because then Git is better able to negotiate the minimum set of changes that have to be transferred to bring the clone up to date.
</blockquote>
一度shallow cloneしても後々のfetchで(depth=1オプションが使われることはないので)結局ドカンと全体が落とされる。それよりも最初にgit cloneでリポジトリ全体を取ってきて徐々にgit fetchで変化を埋めていく方がGitは得意だし負荷も低くなるとのこと。
さて、最後のエラー文を読んでいきます。
<blockquote>
We don't do this for you automatically to avoid 
repeatedly performing an expensive unshallow operation in CI systems (which 
should instead be fixed to not use shallow clones). Sorry for the inconvenience!
</blockquote>
『今回上記の措置をユーザーのため自動的に行わなかったのはCI(継続的インテグレーション)システムの中で繰り返し高コストなunshallowの処理を行うことを避けるためです。ご迷惑おかけしております&lt;(_ _)&gt;.』
自動で実行すると逆に負荷が大きいから手動でやってね、とのことでした。
<h2 id="%E5%8F%82%E8%80%83">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83" aria-hidden="true"></a> 参考</h2>
<ul>
<li><a href="https://www.perforce.com/blog/vcs/git-beyond-basics-using-shallow-clones#:%7E:text=Git%20shallow%20clone%20lets%20you,a%20particular%20depth%20to%20pull" target="_blank" rel="nofollow noopener noreferrer">How to Use Git Shallow Clone to Improve Performance</a></li>
<li><a href="https://github.com/Homebrew/discussions/discussions/225" target="_blank" rel="nofollow noopener noreferrer">Why shallow clone is expensive to perform? #225 GitHuB Disccussion</a></li>
<li><a href="https://github.com/CocoaPods/CocoaPods/issues/4989#issuecomment-193772935" target="_blank" rel="nofollow noopener noreferrer">Issues Cloning Spec repo - GitHub taking a very long time to download changes to the Specs Repo #4989 GitHuB Issue</a></li>
</ul>
<section class="footnotes">
脚注
<ol class="footnotes-list">
<li id="fn-99fa-1" class="footnote-item">
pullとは簡単に言うと「リモートからローカルにコミットやファイルを引っ張ってしかもワークツリーにマージまでしてくれる」gitのコマンド <a href="#fnref-99fa-1" class="footnote-backref">↩︎</a>
</li>
</ol>
</section>