alternativesコマンドで複数バージョンを管理する方法｜Java・Pythonの切り替えと--configオプションの実践

この記事のポイント

・RHEL 系は alternatives、Debian 系は update-alternatives コマンドでバージョン管理する
・alternatives --config java で対話的にバージョンを切り替え、--set で非対話的に固定できる
・--install で自前のバイナリを alternatives データベースに登録できる
・/etc/alternatives/ 配下のシンボリックリンクが実際の切り替え先として機能する

# シンボリックリンクの構造を確認する
$ ls -la /usr/bin/java
lrwxrwxrwx 1 root root 22 Jan 10 09:00 /usr/bin/java -> /etc/alternatives/java

$ ls -la /etc/alternatives/java
lrwxrwxrwx 1 root root 43 Jan 10 09:00 /etc/alternatives/java -> /usr/lib/jvm/java-17-openjdk-amd64/bin/java

# 登録済みの alternatives を一覧表示（RHEL 系）
$ alternatives --list
java            auto    /usr/lib/jvm/java-17-openjdk-x86_64/bin/java
javac           auto    /usr/lib/jvm/java-17-openjdk-x86_64/bin/javac
python          manual  /usr/bin/python3.9
python3         auto    /usr/bin/python3.11

# 特定の alternatives の詳細を確認
$ alternatives --display java
java - status is auto.
 link currently points to /usr/lib/jvm/java-17-openjdk-x86_64/bin/java
/usr/lib/jvm/java-11-openjdk-x86_64/bin/java - priority 11
/usr/lib/jvm/java-17-openjdk-x86_64/bin/java - priority 17
Current `best' version is /usr/lib/jvm/java-17-openjdk-x86_64/bin/java.

# alternatives コマンドで Java を対話的に切り替える（root または sudo が必要）
$ sudo alternatives --config java

There are 2 programs which provide 'java'.

  Selection    Command
-----------------------------------------------
*+ 1           java-17-openjdk.x86_64 (/usr/lib/jvm/java-17-openjdk-x86_64/bin/java)
   2           java-11-openjdk.x86_64 (/usr/lib/jvm/java-11-openjdk-x86_64/bin/java)

Enter to keep the current selection[+], or type selection number: 2

# 切り替え後にバージョンを確認
$ java -version
openjdk version "11.0.22" 2024-01-16 LTS

# Java 11 に非対話的に切り替える（スクリプト・Ansible からも使える）
$ sudo alternatives --set java /usr/lib/jvm/java-11-openjdk-x86_64/bin/java

# auto モードに戻す（priority 最高のものに自動選択）
$ sudo alternatives --auto java

# 切り替え確認
$ java -version
openjdk version "11.0.22"

# Java 11 と Java 17 の両方をインストール
$ sudo dnf install java-11-openjdk java-17-openjdk

# インストール後に java の alternatives が自動登録されているか確認
$ alternatives --display java

# java コマンドだけでなく javac も切り替える（セットで変更するのが安全）
$ sudo alternatives --config javac
$ sudo alternatives --config java

# 切り替え確認
$ java -version && javac -version

# RHEL9 で python3.11 をインストール
$ sudo dnf install python3.11

# python3 の alternatives に python3.11 を登録
# --install    
$ sudo alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 20

# python3.9 も alternatives に登録
$ sudo alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 9

# 登録確認
$ alternatives --display python3

# 切り替え
$ sudo alternatives --config python3

# 動作確認
$ python3 --version
Python 3.11.9

# 書式: alternatives --install    
#    : /usr/bin/ 配下の最終的なリンクパス
#    : alternatives グループ名（--config で指定するもの）
#    : 実際のバイナリの絶対パス
# : 数値（高いほど auto モードで優先）

# 例: /opt/jdk-21/bin/java を alternatives に登録する
$ sudo alternatives --install /usr/bin/java java /opt/jdk-21/bin/java 21

# 登録確認
$ alternatives --display java

# 登録を削除する場合（path ごとに1行削除する）
$ sudo alternatives --remove java /opt/jdk-21/bin/java

# alternatives リンクが壊れていないか確認
$ ls -la /etc/alternatives/java
lrwxrwxrwx ... /etc/alternatives/java -> /usr/lib/jvm/java-17-openjdk-x86_64/bin/java

# リンク先が存在するか確認
$ ls /usr/lib/jvm/java-17-openjdk-x86_64/bin/java
ls: cannot access '/usr/lib/jvm/java-17-openjdk-x86_64/bin/java': No such file or directory
# → パッケージが削除されたがリンクが残っている

# 壊れたエントリを削除してから再設定する
$ sudo alternatives --remove java /usr/lib/jvm/java-17-openjdk-x86_64/bin/java
$ sudo alternatives --config java