How to contribute Apache CloudStack

2,471 views

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(https://www.transifex.com)DisplaysectionsSourcedocumentTranslateddocumentRecommendeddocumentTransifex
  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 clonehttps://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.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# ./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. 8. 7. Check doc book# ls tmp/ja-JP/*Also check sebastienspresentationhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docsPublishing 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 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} >>~/.bashrcPreparation
  12. 12. Preparation3. Start MySQL service4. Clone ClousStack repository(pull it if requred)# service mysqld start# git clone http://git-wip-us.apache.org/repos/asf/cloudstack.git# 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# ./package.sh# 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 Releasehttps://cwiki.apache.org/confluence/display/CLOUDSTACK/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

×