Upload
go-chiba
View
1.385
Download
1
Embed Size (px)
DESCRIPTION
Apache CloudStackへのコントリビューション方法(翻訳/ビルド)について
Citation preview
Apache CloudStack9章 コントリビューションの手引き
- 翻訳/ビルド編 -ネットワンシステムズ株式会社 千葉 豪
千葉 豪(Go Chiba)– ネットワンシステムズ クラウドソフトウェアチーム
(クラウド基盤、監視・管理、SDN? とか)
– Apache CloudStackの日本語翻訳担当プライベートでドキュメントの翻訳活動中本書の執筆はしてません…
– 連絡先mailto: [email protected]: @go_chiba
自己紹介
翻訳編
現在以下のプロジェクトが進行中– 公式ドキュメントの日本語化(Apache CloudStack Docs)– GUIの日本語化(Apache CloudStack UI)– Runbook(クイックインストールガイド)の日本語化
(Apache CloudStack Runbook)
翻訳対象
Transifex(https://www.transifex.com)による翻訳
各セクションの表示
オリジナルのドキュメント
翻訳されたドキュメント
翻訳内容のレコメンド
翻訳作業
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
実際に出来たものを確認
実際に出来たものを確認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
7. 生成物の確認# ls tmp/ja-JP/*
PMCであるSebastienの資料もチェックhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docs
実際に出来たものを確認
コードと同様にJIRAに報告 Typoレベルでもウェルカムです
– Port番号の間違い、スペルミス etc…
ドキュメントバグ
ビルド編
事前準備3. MySQLを起動
4. コードをclone(必要に応じてpullで最新にアップデート)
# service mysqld start
# git clone http://git-wip-us.apache.org/repos/asf/cloudstack.git# git pull origin master
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
事前準備
実際にビルド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
パッケージ化(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 ……
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)
今後のスケジュール 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版作成, 投票開始
最後に
CloudStack CollaborationConference ‘13 開催