THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Page History
Apache CloudStack Wiki:
...
Info on developing and contributing to Apache CloudStack
This is the home of the Apache Cloudstack (incubating) space. Feel free to edit this page.
TODO: Fix link urls/migrated from wiki.cloudstack.org
| Table of Contents |
|---|
IRC
http://www.cloudstack.org/irc.html
CloudStack community managers: David Nalley (ke4qqq), Mark Hinkle (mrhinkle)
- #cloudstack - Channel for general discussion about cloudstack
- #cloudstack-dev - Channel for committers, developers and contributors. More involved discussion.
- #cloudstack-meeting - Weekly meeting channel. IRC meeting times and minutes announced on the mailing lists
Clients: Freenode Webchat, screen+irssi, XChat, Adium
Weekly development meetings happen in #cloudstack-meeting, logs and minutes are available here
Mailing Lists
http://www.cloudstack.org/mailing-lists.html
To subscribe, send an empty email to the list with '-subscribe' before @incubator.apache.org
- Development: cloudstack-dev@inbubator.apache.org
- (Archives here)
- Users: cloudstack-users@incubator.apache.org
- (Archives here)
- Commits: cloudstack-commits@incubator.apache.org
- (Archives here)
Discuss
Note: These forums will slowly be deprecated. Please bring all discussion to the cloudstack-users/cloudstack-dev mailng lists
Development
Getting Started
Videos
Videos by Xen.org Community Manager
Releases
Apache CloudStack Future Release
Wiki
http://wiki.cloudstack.org (old)
Community Development
Documentation Team - doc plans, how to file a doc bug, how to contribute to docs
Git: Working with CloudStack code
Git Good Practices for commiters and contributors
Patch submission: Review Board (if your review gets shipped, remember to close the review)
The link below gives a good overview of git jargon and its usage.
Distributed Development suggestion: http://nvie.com/posts/a-successful-git-branching-model/
CloudStack's Future Architecture
Design Documentation
Development
Setting up CloudStack Development Environment
DevCloud: Standalone development environment
CloudStack Packages and Dependencies
Setup CloudStack development environment in 8 steps
Building
Get dependencies: Java, Maven 3.0+, Ant, Tomcat (use 6.0.33, problems with latest version), MySQL, gcc, python, git
Grab the source code:
| Code Block |
|---|
$ git clone https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git
$ git pull -v # Have your master updated
|
To build CloudStack, checkout: Building with Maven
| Code Block |
|---|
$ mvn -P deps
$ ant clean-all build-all
$ ant deploy-server
$ ant deploydb
$ ant debug
|
To access your CloudStack Management Server, open in your browser: (localhost or IP/domain-name of your management server)
http://localhost:8080/client/
Testing
Marvin - Python CloudStack API testclient
How to write JUnit tests?
ASF CS 4.0 Release - Test Plan for 4.0 release
Troubleshooting
SSVM troubleshooting / template download issues.
Supported Hypervisors
Xen (various versions)
KVM
Bare-metal
Oracle VM (OVM)
If you see something wrong, edit it. If you have new information, please add it. Or to put it another way: edit boldly. It's a wiki - any changes can be reverted if necessary.
Mailing Lists
We do most of our discussion and work on the Apache CloudStack mailing lists. Specifically, developer discussions happen on the cloudstack-dev mailing list. If you're looking for user support, the cloudstack-users list is the best place to go. (You may be tempted to send mails to both lists looking for help. Avoid that temptation. It's much better etiquette to direct emails to one list only, and to use the appropriate lists.)
Please note that all of the lists are high-volume.
- To join the cloudstack-dev mailing list send an email to cloudstack-dev-subscribe@incubator.apache.org. The archives can be found on mail-archives.apache.org.
- To join the cloudstack-users mailing list send an email to cloudstack-users-subscribe@incubator.apache.org. The archives can be found on mail-archives.apache.org.
- To join the cloudstack-commits mailing list send an email to cloudstack-commits-subscribe@incubator.apache.org. The archives can be found on mail-archives.apache.org.
IRC
We maintain several community IRC channels for real-time discussion and support, but please note that if it didn't happen on the mailing list, it didn't happen. Decisions are made on the mailing list (cloudstack-dev). But if you're looking for real-time answers to development or user questions, IRC is a great way to find help. All channels are on Freenode.
- #cloudstack: This channel is for general cloudstack discussion and support.
- #cloudstack-dev: This channel is for developer discussions and support. This channel also receives notices of commits, build failures, etc.
- #cloudstack-meeting: Meetings are held here.
...
Overview
Content Tools
Apps