開発環境を作ってみる¶

Karesansuiをインストール¶

チュートリアルのKaresansuiのインストールを参照し、インストールを行います。

開発環境構築コマンド¶

Karesansuiには開発者向けの構築コマンドがあります。これを実行する事で簡単に構築することができます。

手順¶

* コマンドの実行

# cd /opt/karesansui/share/doc/karesansui-2.0.1/tool
# ./mk_opendev.sh

構築コマンド内部説明¶

• 事前準備
• ネットワーク環境にproxyが存在する場合は、41行目の proxy_host を設定してください。

• ディストリビューションに入っている重複パッケージを除去します。
• Karesansuiに必要なパッケージをインストールします。
• 開発用フォルダを設定します。>作業したいフォルダを指定します。※推奨は「/git」フォルダです。
• wget, lftp, ntpが入っていないときはインストールを行います。
• Karesansui Projectが提供するyumリポジトリからgitをインストールします。
• ntpサービスを起動します。
• 開発用フォルダを作成します。
• sourceforge.jpにあるリポジトリ(git)からチェックアウト(clone)します。
  ※Karesansuiリポジトリは開発用フォルダ配下に「karesansui.git」配置されます。
• Karesansuiリポジトリの開発版は、devブランチで行われていますので自動でそちらにSwitch(git)します。
• インストールされたKaresansuiのプログラム「/opt/karesansui/lib/python/karesansuiを「/opt/karesansui/lib/python/karesansui」にリネームします。
• チェックアウトしたリポジトリ(git)にある必要なファイルを各々シンボリックリンクで/opt/karesansui配下に配置します。※権限設定も合わせて行います。
  ※Karesansuiの権限は基本的にkssユーザを使用します。lighttpdはwwwhdeユーザで動作します。

mk_opendev.shの実行結果(example)¶

[root@localhost tool]# ./mk_opendev.sh 
Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
 * addons: www.ftp.ne.jp
 * base: www.ftp.ne.jp
 * extras: www.ftp.ne.jp
 * updates: www.ftp.ne.jp
addons                                                                                                                                                      |  951 B     00:00     
base                                                                                                                                                        | 2.1 kB     00:00     
extras                                                                                                                                                      | 2.1 kB     00:00     
updates                                                                                                                                                     | 1.9 kB     00:00     
Setting up Install Process
Package gnutls-utils-1.4.1-3.el5_4.8.x86_64 already installed and latest version
Package PyXML-0.8.4-4.el5_4.2.x86_64 already installed and latest version
Package perl-HTML-Parser-3.55-1.fc6.x86_64 already installed and latest version
Package perl-URI-1.35-3.noarch already installed and latest version
Nothing to do
Working Directory[default:/root]                       :/git

Proceed to build development environment, then press enter.
Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
 * addons: www.ftp.ne.jp
 * base: www.ftp.ne.jp
 * extras: www.ftp.ne.jp
 * updates: www.ftp.ne.jp
karesansui-devel                                                                                                                                            |  951 B     00:00     
karesansui-devel/primary                                                                                                                                    |  13 kB     00:00     
karesansui-devel                                                                                                                                                             41/41
Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package git.x86_64 0:1.7.1-1 set to be updated
--> Processing Dependency: perl-Git = 1.7.1-1 for package: git
--> Processing Dependency: perl(DBI) for package: git
--> Processing Dependency: perl(Git) for package: git
--> Running transaction check
---> Package perl-DBI.x86_64 0:1.52-2.el5 set to be updated
---> Package perl-Git.x86_64 0:1.7.1-1 set to be updated
--> Finished Dependency Resolution

Dependencies Resolved

===================================================================================================================================================================================
 Package                                  Arch                                   Version                                    Repository                                        Size
===================================================================================================================================================================================
Installing:
 git                                      x86_64                                 1.7.1-1                                    karesansui-devel                                 6.2 M
Installing for dependencies:
 perl-DBI                                 x86_64                                 1.52-2.el5                                 base                                             600 k
 perl-Git                                 x86_64                                 1.7.1-1                                    karesansui-devel                                  17 k

Transaction Summary
===================================================================================================================================================================================
Install       3 Package(s)
Upgrade       0 Package(s)

Total download size: 6.8 M
Downloading Packages:
(1/3): perl-Git-1.7.1-1.x86_64.rpm                                                                                                                          |  17 kB     00:00     
(2/3): perl-DBI-1.52-2.el5.x86_64.rpm                                                                                                                       | 600 kB     00:00     
(3/3): git-1.7.1-1.x86_64.rpm                                                                                                                               | 6.2 MB     00:05     
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                                                              570 kB/s | 6.8 MB     00:12     
警告: rpmts_HdrFromFdno: ヘッダ V3 DSA signature: NOKEY, key ID 8c0505ed
karesansui-devel/gpgkey                                                                                                                                     | 1.7 kB     00:00     
Importing GPG key 0x8C0505ED "Karesansui Project Key (Karesansui Project Official Signing Key) <karesansui-key@karesansui-project.info>" from /etc/pki/rpm-gpg/RPM-GPG-KEY-Karesansui
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
  Installing     : perl-DBI                                                                                                                                                    1/3 
  Installing     : git                                                                                                                                                         2/3 
  Installing     : perl-Git                                                                                                                                                    3/3 

Installed:
  git.x86_64 0:1.7.1-1                                                                                                                                                             

Dependency Installed:
  perl-DBI.x86_64 0:1.52-2.el5                                                              perl-Git.x86_64 0:1.7.1-1                                                             

Complete!

ntpd を停止中:
11 Nov 22:28:33 ntpdate[5980]: step time server 210.171.226.40 offset 280.294142 sec
ntpd を起動中:                                             [  OK  ]

Proceed to build development environment, then press enter.        
/git /opt/karesansui/share/doc/karesansui-2.0.1/tool
Initialized empty Git repository in /git/karesansui/.git/
remote: Counting objects: 14433, done.
remote: Compressing objects: 100% (3193/3193), done.
remote: Total 14433 (delta 10153), reused 14409 (delta 10137)
Receiving objects: 100% (14433/14433), 4.94 MiB | 3.55 MiB/s, done.
Resolving deltas: 100% (10153/10153), done.
/git/karesansui.git /git /opt/karesansui/share/doc/karesansui-2.0.1/tool
Branch dev set up to track remote branch dev from origin.
Switched to a new branch 'dev'
/git /opt/karesansui/share/doc/karesansui-2.0.1/tool
# su -s /bin/bash wwwhde -c "KARESANSUI_CONF=/etc/opt/karesansui/application.conf SEARCH_PATH=/opt/karesansui/lib/python:/opt/hde/lib/python:/opt/pysilhouette/lib/python /opt/karesansui/bin/karesansui.fcgi" 

• 末尾にあるコマンドを実行する事でKaresansui内部にある開発用Webサーバー(web.py内蔵)をフォアグランドで実行することができます。
  ※内部サーバーを利用することで、一般的なpdbデバッガの利用等行えるようになります。

開発Webサーバーの実行例¶

[root@localhost tool]# su -s /bin/bash wwwhde -c "KARESANSUI_CONF=/etc/opt/karesansui/application.conf SEARCH_PATH=/opt/karesansui/lib/python:/opt/hde/lib/python:/opt/pysilhouette/lib/python /opt/karesansui/bin/karesansui.fcgi" 
http://0.0.0.0:8080/

開発Webサーバーにアクセスしてみる。¶

ブラウザで、http://localhost:8080/karesansui/v2/ にアクセスしてください。
※開発WebサーバーはSSLをサポートしていません。httpでアクセスしてください。

アクセス出来ない場合¶

* ファイアーウォールが設定されていませんか？
以下をiptableに設定してみてください。

-A INPUT -p tcp -m tcp --dport 8080 -j ACCEPT

* git リポジトリをmasterにしてみましょう。
karesansuiは日々開発が行われていますので、そのままではうまく動作しないことが考えられます。

# git checkout master

最後に¶

以上で開発の準備は終了です。
コマンドをひとつ実行するだけで開発準備が整ったと思います。
あとは、開発用フォルダにあるkaresansui.gitを編集するだけで開発が行えるはずです。

Karesansui Projectから¶

Karesansuiは開発準備にコストをかけることを望んでいません。
我々はあなたにとってシンプルで直感的な開発環境を提供します。

注) だからといってエディタ、IDEを強制するものではありませんのであしからず。