Apache CloudStackへのコントリビューション方法(翻訳/ビルド)について

1. Apache CloudStack
9章 コントリビューションの手引き
- 翻訳/ビルド編 -
ネットワンシステムズ株式会社 千葉 豪

2.  千葉 豪(Go Chiba)
– ネットワンシステムズ クラウドソフトウェアチーム
(クラウド基盤、監視・管理、SDN? とか)
– Apache CloudStackの日本語翻訳担当
プライベートでドキュメントの翻訳活動中
本書の執筆はしてません…
– 連絡先
mailto: go.chiba@gmail.com
Twitter: @go_chiba
自己紹介

3. 翻訳編

4.  現在以下のプロジェクトが進行中
– 公式ドキュメントの日本語化(Apache CloudStack Docs)
– GUIの日本語化(Apache CloudStack UI)
– Runbook(クイックインストールガイド)の日本語化
(Apache CloudStack Runbook)
翻訳対象

5.  Transifex(https://www.transifex.com)による翻訳
各セクション
の表示
オリジナルの
ドキュメント
翻訳された
ドキュメント
翻訳内容の
レコメンド
翻訳作業

6.  Publicanで自分が翻訳した内容を確認(CentOS 6.3上で確認)
1. 必要なツール群をインストール
2. CloudStackをリポジトリからclone
3. 共通のコンテンツ(画像など)をインストール
# yum install git rpm-build python-setuptools publican
# easy_install transifex-client
# git clone
https://git-wip-us.apache.org/repos/asf/cloudstack.git
# cd cloudstack/docs/publican-cloudstack
# ./gen_rpm.sh
# rpm –i ~/rpmbuild/RPMS/noarch/publican-cloudstack-0.6-
1.el6.noarch.rpm
実際に出来たものを確認

7. 実際に出来たものを確認
4. transifex の設定とpoファイルのpull
5. ディレクトリ名をja-JPに修正
6. publicanを実行
設定ファイル: all, adminguide, devguide, installation, niciranvp,
release-note
フォーマット: html, html-single, pdf, epub
# cd cloudstack/docs
# tx init
# ./settx.sh
# tx pull –l ja_JP
# mv ja_JP ja-JP
# publican build --config=publican-all.cfg
--formats=html,pdf --langs=ja-JP

8. 7. 生成物の確認
# ls tmp/ja-JP/*
PMCであるSebastienの資
料もチェック
http://
www.slideshare.net/seba
stiengoasguen/how-to-tr
anslate-apache-cloudsta
ck-docs
実際に出来たものを確認

9.  コードと同様にJIRAに報告
 Typoレベルでもウェルカムです
– Port番号の間違い、スペルミス etc…
ドキュメントバグ

10. ビルド編

11. 事前準備
3. MySQLを起動
4. コードをclone(必要に応じてpullで最新にアップデート)
# service mysqld start
# git clone http://git-wip-
us.apache.org/repos/asf/cloudstack.git
# git pull origin master

12. 1. 関連するツールのインストール
2. Mavenのセットアップ
# yum install git java-1.6.0-openjdk java-1.6.0-openjdk-
devel mysql mysql-server tomcat6 mkisofs gcc python MySQL-
python python-setuptools
# wget http://www.us.apache.org/dist/maven/maven-
3/3.0.5/binaries/apache-maven-3.0.5-bin.tar.gz
# cd /usr/local/
# tar -zxvf apache-maven-3.0.5-bin.tar.gz
# echo export M2_HOME=/usr/local/apache-maven-3.0.5 >>
~/.bashrc # echo export PATH=${M2_HOME}/bin:${PATH} >>
~/.bashrc
事前準備

13. 実際にビルド
1. mavenで依存するパッケージのチェック
2. cleanとbuildを実施
3. 必要に応じDBのスキーマをデプロイ
4. 管理サーバーを実行
コードを修正した後は2,4を繰り返し動作を確認
# mvn clean install -P systemvm,developer
# mvn -P developer -pl developer -Ddeploydb
# mvn -pl :cloud-client-ui jetty:run
# mvn –P deps

14. パッケージ化(rpm)
1. rpm-buildのインストール
2. mavenで依存パッケージのチェック
3. rpm作成スクリプトを実施
4. rpmを確認
# yum install rpm-build
# mvn –P deps
# cd package/centos63
# ./package.sh
# ls dist/rpmbuild/RPMS/x86_64/
cloudstack-agent-4.1.0-SNAPSHOT.el6.x86_64.rpm ……

15. 1. dpkg-devとmavenをインストール
2. mavenで依存パッケージのチェック
3. debパッケージを生成
debian/ubuntu環境ではパッケージからmavenのインストールを推奨
# apt-get install dpkg-dev maven
# mvn –P deps
# cd package/debian
# dpkg-buildpackage
パッケージ化(deb)

16. 今後のスケジュール
 4.2リリースまでの道のり
https://cwiki.apache.org/confluence/display/CLOUDSTACK/Cloudstack+4.2+Release
 6月/7月でDoc Sprintを計画中!!
– 興味があるけどよくわからない…
– コントリビュートしたいけどコーディングは…
5/31 新機能のマスターへのマージ, 4.2用ブランチ作成
6/1 テスト/バグフィックス, オリジナルドキュメント完成
6/30 ドキュメントの修正, ブランチへのコミットを制限
7/1-30 翻訳作業と統合開始
テスト/バグフィックス/ドキュメント修正
7/22 RC版作成, 投票開始

17. 最後に

18. CloudStack Collaboration
Conference ‘13 開催