improve docs

README

@@ -2,33 +2,10 @@
 Perl 入学式 開発環境 VirtualBox
 ==========
 
-仮想アプライアンス作成用の VM を Vagrant で起動
-----------
+仮想アプライアンスを使っての環境構築手順等は、
+docs/user-manual.txt
 
-    cd vagrant/base
-    vagrant up
+仮想アプライアンスを作るほうは、
+docs/dev-manual.txt
 
-    # SSH 接続して中身確認
-    vagrant ssh
-
-    # 停止
-    vagrant halt
-
-
-仮想アプライアンス作成
----------
-
-    # VM は停止した状態で
-    VBoxManage export "perl-entrance-fukuoka" \
-        --output perl-entrance-fukuoka-$(date +%Y%m%d).ova
-
-各種設定
----------
-
-| account | password  |
-|---------|-----------|
-|   root  | vagrant   |
-|   user1 | usestrict |
-|   user2 | usestrict |
-
-( user2 には perlbrew + cpanm + Plack をあらかじめ準備済 )
+を参照

docs/dev-manual.txt

@@ -0,0 +1,37 @@
+
+Vagrant で Base box を作成
+----------
+- veewee で CentOS-6.3-x86_64-minimal をベースに作成
+- https://dl.dropbox.com/u/1981687/CentOS-6.3-x86_64-minimal-ja.box
+
+
+仮想アプライアンス作成用の VM を Vagrant で起動
+----------
+
+    cd vagrant/base
+    vagrant up
+
+    # SSH 接続して中身確認
+    vagrant ssh
+
+    # 停止
+    vagrant halt
+
+
+仮想アプライアンス作成
+---------
+
+    # VM は停止した状態で
+    VBoxManage export "perl-entrance-fukuoka" \
+        --output perl-entrance-fukuoka-$(date +%Y%m%d).ova
+
+各種設定
+---------
+
+| account | password  |
+|---------|-----------|
+|   root  | vagrant   |
+|   user1 | usestrict |
+|   user2 | usestrict |
+
+( user2 には perlbrew + cpanm + Plack をあらかじめ準備済 )

docs/user-manual.txt

@@ -0,0 +1,66 @@
+
+環境構築手順 - Perl入学式 in 福岡 
+==========
+
+Perl入学式 in 福岡 での環境構築について
+----------
+各 OS 毎に環境構築する方法はありますが、
+今回は以下の目的のため VirtualBox に Linux (CentOS) を準備し構築します。
+
+- どの OS をご利用のかたも同じ手順をおこなっていただくため
+- みなさんのPC環境を極力汚さないようにするため
+- 実際にWebのサービスを公開するような場合、
+  Linuxサーバを利用することが多いため
+
+VirtualBox のインストール
+----------
+インストーラーをダウンロード
+- https://www.virtualbox.org/wiki/Downloads
+- 当日はUSBメモリで配布
+
+インストーラーを起動し、あとは手順にそって行う
+
+Perl入学式用 仮想アプライアンス(イメージ) の読み込みと起動
+----------
+仮想アプライアンスインポート
+- https://dl.dropbox.com/u/1981687/perl-entrance-fukuoka-20121124.ova
+- 当日はUSBメモリで配布
+
+設定
+----------
+* ネットワーク
+  - hostonly ネットワークを追加する
+
+* 共有フォルダ
+  - デスクトップ にフォルダ perl-entrance-fukuokaを作成し、
+    共有フォルダ追加
+
+* 起動後の確認
+
+- hostonly ネットワークでの IP アドレスを確認
+
+      ifconfig
+
+
+* SSH でログイン
+
+      ssh user1@[hostonly ネットワークでの IP アドレス]
+      # usestrict
+
+* perlbrew のインストール
+
+    curl -kL http://install.perlbrew.pl | bash
+
+* perlbrew で perl-5.12.5 をインストール
+
+    perlbrew available
+    perlbrew -v install perl-5.12.5
+
+* cpanm のインストール
+
+    perlbrew install-cpanm
+
+* Plack のインストール
+
+    cpanm -v Plack
+