Apache CloudStack9章 コントリビューションの手引き

- 翻訳/ビルド編 -ネットワンシステムズ株式会社　千葉 豪

千葉 豪(Go Chiba)– ネットワンシステムズ クラウドソフトウェアチーム

(クラウド基盤、監視・管理、SDN? とか)

– Apache CloudStackの日本語翻訳担当プライベートでドキュメントの翻訳活動中本書の執筆はしてません…

– 連絡先mailto: go.chiba@gmail.comTwitter: @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 開催