Vagrant のインストール(Ubuntu 上)

Ubuntu 24.04環境でのVagrantインストールは、システム更新とVirtualBoxの準備の後に行う。Ubuntu 24.04のリポジトリにはvagrantパッケージが存在しないため、HashiCorp公式のAPTリポジトリ、または公式サイトの.debパッケージを用いる。バージョン確認方法と、Vagrantfileでの適切なBox指定が必要である。

サイト内の関連ページ

前準備

Ubuntu のシステム更新

Ubuntu OS のシステムを最新の状態に更新するには, 端末で次のコマンドを実行する.

Ubuntu のインストールは別ページ »で説明している.

# パッケージリストの情報を更新
sudo apt update

# インストール済みのパッケージを包括的に更新 (依存関係も考慮)
sudo apt full-upgrade

# 変更をシステム全体に確実に反映させるために再起動
sudo shutdown -r now

VirtualBox のインストール

Vagrant は仮想化ソフトウェア(プロバイダ)を利用する.ここでは既定のプロバイダである 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

インストール後の注意点: