はじめに
asdf は、複数のプログラミング言語やツールのバージョンを統一的に管理できる便利なツールです。
asdf を利用する中で、設定ファイルである .asdfrc の便利さに氣づきました。
この記事では、.asdfrc の基本的な設定内容を整理し、学んだことを共有します。誰かの参考になれば幸いです。
.asdfrc の基本
asdf の設定ファイル .asdfrc は、デフォルトでホームディレクトリに配置する設定ファイルです。このファイルを作成し編集することで、asdf の動作を細かくカスタマイズし、自分の開発環境に最適化した使い方を実現できます。
以下はデフォルトの設定内容です。
legacy_version_file = no
use_release_candidates = no
always_keep_download = no
plugin_repository_last_check_duration = 60
disable_plugin_short_name_repository = no
concurrency = auto
詳しくは公式ドキュメントの .asdfrc 設定セクションを参照してください。
各設定項目の説明
-
legacy_version_file
既存のバージョン管理ツールのファイル（例:.ruby-version,.node-versionなど）を参照するかどうかを制御します。yesにすると互換性を持たせられます。 -
use_release_candidates
リリース候補（RC）のバージョンを使用するかどうかを設定します。 -
always_keep_download
ダウンロードしたアーカイブを削除せず保持するかどうかを指定します。 -
plugin_repository_last_check_duration
プラグインリポジトリの更新頻度（分単位）を指定します。デフォルトは 60 分です。 -
disable_plugin_short_name_repository
プラグインの短縮名を使ったリポジトリを無効化します。 -
concurrency
並列処理の設定を行います。autoにすると環境に応じた適切な値が設定されます。
既存のバージョン管理ファイルを活用する
これらの設定項目を理解した上で、次に僕が特に便利だと感じている legacy_version_file 設定について詳しく見ていきます。
プロジェクト内に .node-version や .ruby-version などの既存のバージョン管理ツール用ファイルがある場合、それらをそのまま活用できる便利な設定です。この機能は、.asdfrc 内で legacy_version_file を yes に設定することで有効になります。
以下のように .asdfrc を設定します。
legacy_version_file = yes
ユースケース:
- プロジェクト内で
rbenvやnvmなど他のバージョン管理ツールと asdf を併用している場合。 - 古いプロジェクトのファイルを
.tool-versionsに変換せずに活用したい場合。
ただし、asdf では .tool-versions を使用することが推奨されています。この設定は、既存プロジェクトでの一時的な対応策として活用するのが最適です。
詳細はレガシーファイル設定をご確認ください。
僕の .asdfrc
僕の .asdfrc 設定では、legacy_version_file のみを設定しています。この一つの設定項目で、既存のツールから asdf へのスムーズな移行が可能になり、プロジェクトごとの特性に合わせた柔軟な運用も実現できます。
これを設定することで、.ruby-version や .node-version といった既存のバージョン管理ツール用ファイルをそのまま活用できました。特に、古いプロジェクトをメンテナンスする際や、他のツールから asdf への移行作業を行う際に大きな助けとなりました。
おわりに
.asdfrc は、asdf を使いこなすための重要なカスタマイズツールです。この記事を参考に、ぜひ自分の開発環境に合った設定を試してみてください！
僕の場合、特に legacy_version_file の設定が役立ちました。既存のプロジェクトをスムーズに移行したり、古いバージョン管理ツール用ファイルをそのまま活用できたりする点は、非常に強力で便利です。
この記事が少しでも参考になれば嬉しいです。また、皆さんの .asdfrc 設定やおすすめの工夫があれば、ぜひコメントで共有してください。