Vagrant のインストール(Ubuntu 上)
Ubuntu 24.04環境でのVagrantインストールは、システム更新とVirtualBoxの準備の後に行う。Ubuntu 24.04のリポジトリにはvagrantパッケージが存在しないため、HashiCorp公式のAPTリポジトリ、または公式サイトの.debパッケージを用いる。バージョン確認方法と、Vagrantfileでの適切なBox指定が必要である。
【サイト内の関連ページ】
前準備
Ubuntu のシステム更新
Ubuntu OS のシステムを最新の状態に更新するには, 端末で次のコマンドを実行する.
# パッケージリストの情報を更新
sudo apt update
# インストール済みのパッケージを包括的に更新 (依存関係も考慮)
sudo apt full-upgrade
# 変更をシステム全体に確実に反映させるために再起動
sudo shutdown -r now
VirtualBox のインストール
Vagrant は仮想化ソフトウェア(プロバイダ)を利用する.ここでは既定のプロバイダである VirtualBox を使用する.
- Windows での VirtualBox のインストール: 別ページ »で詳細を説明している.
- Ubuntu での VirtualBox のインストール: 別ページ »で詳細を説明している (カーネルヘッダー等、依存関係のインストールも含む).
Vagrant は VirtualBox 以外に、KVM/libvirt や Docker などのプロバイダも利用できる.Ubuntu 24.04 LTS 以降は Canonical による公式 Vagrant Box の提供が行われていないため、libvirt プロバイダと Ubuntu Cloud Images を組み合わせる方法もある.
Vagrant のインストール
Ubuntu 24.04 LTS のリポジトリには vagrant パッケージが含まれていないため、sudo apt install vagrant だけではインストールできない.HashiCorp が提供する APT リポジトリを追加する方法、または公式サイトから .deb パッケージをダウンロードする方法を用いる.
方法1: HashiCorp 公式 APT リポジトリを用いたインストール
リポジトリを追加すると、以後は apt によるアップデートの対象になる.端末で次のコマンドを実行する.
# HashiCorp の公開鍵を取得し、APT が参照する形式と場所に配置
wget -O - https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
# リポジトリ設定ファイルを作成 (鍵ファイルとディストリビューションのコードネームを指定)
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(grep -oP '(?<=UBUNTU_CODENAME=).*' /etc/os-release || lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
# パッケージリストを更新し、Vagrant をインストール
sudo apt update
sudo apt install vagrant
方法2: 公式サイトからの .deb パッケージを用いたインストール
HashiCorp 公式サイトのインストールページから Linux 向けの .deb パッケージ (例: vagrant_<バージョン>-1_amd64.deb) をダウンロードし、端末で次のコマンドを実行してインストールする.
# ダウンロードした .deb パッケージを指定してインストール (ファイル名は適宜変更)
sudo apt install ./vagrant_<バージョン>-1_amd64.deb
プラグインのインストール
SSHFS 経由での同期フォルダなど、追加機能はプラグインとして導入する.端末で次のコマンドを実行する.
# ホスト側に sshfs を導入
sudo apt install sshfs
# Vagrant のプラグインとして vagrant-sshfs を導入
vagrant plugin install vagrant-sshfs
インストール確認
インストール後、端末で次のコマンドを実行して Vagrant のバージョンが表示されることを確認する.
vagrant --version
インストール後の注意点:
- Vagrant の設定ファイルである
Vagrantfile内でconfig.vm.boxに指定する Box は、Ubuntu 24.04 に対応したもの (例:bento/ubuntu-24.04) を選択する.Canonical (ubuntu/*) の Box は Ubuntu 24.04 以降について提供されていない.