Vagrantの更新で仮想マシン操作に失敗するようになった件
はじめに
CentOS 7 が 2024/06/30 に EOL を迎えたことで、AlmaLinux などに OS を移行したところも多かったのではないでしょうか?
私は業務や検証環境の仮想マシンを Vagrant で管理しており、
CentOS 7 → AlmaLinux 9 への移行過程で、いくつかの問題に直面しました。
本記事では OS移行が Vagrant にどのような影響を与えるか をお伝えします。
本記事で伝えたいポイント
Vagrant は Ruby を基盤としたアプリケーションであり、
Vagrantfile や box 内に含まれるリソースファイルも
「単なる設定」ではなく Ruby のコードとして実行される。そのため OS 移行に伴う Ruby バージョン変更は、
Vagrant の設定ファイルそのものにも影響を与える。
対象読者
- CentOS 7 から AlmaLinux 9 への移行を検討している方
- Vagrant を業務や検証環境で利用している方
前提環境
VagrantがシステムのRubyでなく同梱のRubyで動く点が重要です。
- 旧環境 : CentOS 7.9、Vagrant v2.2、Ruby v2.5
- 新環境 : AlmaLinux 9.7、Vagrant v2.4、Ruby v3.3
OS移行で何が変わるのか(概要)
OS移行、というより Vagrant のバージョンアップにより、以下の点が変化します。
- Ruby のバージョン
- RubyGems / native extension の互換性
- Vagrant Plugin の動作可否
影響①:Ruby バージョンの違い
Vagrantのバージョンアップに伴い、Rubyのメジャーバージョンが更新されました。
CentOS 7時点
- Vagrant 同梱 Ruby 2.0.x(非常に古い)
- 非推奨 API もまだ動作していた
AlmaLinux 9時点
- Vagrant 同梱 Ruby 3.x 系
- v3.2で多くの非推奨 API が削除
影響②:Vagrantfile は「設定」ではなく Ruby コード
仮想マシン定義に該当する Vagrantfile は、一見すると設定ファイルに見えますが、実体は Ruby のコード です。(Rubyの構文がそのまま使えます)
これはユーザーが作成する Vagrantfile だけでなく、
box ファイル内に含まれる Vagrantfile も同様です。
トラブル例:vagrant upが失敗する
box ファイル内に含まれる Vagrantfile に、以下のような非推奨APIの記述がありました。移行後のRuby 3.3 では exists? は削除されており、構文エラーになっていました。
if File.exists?("/some/path/config.yml")
# 処理
end
対応方法
非推奨API exists? を 代替API exist? に置き換えました。なお、 exist? は Ruby 1 から使えるため、Rubyのバージョンを見て...などの対応も不要でした。
(古くはexists?が好まれたが、方針統一のためexist?が残された模様)
if File.exist?("/some/path/config.yml")
# 処理
end
今回の結論:Vagrant のリソースは Ruby ファイルとして扱う
- Vagrant は Ruby アプリケーション
- Vagrantfile は Ruby スクリプト
- box 内の Vagrantfile も Ruby スクリプト
- OS移行に伴う Vagrant のバージョンアップは Ruby 移行でもある
次回予告
次回は、
- vagrant-libvirt plugin
- libvirt / qemu 依存
といった より OS 依存度の高い要素(libvirt編) を扱う予定です。
おわりに
同様の OS 移行や Vagrant 利用でハマった点があれば、
ぜひコメントで共有してもらえると嬉しいです。
Discussion