How to contribute Apache CloudStack
0 likes2,659 views
This document provides instructions for contributing to Apache CloudStack by translating documentation or building packages. It outlines the translation process using Transifex, how to build and package CloudStack using Maven, and future release schedules including a documentation sprint for Japanese translations in June/July.
How to contribute Apache CloudStack
- 1. Apache CloudStack How to contribution - Translating/Building - NetOneSystems Co., Ltd Go Chiba
- 2. Go Chiba – NetOneSystems CloudSoftware Team (IaaS, Monitoring, Management, SDN etc...) – Apache CloudStack Japanse Translator Translating ACS docs on private And not publisher of this book… – Contact mailto: go.chiba@gmail.com Twitter: @go_chiba Introduction
- 3. Translating
- 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. Translating w/ Transifex(https://www.transifex.com) Display sections Source document Translated document Recommen ded document Transifex
- 6. Check your translating with Publican (Confirmed on CentOS 6.3) 1. Install requred tools 2. Clone source code from repository 3. Install common contents(e.g. images) # 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 Publishing document
- 7. Publishing document 4. Setting transifex client and pull po files 5. Rename directory(only Japanse) 6. Running publican Config files: all, adminguide, devguide, installation, niciranvp, release-note Format : 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. Check doc book # ls tmp/ja-JP/* Also check sebastien's presentation http:// www.slideshare.net/seba stiengoasguen/how-to-tr anslate-apache-cloudsta ck-docs Publishing document
- 9. You can report document bugs on JIRA like a code bugs We wellcome your reviewing even if it's typos :) – Wrong port number、Miss spells etc… Document bugs
- 10. Building
- 11. 1. Install related packages 2. 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} >> ~/.bashrc Preparation
- 12. Preparation 3. Start MySQL service 4. 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. Building CloudStack 1. Checking dependancies 2. Clean and buildeing 3. Deploy sql scheme 4. Running management server When you modify codes, building again and check behavior 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. Packaging(rpm) 1. Insall rpm-build 2. Checking dependancies 3. Running packaging script 4. 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. 1. Install dpkg-dev and maven 2. Checking dependancies 3. Generate deb packages Recommend to install maven from apt on debian/unbungu # apt-get install dpkg-dev maven # mvn –P deps # cd package/debian # dpkg-buildpackage Packaging(deb)
- 16. Future scedules Road to CloudStack 4.2 Release https://cwiki.apache.org/confluence/display/CLOUDSTACK/Cloudstack+4.2+Release Japanse User group planning doc sprint on June/July – Target Interesting but well known about translating... :( I'd like to contributing but not good code writer... :( May 31 Merge new feature to master, Release branch will be cut June 1 Test/Bugfix, Doc Finalization June 30 Docs Completion, Release branch moves to limited update July /1-30 Translation and Integration docs Final regression testing / bug fixes / doc fixes July 22 RC created, VOTE is called
- 17. At last...