Linuxes

mise.tomlの一部のツールだけインストールしたい jdx/mise-actionは既定でmise installを実行し、mise.tomlに定義した全ツールをインストールする。ジョブによって使うツールが異なるモノレポなどでは、ジョブごとに一部のツールだけインストールしたい場合がある。install_args入力を使うと、mise installに渡す引数を指定し、インストール対象を絞り込める。

GitHub APIのレート制限でツールのインストールに失敗する jdx/mise-actionは、ツールの最新バージョン確認やリリースアセットのダウンロードにGitHubのAPIを使う。GitHub APIは未認証のアクセスに対して低いレート制限がかかっている。多くのワークフローを同時に実行する環境ではこの制限に引っかかり、インストールに失敗する場合がある。github_token入力を使うと、GitHubの認証情報でAPIリクエストを認証し、レート制限を緩和できる。

CIでもmise.tomlに定義したタスクをそのまま使いたい 【mise】mise runでタスクを定義して実行する で紹介したmise runは、ローカルでもCIでも同じmise.tomlのタスク定義をそのまま実行できる。jdx/mise-actionでセットアップした後にmise runを実行するだけで、ビルドやテストといったタスクをGitHub Actions上でも実行できる。

レジストリに無いツールをasdf互換プラグインで使いたい miseはツールごとにコアやaquaなど複数のバックエンドを内蔵しており、mise useでツール名を指定すると、レジストリに登録された優先順位に従って自動的にバックエンドが選ばれる。ただしセキュリティ上の懸念から 、レジストリへの新規ツール登録ではasdfやvfoxのバックエンドは受け付けられなくなっており、新規に対応させたいツールはaquaバックエンドへの登録が推奨されている。レジストリに登録されていないツールをどうしても使いたい場合は、mise pluginsでasdf互換の外部プラグインを自分で追加して管理する。

mise本体を最新バージョンに更新したい mise installやmise useでインストールするのはmise管理下のツールのバージョンで、mise自体のバージョンは別に管理されている。mise自体を最新版に更新するにはmise self-updateを使う。

どの設定ファイルが読み込まれているか分かりにくい グローバル設定ファイル(~/.config/mise/config.toml)とプロジェクトのmise.tomlなど、miseは複数の設定ファイルを階層的に読み込む。ツールのバージョンが想定と違う場合、どの設定ファイルの記述が効いているのか分かりにくいことがある。mise configを使うと、現在のディレクトリで読み込まれている設定ファイルの一覧と、それぞれに定義されているツールを確認できる。

mise自体の設定を恒久的に変更したい 【mise】MISE_JOBSで並列インストール数を変更する のように、mise自体の挙動は環境変数でも変更できるが、環境変数はシェルの起動ファイルやCIの設定に書く必要があり、設定ファイルとして一元管理しづらい。mise settingsを使うと、同じ設定をmise.tomlやグローバル設定ファイルに恒久的に書き込める。

mise activateを恒久的に組み込まずにmiseを使いたい 【mise】mise activateでシェルにmiseを組み込む はシェルの設定ファイルに追記して恒久的にmiseを有効化する方法である。CIの1回のジョブ実行時など、シェルの設定ファイルを恒久的に変更したくない場面もある。mise envを使うと、mise.tomlに応じてmiseが設定するPATHや環境変数を出力し、その場だけ有効化できる。

複数のコマンドにまたがって一時的にバージョンを切り替えたい 【mise】mise execで一時的にツールバージョンを切り替えてコマンド実行する は1回のコマンド実行だけ別バージョンを使う場合に向いている。複数のコマンドを続けて実行したい場合は、毎回mise execを付けるのは手間がかかる。mise shellを使うと、現在のシェルセッションが続く間だけ一時的にバージョンを切り替えられる。

使われなくなった古いバージョンが溜まっていく 【mise】mise uninstallでインストール済みツールを削除する は削除したいツールとバージョンを自分で指定する必要がある。mise useでバージョンを切り替えるたびに、古いバージョンを手動でmise uninstallするのは手間がかかる。mise pruneを使うと、どの設定ファイルからも参照されなくなったバージョンをまとめて削除できる。