✌️

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