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: go.chiba@gmail.comTwitter: @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