<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>いろいろな言語のバージョン管理ツールとして頻繁に使われる「~env」的なものの Hasura CLI バージョンを作りました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__49fbf597dec07" src="https://embed.zenn.studio/card#zenn-embedded__49fbf597dec07" data-content="https%3A%2F%2Fgithub.com%2Fkmtym1998%2Fhasuraenv" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/kmtym1998/hasuraenv" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/kmtym1998/hasuraenv</a></p>
<p>複数のバージョンの Hasura プロジェクトを触る機会のある方はぜひ使っていただければと思います。</p>
<h1 id="%E9%96%8B%E7%99%BA%E7%B5%8C%E7%B7%AF">
<a class="header-anchor-link" href="#%E9%96%8B%E7%99%BA%E7%B5%8C%E7%B7%AF" aria-hidden="true"></a> 開発経緯</h1>
<p>私の所属する会社で開発するプロダクトでは Hasura を全面的に採用し、Hasura を使ったプロダクトがいくつか存在します。それぞれのプロダクトごとに Hasura のバージョンが違うため、開発対象のプロダクトが変わるごとに <code>hasura update-cli</code> で CLI をインストールし直す必要がありました。その作業が毎度面倒なので <a href="https://github.com/hokaccha/nodebrew" target="_blank" rel="nofollow noopener noreferrer">nodebrew</a> や <a href="https://github.com/rbenv/rbenv" target="_blank" rel="nofollow noopener noreferrer">rbenv</a> のような簡単にバージョンを切り替えられるツールを作ることにしました。</p>
<p>基本的に Hasura のサーバのバージョンと Hasura CLI のバージョンは揃えるべきだと思っています。というのも、Hasura CLI はバージョンによって 生成される metadata が違ったり、CLI 内部で使われている API の仕様変更が発生したりします。(ある程度の後方互換性は保ってリリースされているとは思いますが) 特別な事情がない限り CLI とサーバのバージョンを揃えておいたほうが賢明だと思っています。</p>
<h1 id="%E4%BD%BF%E3%81%84%E6%96%B9%E3%83%BB%E6%A9%9F%E8%83%BD">
<a class="header-anchor-link" href="#%E4%BD%BF%E3%81%84%E6%96%B9%E3%83%BB%E6%A9%9F%E8%83%BD" aria-hidden="true"></a> 使い方・機能</h1>
<p><a href="https://github.com/kmtym1998/hasuraenv/blob/main/README.md" target="_blank" rel="nofollow noopener noreferrer">README</a> に書いたことを噛み砕いて書いただけなので、README を読めばいいやという方は読み飛ばしていただいて構いません。</p>
<h2 id="%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">
<a class="header-anchor-link" href="#%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> インストール</h2>
<p><code>go install</code> でバイナリをインストールします。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ go <span class="token function">install</span> github.com/kmtym1998/hasuraenv/cmd/hasuraenv@latest
</code></pre></div><p><code>hasuraenv init</code> での初期化処理をし、hasuraenv でインストールした Hasura CLI への PATH を通します。<code>init</code> を実行すると自動的に最新の Hasura CLI をインストールし、そのバージョンの Hasura CLI が使われるようになります。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ hasuraenv init

$ <span class="token builtin class-name">export</span> <span class="token assign-left variable"><span class="token environment constant">PATH</span></span><span class="token operator">=</span><span class="token environment constant">$HOME</span>/.hasuraenv/current:<span class="token environment constant">$PATH</span><span class="token punctuation">;</span>
</code></pre></div><p><code>hasura</code> コマンドの向き先が hasuraenv でインストールした Hasura CLI のものになっていることを確認します。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell">$ <span class="token function">which</span> hasura
~/.hasuraenv/current/hasura
</code></pre></div><h2 id="%E6%A9%9F%E8%83%BD">
<a class="header-anchor-link" href="#%E6%A9%9F%E8%83%BD" aria-hidden="true"></a> 機能</h2>
<p>主な機能は以下のとおりです。</p>
<ul>
<li>リリース済みの Hasura CLI のバージョンを一覧する</li>
<li>ローカルにインストール済みの Hasura CLI のバージョンを一覧する</li>
<li>バージョン指定して Hasura CLI をインストールする</li>
<li>使用する Hasura CLI のバージョンを切り替える</li>
</ul>
<p>コマンドのインターフェースは <a href="https://github.com/hokaccha/nodebrew" target="_blank" rel="nofollow noopener noreferrer">nodebrew</a> を大いに参考にさせていただきました。<br>
Hasura CLI のバージョンを新たにインストール ~ 切替の例を示します。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell"><span class="token comment"># 元の Hasura CLI のバージョンを確認</span>
$ hasura version
INFO hasura cli                                    <span class="token assign-left variable">version</span><span class="token operator">=</span>v2.1.0

<span class="token comment"># リリース済みの Hasura CLI のバージョンの最新 10 件を確認</span>
$ hasuraenv ls-remote <span class="token parameter variable">--limit</span> <span class="token number">10</span>
INFO Latest <span class="token number">10</span> releases
     v2.13.0-beta.1
     v2.12.0
     <span class="token punctuation">..</span>.

<span class="token comment"># v2.13.0-beta.1 をインストール</span>
$ hasuraenv <span class="token function">install</span> v2.13.0-beta.1

<span class="token comment"># インストール済みの Hasura CLI のバージョン一覧を確認</span>
$ hasuraenv <span class="token function">ls</span>
INFO Installed hasura cli
     v2.1.0
     v2.9.0
     v2.9.0-beta.3
     v2.13.0-beta.1

<span class="token comment"># v2.13.0-beta.1 を使う</span>
$ hasuraenv use v2.13.0-beta.1

<span class="token comment"># バージョンが切り替わったことを確認</span>
$ hasura version
INFO hasura cli                                    <span class="token assign-left variable">version</span><span class="token operator">=</span>v2.13.0-beta.1
</code></pre></div><h1 id="%E5%AE%9F%E8%A3%85%E5%86%85%E5%AE%B9%E3%81%A8%E4%BB%95%E6%A7%98%E3%82%92%E8%BB%BD%E3%81%8F%E7%B4%B9%E4%BB%8B">
<a class="header-anchor-link" href="#%E5%AE%9F%E8%A3%85%E5%86%85%E5%AE%B9%E3%81%A8%E4%BB%95%E6%A7%98%E3%82%92%E8%BB%BD%E3%81%8F%E7%B4%B9%E4%BB%8B" aria-hidden="true"></a> 実装内容と仕様を軽く紹介</h1>
<p>使い慣れているので開発言語は Go を、CLI フレームワークには <a href="https://github.com/spf13/cobra" target="_blank" rel="nofollow noopener noreferrer">spf13/cobra</a> を採用しました。<br>
<code>$HOME/.hasuraenv/versions</code> 配下にはインストールした Hasura CLI のバイナリが入るようになっています。<code>$HOME/.hasuraenv/current</code> には使用中のバージョンのバイナリを指すシンボリックリンクが置かれています。このシンボリックリンクに PATH を通してあげることで指定したバージョンの Hasura CLI が使えるようになります。<code>hasuraenv use</code> を使ったときにシンボリックリンクを向き先を変えて作り直すことでバージョンの切り替えを実現しています。</p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">ディレクトリ構造</span></div>
<pre class="language-text"><code class="language-text">$ tree ~/.hasuraenv
├── current -&gt; ~/.hasuraenv/versions/default
└── versions
    ├── default
    │   └── hasura
    ├── v2.1.0
    │   └── hasura
    └── v2.13.0-beta.1
        └── hasura
</code></pre>
</div><p>Hasura CLI のインストールは公式ドキュメントに書かれた Linux / Mac 向けのインストール方法で行うようにしました。(windows では使えません...🙇‍♂️)</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__b3afaf923000b" src="https://embed.zenn.studio/card#zenn-embedded__b3afaf923000b" data-content="https%3A%2F%2Fhasura.io%2Fdocs%2Flatest%2Fhasura-cli%2Finstall-hasura-cli%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://hasura.io/docs/latest/hasura-cli/install-hasura-cli/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://hasura.io/docs/latest/hasura-cli/install-hasura-cli/</a></p>
<p>インストールスクリプトの実行時にバージョンとインストールパスを渡してインストールしています。</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>複数のバージョンの Hasura プロジェクトを触る機会のある方はぜひ使っていただければと思います。同じようなパターンで実装すれば Hasura CLI に限らずいろいろなツールで「~env」は作れそうですね。</p>


Hasura CLI のバージョン管理ツールを作りました

Discussion