Get Involved and Contribute
Cloud Foundry is an open source project. Join our open ecosystem of cloud frameworks and services, add features, comment on design docs, report or fix a bug, contribute documentation or technical articles. We welcome your contribution.
The Cloud Foundry open source project is comprised of a number of different repositories. All of them can be found at https://github.com/cloudfoundry, but here's a brief overview of the main projects to help you get started:
Cloud Controller (CCNG) is the primary entry point for Cloud Foundry.
GoRouter is the central router that manages traffic to applications deployed on Cloud Foundry.
Droplet Execution Agent (DEA) stages and hosts applications.
Health Manager monitors the state of the applications.
Cloud Foundry CLI is the official command line client for Cloud Foundry.
Cloud Foundry Login Server handles authentication.
Cloud Foundry UAA is the identity management service for Cloud Foundry.
Loggregator is the user application logging subsystem for Cloud Foundry.
BOSH is used for release engineering, deployment and lifecycle management.
To learn more about Cloud Foundry, visit one or more of the following resources:
- The Cloud Foundry Blog: http://blog.cloudfoundry.com
- The Wiki: https://github.com/cloudfoundry-community/cf-docs-contrib/wiki
- Cloud Foundry Open Source Documentation: http://docs.cloudfoundry.org
- The Cloud Foundry YouTube Channel: http://www.youtube.com/cloudfoundry
Meetups and Events
Come meet other CF newbies and pros at a Cloud Foundry meetup or event.
- Silicon Valley
- San Diego, CA
- Palo Alto, CA
- Los Angeles, CA
- Bay Area Bosh
- Boston, MA
- New York City, NY
- Seattle, WA
- Minneapolis-St. Paul, MN
- Toronto, Canada
- Denver/Boulder, CO
- Austin, TX
- Washington, DC
- Portland, OR
- St Louis, MO
- Beijing, China
- Raleigh, NC
- Pivotal Open Source Hub
In 2013, we had our first Cloud Foundry User Conference. Visit the conference site to view session recordings and slides.
Questions about the Cloud Foundry Open Source Project can be directed to our Google Groups:
- BOSH Developers: https://groups.google.com/a/cloudfoundry.org/group/bosh-dev/topics
- BOSH Users: https://groups.google.com/a/cloudfoundry.org/group/bosh-users/topics
- VCAP (Cloud Foundry) Developers: https://groups.google.com/a/cloudfoundry.org/group/vcap-dev/topics
File a Bug
Bugs can be filed using Github Issues within the various repositories listed above. Check the project's README for any specific instructions.
Please review our Public Trackers first to see what's already in the queue to be fixed.
Contribute to the Wiki
See something on the wiki that's missing or could use some clarification? Go ahead and update it. All you need are your GitHub credentials.
Below are the general steps to make a code contribution. For each project, please review the repository's README to see if there are any other specific instructions.
Set your name and email (these should match the information on your submitted CLA):
git config --global user.name "Firstname Lastname" git config --global user.email "firstname.lastname@example.org"
Fork the project's repository
Create a feature branch (e.g.
git checkout -b better_bosh) and make changes on your branch
Push to your fork (e.g.
git push origin better_bosh) and submit a pull request
If you have a CLA on file, your contribution will be analyzed for engineering quality and product fit prior to merging.
Note: All contributions need to be sent using GitHub Pull Requests, and we favor pull requests with very small, single commits with a single purpose. Your pull request is much more likely to be accepted if it includes tests and is small and focused with a clear message that conveys the intent of your change.