構成設定 ​

asdfの構成設定には、他人と共有可能な.tool-versionsファイルと、.asdfrcや環境変数によってカスタマイズ可能なユーザ固有の設定とがあります。

.tool-versions ​

.tool-versionsファイルがディレクトリに存在する場合、当該ディレクトリおよびサブディレクトリで、ファイル内で宣言しているツールのバージョンが使用されます。

.tool-versionsファイル内は下記のような記述となっています:

ruby 2.5.3
nodejs 10.15.0

ruby 2.5.3
nodejs 10.15.0

コメントを含めることもできます:

ruby 2.5.3 # This is a comment
# This is another comment
nodejs 10.15.0

ruby 2.5.3 # This is a comment
# This is another comment
nodejs 10.15.0

バージョンの表記は下記の形式があります:

• 10.15.0 - 実バージョンの表記です。バイナリのダウンロードに対応しているプラグインの場合、バイナリがダウンロードされます。
• ref:v1.0.2-a or ref:39cb398vb39 - 指定されたタグ/コミット/ブランチをgithubからダウンロードし、コンパイルされます。
• path:~/src/elixir - 使用するツールをカスタムコンパイルしたバージョンへのパスです。言語開発者などが使用します。
• system - このキーワードを指定した場合、asdfが管理していない、システム上のツールバージョンへパススルーします。

python 3.7.2 2.7.15 system

python 3.7.2 2.7.15 system

.tool-versionsファイルで定義されているすべてのツールをインストールするには、.tool-versionsファイルを含むディレクトリで、asdf installコマンドを引数を指定せずに実行します。

.tool-versionsファイルで定義されている単一のツールをインストールするには、.tool-versionsファイルを含むディレクトリで、asdf install <name>コマンドを実行します。ツールは、.tool-versionsファイルで指定されたバージョンでインストールされます。

ファイルは、直接編集するか、asdf localコマンド(またはasdf globalコマンド)を使用して更新してください。

.asdfrc ​

.asdfrcでは、ユーザのマシン固有の構成を設定します。

asdfはデフォルトで${HOME}/.asdfrcに構成ファイルを配置します。ファイルの場所は、ASDF_CONFIG_FILE環境変数で設定できます。

下記は、構成に必要な項目とそのデフォルト値を示しています:

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

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

legacy_version_file ​

対応しているプラグインの場合、他のバージョンマネージャで使用されているバージョンファイルを読み込むことができます。例えば、Rubyのrbenvであれば.ruby-versionファイルを読み込みます。

use_release_candidates ​

asdf updateコマンドでasdfを更新する際に、最新リリースではなく、リリース候補版へ更新するか制御します。

always_keep_download ​

asdf installコマンドでダウンロードしたソースコードやバイナリを、保持しておくか削除するかを制御します。

plugin_repository_last_check_duration ​

asdfプラグインリポジトリの同期間隔(分)を制御します。何らかのトリガーイベントが発生した際に、最後に同期した時刻からの経過時間をチェックします。設定された間隔以上の時間が経過していた倍は、新たに同期が開始されます。

同期は、以下のコマンドが実行されたときに発生します:

• asdf plugin add <name>
• asdf plugin list all

asdf plugin add <name> <git-url>コマンドでは、プラグインの同期はトリガーされません。

disable_plugin_short_name_repository ​

asdfプラグインのショートネームリポジトリの同期を無効化します。ショートネームリポジトリが無効となっている場合、同期イベントはすぐに終了します。

同期は、以下のコマンドが実行されたときに発生します:

• asdf plugin add <name>
• asdf plugin list all

asdf plugin add <name> <git-url>コマンドでは、プラグインの同期はトリガーされません。

concurrency ​

コンパイル時に使用するデフォルトのコア数です。

備考: ASDF_CONCURRENCY環境変数が設定されている場合はそちらが優先されます。

環境変数 ​

環境変数の設定値は、お使いのシステムやシェルによって異なります。デフォルトロケーションは、インストールした場所や方法(Gitクローン、Homebrew、AUR)によって異なります。

環境変数は通常、asdf.sh/asdf.fishなどをsourceする前に設定する必要があります。Elvishの場合は、use asdfの上側に設定します。

以下では、Bashシェルでの使用方法について説明します。

ASDF_CONFIG_FILE ​

.asdfrc構成ファイルへのパスです。任意の場所に設定できます。必ず絶対パスで設定してください。

• 未設定の場合: $HOME/.asdfrcの値が使用されます。
• 使用方法: export ASDF_CONFIG_FILE=/home/john_doe/.config/asdf/.asdfrc

ASDF_DEFAULT_TOOL_VERSIONS_FILENAME ​

ツール名とバージョンの情報を格納するファイルのファイル名です。有効なファイル名であれば何でも設定できます。通常、.tool-versionsファイルを無視したい場合を除き、この値を変更するべきではありません。

• 未設定の場合: .tool-versionsの値が使用されます。
• 使用方法: export ASDF_DEFAULT_TOOL_VERSIONS_FILENAME=tool_versions

ASDF_DIR ​

asdfのコアスクリプト場所です。任意の場所に設定できます。必ず絶対パスで設定してください。

• 未設定の場合: bin/asdf実行ファイルの親ディレクトリが使用されます。
• 使用方法: export ASDF_DIR=/home/john_doe/.config/asdf

ASDF_DATA_DIR ​

asdfがプラグイン、Shim、ツールのバージョンをインストールする場所です。任意の場所に設定できます。必ず絶対パスで設定してください。

• 未設定の場合: $HOME/.asdfディレクトリが存在すればその場所、存在しない場合はASDF_DIRの値を使用します。
• 使用方法: export ASDF_DATA_DIR=/home/john_doe/.asdf

ASDF_CONCURRENCY ​

ソースコードのコンパイル時に使用するコア数です。この環境変数の値は、asdf構成ファイルのconcurrencyの値よりも優先されます。

• 未設定の場合: asdf構成ファイルのconcurrencyの値が使用されます。
• 使用方法: export ASDF_CONCURRENCY=32

ASDF_FORCE_PREPEND ​

asdfのShimやパスのディレクトリをPATHの先頭(最高優先度)に追加するかどうかを設定します。

• 未設定の場合: macOSでのデフォルト値はyes、その他のシステムでのデフォルト値はnoです。
• yesの場合: asdfディレクトリを強制的にPATHの先頭に配置します。
• yes以外の文字列を設定した場合: asdfディレクトリを強制的にPATHの先頭に配置することは しません 。
• Usage: ASDF_FORCE_PREPEND=no . "<path-to-asdf-directory>/asdf.sh"

完全な構成の例 ​

下記のように、asdfをシンプルにセットアップしたとします:

• Bashシェル
• インストール先は$HOME/.asdf
• Git経由でインストール
• 環境変数は何も設定していない
• .asdfrcファイルは何もカスタマイズしていない

すると、結果として以下のような構成となります:

内部構成 ​

この節では、パッケージマネージャやインテグレータ向けのasdfの内部構成について記述しているため、ユーザが気にする必要はありません。

• $ASDF_DIR/asdf_updates_disabled: このファイルが存在する場合、asdf updateコマンドによる更新は無効になります(ファイル内容は関係ありません)。これは、PacmanやHomebrewのようなパッケージマネージャによって使用され、特定のインストールに対して正しい更新方法を適用するようにします。