👋

Vagrantのボックスは動作を確認してから利用しよう

2021/02/21に公開

Vagrant

vagrantbox

tech

はじめに

先日、Vagrantのボックスが原因で問題が発生したため、ボックスを使用する際はあらかじめきちんと動作するかどうかを確かめてから使おうという個人的な注意書きです。

もちろん、一概にボックスが原因とは言えませんが、先日のケースではいくら設定を確認してもおかしな点は存在せず、別のボックスで試したら問題なく動作したので、ボックスを変更すると、もしかしたら原因不明の問題が解決するかもしれない、といった程度で捉えていただけると幸いです。

体験談

自分はボックスの入手先としてVagrantbox.esを利用しています。OSの種類やバージョンが豊富なので重宝しています。

ところが、先日ダウンロードした Ubuntu Server 16.04 LTS のボックスでサーバを作成したところ、$ vagrant sshによるログインはできますが、FTPクライアント(Cyberduck)によるログインができませんでした。

ユーザ名やパスワードは何回確認しても間違っておらず、ポートも閉じていませんし、ネットワークの設定も問題ありませんでした。パスワード認証も鍵認証も許可している状態で、両方とも試しましたがダメでした。新しいサーバを作り直しても結果は同じでした。

ネットの情報も一通り漁って気になる内容はすべて試しましたが一向に解決しないので、仕方なく別のボックスをダウンロードすることに。ところが今度はそもそも$ vagrant upができない状況でした。GUIによるログインはできたのでおそらくVagrantの問題ではありますが、全く同じ現象についての解決方法をネットで見つけて試しても原因は解決しませんでした。

3度目の正直、3つめにダウンロードしたボックスではちゃんとVagrant側からも起動でき、FTPクライアントによるログインもできました。

使用の前に確認を

結局原因が不明、というのが腑に落ちないですが、もしこれがボックスによるものだとしたら、あるいはそうでなくともボックスを変更したことにより問題なく動作したことから、Vagrantのボックスは問題なく動作するかを確かめてから使用することが重要であることを強く思いました。

というのは、FTPクライアントでのログインができなかったボックスで作成したテストサーバに、すでに諸々の環境構築とセッティングを済ませた後にようやく問題に気づいたので、再び環境構築をし直すはめになりました。

もちろんこれは自分の責任ですし、そもそもVagrantbox.esは自己責任ということを承知した上で使用することになっているので、誰にも文句は言えない（むしろ感謝ですね🙏）のですが、ちゃんと確認しておかないと後で痛い目を見ることになるよ、という自分に対する警告であります。

信頼できるボックス

これだけで終わってしまうとただの注意書きなので、自分が使用して問題なく動作したボックスのソースをここに載せておきます。ただし、これはあくまでぼくの環境で問題なかっただけなので、全環境で問題なく動作することを保証するものではないことをご了承ください。

CentOS

❗️ Vagrantbox.esのURLではないことに注意してください。Vagrantbox.esのURLはアップデートされることがあるので、このURLをVagrantbox.es内で検索してヒットした際のURLをご使用ください。また検索してもヒットしない場合は削除された可能性があります。ご了承ください。

Ubuntu

❗️ CentOSと同様に削除される可能性があります。ご了承ください。

環境

問題なく動作した環境は以下の通りです。繰り返しになりますが、この環境なら絶対に問題がないという保証はできませんのでご了承ください。

macOS Sierra バージョン 10.12
Vagrant 1.8.6
VirtualBox バージョン 5.0.22 r108108

公式が配布するボックス

Vagrantbox.esは非公式ですが、どうやら公式が配布するボックスがあるらしいです。こちらを使用すれば少なくともボックスによる問題は減らせると思います。

https://atlas.hashicorp.com からダウンロードします。https://atlas.hashicorp.com/ダウンロードしたいOS にアクセスします。今回はUbuntuを例に取り、https://atlas.hashicorp.com/ubuntu にアクセスします。CentOSの場合はubuntuの箇所をcentosとします。

するとUbuntuのボックス一覧が表示されます。ここからダウンロードしたいOSのバージョンを選択します。今回は Ubuntu 16 をインストールしたいのでubuntu/xenial64を選択します。ちなみにxenialは Ubuntu 16 のコードネーム、64は64bit用を意味します。

するとバージョン一覧が表示されます。とりあえず最新バージョンをインストールしたい場合は一番上に表示されたバージョンを選択します。

このようなページが表示されたらこのページのURLをコピーします。ボックスのダウンロードURLは、このページのURLに/providers/virtualbox.boxをつけたURLになります。例えば、https://atlas.hashicorp.com/ubuntu/boxes/xenial64/versions/xxxxxxxx.x.x/providers/virtualbox.box のような形式になります。
参考: VagrantでUbuntu Server 16.04 LTS "Xenial Xerus"の仮想マシンの構築（未完）

あとはこのURLを使用してボックスをダウンロードすれば公式のボックスが利用できるようになります。
$ vagrant box add ボックス名ボックスのURL

さいごに

この記事を書いた時点では解決策が見つかりませんでしたが、後日、FTPクライアントからログインできない問題の解決策が見つかりました。Vagrantで作成したローカルサーバにFTPクライアント(Cyberduck)からログインできないときの解決法を参照してください。

しかし、この解決策を見つけたときにはすでにボックスを削除してしまったので、同様の解決法で解決できたかどうかはわかりません。また、ボックスによってパスワード認証ができたりできなかったりする原因や、$ vagrant ssh ができない問題の原因は結局わかりませんでした。

いずれにしてもVagrantのボックスをダウンロードするときは動作を確認してから利用したほうが無難です。

GitHubで編集を提案