How to contribute Apache CloudStack


Published on

Described how to translating/publishing CloudStack docs and how to build from codes.

Published in: Technology
  • Be the first to comment

  • Be the first to like this

How to contribute Apache CloudStack

  1. 1. Apache CloudStackHow to contribution- Translating/Building -NetOneSystems Co., LtdGo Chiba
  2. 2.  Go Chiba– NetOneSystems CloudSoftware Team(IaaS, Monitoring, Management, SDN etc...)– Apache CloudStack Japanse TranslatorTranslating ACS docs on privateAnd not publisher of this book…– Contactmailto: go.chiba@gmail.comTwitter: @go_chibaIntroduction
  3. 3. Translating
  4. 4.  Apache CloudStack have below projects for translating– Document tranlating(Apache CloudStack Docs)– GUI translating(Apache CloudStack UI)– Runbook(Quick Install Guide) translating(Apache CloudStack Runbook)Target
  5. 5.  Translating w/ Transifex(
  6. 6.  Check your translating with Publican(Confirmed on CentOS 6.3)1. Install requred tools2. Clone source code from repository3. Install common contents(e.g. images)# yum install git rpm-build python-setuptools publican# easy_install transifex-client# git clone cd cloudstack/docs/publican-cloudstack# ./ rpm –i ~/rpmbuild/RPMS/noarch/publican-cloudstack-0.6-1.el6.noarch.rpmPublishing document
  7. 7. Publishing document4. Setting transifex client and pull po files5. Rename directory(only Japanse)6. Running publicanConfig files: all, adminguide, devguide, installation, niciranvp,release-noteFormat : html, html-single, pdf, epub# cd cloudstack/docs# tx init# ./ tx pull –l ja_JP# mv ja_JP ja-JP# publican build --config=publican-all.cfg--formats=html,pdf --langs=ja-JP
  8. 8. 7. Check doc book# ls tmp/ja-JP/*Also check sebastienspresentation document
  9. 9.  You can report document bugs on JIRA like a code bugs We wellcome your reviewing even if its typos :)– Wrong port number、Miss spells etc…Document bugs
  10. 10. Building
  11. 11. 1. Install related packages2. Install maven binaries and configure# 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 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} >>~/.bashrcPreparation
  12. 12. Preparation3. Start MySQL service4. Clone ClousStack repository(pull it if requred)# service mysqld start# git clone git pull origin master
  13. 13. Building CloudStack1. Checking dependancies2. Clean and buildeing3. Deploy sql scheme4. Running management serverWhen you modify codes, building again and checkbehavior after running management server# mvn clean install -P systemvm,developer# mvn -P developer -pl developer -Ddeploydb# mvn -pl :cloud-client-ui jetty:run# mvn –P deps
  14. 14. Packaging(rpm)1. Insall rpm-build2. Checking dependancies3. Running packaging script4. Confirm generated rpms# yum install rpm-build# mvn –P deps# cd package/centos63# ./ ls dist/rpmbuild/RPMS/x86_64/cloudstack-agent-4.1.0-SNAPSHOT.el6.x86_64.rpm ……
  15. 15. 1. Install dpkg-dev and maven2. Checking dependancies3. Generate deb packagesRecommend to install maven from apt on debian/unbungu# apt-get install dpkg-dev maven# mvn –P deps# cd package/debian# dpkg-buildpackagePackaging(deb)
  16. 16. Future scedules Road to CloudStack 4.2 Release Japanse User group planning doc sprint on June/July– TargetInteresting but well known about translating... :(Id like to contributing but not good code writer... :(May 31 Merge new feature to master, Release branchwill be cutJune 1 Test/Bugfix, Doc FinalizationJune 30 Docs Completion, Release branch moves tolimited updateJuly /1-30 Translation and Integration docsFinal regression testing / bug fixes / doc fixesJuly 22 RC created, VOTE is called
  17. 17. At last...
  18. 18. CloudStack CollaborationConference ‘13