How to contribute Apache CloudStack
-
Upload
go-chiba -
Category
Technology
-
view
2.174 -
download
4
description
Transcript of How to contribute Apache CloudStack
Apache CloudStackHow to contribution
- Translating/Building -NetOneSystems Co., Ltd
Go Chiba
Go Chiba– NetOneSystems CloudSoftware Team
(IaaS, Monitoring, Management, SDN etc...)
– Apache CloudStack Japanse TranslatorTranslating ACS docs on privateAnd not publisher of this book…
– Contactmailto: [email protected]: @go_chiba
Introduction
Translating
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
Translating w/ Transifex(https://www.transifex.com)
Displaysections
Sourcedocument
Translateddocument
Recommended document
Transifex
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
Publishing document4. Setting transifex client and pull po files
5. Rename directory(only Japanse)
6. Running publican
Config 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
7. Check doc book# ls tmp/ja-JP/*
Also check sebastien's presentationhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docs
Publishing document
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
Building
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
Preparation3. 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
Building CloudStack1. Checking dependancies
2. Clean and buildeing
3. Deploy sql scheme
4. Running management server
When 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
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 ……
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)
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 FinalizationJune 30 Docs Completion, Release branch moves to
limited updateJuly /1-30 Translation and Integration docs
Final regression testing / bug fixes / doc fixesJuly 22 RC created, VOTE is called
At last...
CloudStack CollaborationConference ‘13