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. 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.

Documentation

CloudStack Technical Documentation -- Installation Guide, Admin Guide, API Developer's Guide, CloudStack Nicira NVP Guide, and Release Notes.

API Reference -- CloudStack API command syntax and description; a companion to the API Developer's Guide

Releases

• CloudStack 4.1 Release
• CloudStack 4.0 Release

Developer Docs and Resources

To get the CloudStack source, use:

git clone https://git-wip-us.apache.org/repos/asf/incubator-cloudstack.git

• 101 - Basics This is the intro page to developing for CloudStack.
• Coding Conventions Coding Styles for CloudStack.
• Contributing as a non-committer This page will explain how to get started on CloudStack development without direct commit access.
• CloudStack Git Repo Web front-end for the CloudStack Git Repo.
• CloudStack Tutorials This section is dedicated to guides on configuring CloudStack within your environment.
• Design This section contains the design specs written for CloudStack
• Troubleshooting Troubleshooting techniques and solutions

Processes

Deployment

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.
• 中文用户可以参加CloudStack的中文用户邮件列表。请寄封电邮给 cloudstack-users-cn-subscribe@incubator.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.