インストール - Vagrantのソースを表示

== 概要 ==
Vagrantfileとは、仮想マシンの構築設定などを記述するためのファイルである。<br>
例えば、"仮想マシンはCeontOS 7をインストールする"、"IPアドレスを192.168.10.10にする"等である。<br>
<br>
Vagrantfileは、以下のような特徴がある。<br>
* 仮想マシンの基本設定を記述できる。
* ファイルなので共有が簡単。
* 環境構築手順ファイルを呼び出せる。
* Ruby言語で記述する。
<br>
Vagrantのコマンドを実行する時、自動的にVagrantfileが読み込まれて、記述内容にしたがって仮想マシンが構築される仕組みである。<br>
Vagrantfileは一般的なファイルなので、多くのユーザに共有することもできる。<br>
また、仮想マシンの構築後に必要なパッケージをインストールする場合、別ファイルに詳細な手順を記述して、Vagrantfileから呼び出すこともできる。<br>
<br><br>

== 依存関係のライブラリのインストール ==
Vagrantの依存関係のライブラリをインストールするため、以下のライブラリをインストールする。<br>
以下のライブラリが無い場合、<code>vagrant box add</code>コマンドが失敗する可能性がある。<br>
 sudo zypper install bsdtar
<br><br>

== Vagantのインストール ==
==== バイナリファイルからインストール ====
# まず、[https://www.vagrantup.com/downloads.html Vagrantの公式Webサイト]にアクセスして、各プラットフォーム向けのVagrantをダウンロードする。<br>
#: <br>
# Vagrantを以下の手順に従ってインストールする。
#* RPMを使用する場合
#*: ダウンロードしたRPMファイルに対して、以下のコマンドを実行する。
#*: <code>sudo rpm -Uvh vagrant-<バージョン>.x86_64.rpm</code>
#*: <br>
#* AppImageを使用する場合
#*: ダウンロードしたファイルを解凍する。
#*: <code>unzip vagrant_<バージョン>_linux_amd64.zip</code>
#*: <br>
#*: 解凍したAppImageファイルのフルパスを、.profileファイル等に環境変数PATHを記述する。
#*: <code>vi ~/.profile</code>
#*: <br>
#*: <code>~/.profileファイル</code>
#*: <code>export PATH="<VagrantのAppImageファイルのパス>:$PATH"</code>
#*: <br>
#* Windows
#*: ダウンロードしたVagrantのインストーラを起動して、手順にしたがってインストールする。
#*: <br>
# PCを再起動する。
<br>
==== ソースコードからインストール ====
<u>ソースコードからVagrantをインストールする場合、公式インストーラが使用できない場合にのみ推奨する。</u><br>
<br>
ソースコードからVagrantをインストールするための前提条件と3つのステップについて以下に示す。<br>
# Rubyをインストールする。
# Vagrantをクローンする。
# ローカルで設定する。
<br>
まず、Rubyをインストールする。<br>
Vagrantをビルドするには、特定のバージョンのRubyをインストールする必要がある。<br>
必要なRubyのバージョンは、[https://github.com/hashicorp/vagrant VagrantのGithub]にあるvagrant.gemspecに記載されている。<br>
<br>
また、Vagrantをソースコードからインストールする場合は、プラグインの互換性にも注意する必要がある。<br>
Vagrantのプラグインは現在の環境に基づいて設定されるため、ソースコードからVagrantでインストールしたプラグインは、パッケージベースのVagrantインストールでは動作しないことに注意する。<br>
 sudo zypper install make gcc ruby rubygem-bundler nodejs libopenssl-devel sqlite3-devel
<br>
次に、Vagrantのソースコードをクローンする。<br>
 git clone https://github.com/hashicorp/vagrant.git
<br>
次に、クローンしたVagrantパスを~/.profileファイル等に環境変数PATHを設定する。<br>
 vi ~/.profile
<br>
 <syntaxhighlight lang="sh">
 # ~/.profileファイル
 
 export PATH="<Vagrantのパス>:$PATH"
 </syntaxhighlight>
<br>
必要なライブラリおよびプラグインをインストールする。<br>
 cd <Vagrantのパス>
 bundle install
<br>
<code>bundle</code>コマンドを実行して、Vagrantを起動する。<br>
 bundle exec vagrant
<br><br>

== Vagrant VMwareのインストール ==
Vagrant VMware WorkstationまたはVagrant VMware Fusionプラグインからアップグレードする場合、Vagrantで管理している全てのVMware上の仮想マシンを停止または破棄する。<br>
その後、以下の手順に従う。<br>
<br>
Vagrant VMwareプロバイダのインストールには2つのステップが必要である。<br>
<br>
まず、Vagrant VMwareユーティリティをインストールする。<br>
これは、[https://developer.hashicorp.com/vagrant/downloads/vmware Vagrant VMwareユーティリティの公式Webサイト]から、RPMファイルをダウンロードしてインストールする。<br>
 sudo zypper install ./vagrant-vmware-utility-<バージョン>.x86_64.rpm
<br>
次に、Vagrant VMwareプロバイダプラグインを標準のプラグインインストール手順でインストールする。<br>
 vagrant plugin install vagrant-vmware-desktop
<br>
プラグインのインストールについて詳細を知りたい場合は、[https://developer.hashicorp.com/vagrant/docs/plugins/usage Vagrantプラグインの公式Webドキュメント]を参照すること。<br>
<br>
Vagrant VMware Desktopプラグインをアップデートする場合は、Vagrantから直接アップデートすることができる。<br>
 vagrant plugin update vagrant-vmware-desktop
<br><br>

== Vagrantの使用方法 ==
==== Vagrantfileを作成 ====
ターミナルを起動して、以下のコマンドを実行する。<br>
 vagrant init
<br>
==== Vagrantfileの設定 ====
Vagrantfileをテキストエディタで開く。<br>
<br>
以下に、Vagrantfileの設定例を示す。<br>
以下の例では、CeontOS 7をインストールしているので、<code>config.vm.box = "centos/7"</code>と記述している。<br>
 VAGRANTFILE_API_VERSION = "2"
 Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
   config.vm.box = "centos/7"
   config.vm.network :private_network, ip: "192.168.33.10"
   config.vm.provider "virtualbox" do |vb|
     vb.name = "training"
     vb.gui = false
     vb.memory = "2048"
   end
   config.ssh.private_key_path = "<SSHの暗号鍵ファイルのフルパス>"
   config.ssh.insert_key = false
   if Object.const_defined? 'VagrantVbguest'
     config.vbguest.auto_update = false
     config.vbguest.no_remote = true
   end
 end
<br>

==== 仮想マシンの作成 ====
boxファイルから仮想マシンを作成する場合、以下のコマンドを実行する。<br>
box名は、Vagrantfileファイルに記述した<code>config.vm.box = <box名></code>のbox名を入力する。<br>
 vagrant box add <box名> <boxファイルのパス>
<br>

==== 仮想マシンの起動 ====
上記の手順により、Vagrantを起動する準備が整う。<br>
ターミナルから以下のコマンドを実行して、仮想マシンを作成する。<br>
 vagrant up
<br>
<code>vagrant up</code>は、Vagrantfileの内容にしたがって仮想マシンを構築して起動する。<br>
この時、バックグラウンドではVirturalBoxが起動して、仮想マシンの作成が開始する。<br>
<br>
<code>vagrant up</code>は、実行するタイミングにより動作が変化するので注意すること。<br>
初回は、仮想マシンの構築と起動を行うが、2回目以降は仮想マシンの起動のみとなる。<br>
ただし、2回目以降もVagrantfileが読み込まれていることは覚えておくこと。<br>
* 仮想マシンを構築して起動(初回のみ)
* 仮想マシンを起動(2回目以降)
<br>
==== 仮想マシンにログイン ====
仮想マシンの起動後、以下のコマンドを実行して、仮想マシンにログインする。<br>
 vagrant ssh
<br>
これにより、仮想マシンにおいて、vagrantユーザでログインできる。<br>
また、vagrantユーザは標準で作成される。<br>
<br>
==== 仮想マシンからログアウト ====
仮想マシンからログアウトする場合は、[Ctrl] + [d]キーを同時押下、または、以下のコマンドを実行する。<br>
 exit
<br>
==== 仮想マシンの停止 ====
仮想マシンを停止する場合は、以下のコマンドを実行する。<br>
 vagrant halt
<br>
==== 仮想マシンの削除 ====
仮想マシンを削除する場合は、以下のコマンドを実行する。<br>
 vagrant box remove -f  <box名>
 または
 vagrant destroy
 または
 vagrant destroy <box名>
<br>
<code>vagrant destroy</code>コマンドを実行しても、.vagrantディレクトリやVagrantfileファイルは残る。<br>
この設定ファイルには、以前、vagrant box addしたbox情報が記述されている。<br>
<br>
<code>vagrant destroy</code>コマンドは、仮想マシンを削除する以外にも、仮想マシンを再作成する場合にも使用する。<br>
<br><br>

==== box名の変更 ====
boxの実体ファイルをリネームするだけでbox名を変更することができる。<br>
boxの実体ファイルは、$HOME/.vagrant.d/boxesに存在する。<br>
 mv ~/.vagrant.d/boxes/<boxのファイル名> ~/.vagrant.d/boxes/<boxの新しいファイル名>
<br>
次に、<code>vagrant init</code>コマンドを実行して、新しいbox名を指定する。<br>
 vagrant init <boxの新しいファイル名>
<br><br>

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]