This repository contains legacy services components which are not under active development. We can cannot vouch for their functionality. Feel free to try them as-is and enhance them as needed.
This repository is structures for use with BOSH, an open source tool for release engineering, deployment and lifecycle management of large scale distributed services. The directories are:
- .final_builds
- config: pointers to dependencies cached in the BOSH blobstore.
- git
- jobs: start and stop commands for each of the jobs (processes) running on Cloud Foundry nodes.
- packages: packaging instructions used by BOSH to build each of the dependencies.
- releases: yml files containing the git commit shas for each package in a given release.
- src: the source code for the components in Cloud Foundry. Note that each of the components is a submodule with a pointer to a specific sha. So even if you do not use BOSH to deploy Cloud Foundry, the list of submodule pointers
See the documentation for deploying Cloud Foundry for more information about using BOSH.
In order to deploy Cloud Foundry with BOSH, you will need to create a manifest. You can find a sample manifest in the documentation.
The source code for these services can be found at http://github.com/cloudfoundry/cf-services-contrib/
The Cloud Foundry team uses GitHub and accepts contributions via pull request
Follow these steps to make a contribution to any of our open source repositories:
-
Complete our CLA Agreement for individuals or corporations
-
Set your name and email
git config --global user.name "Firstname Lastname" git config --global user.email "[email protected]"
-
Fork the repo
-
Make your changes on a topic branch, commit, and push to github and open a pull request.
Your pull request is much more likely to be accepted if:
-
It is small and focused with a clear commit message that conveys the intent behind your change.
-
The tests pass in CI (we use Travis CI for many of our components in large part because of their excellent support for pull requests).
-
Your pull request includes tests.
We review pull requests regularly.
Our documentation, currently a work in progress, is available here: http://docs.cloudfoundry.com/
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
Bugs can be filed using Github Issues within the various repositories of the Cloud Foundry components.