This post is from the CollabNet VersionOne blog and has not been updated since the original publish date.
How to Get Started with CloudForge Development Platform in Pivotal CloudFoundry PaaS
CollabNet’s CloudForge is a collaborative software development platform providing source code management (version control), issue tracking, and agile planning for all personal and professional projects. Full role-based user administration and directory-level access controls allow you to easily manage your development process across distributed teams, both large and small. CloudForge’s inclusion in the CloudFoundry marketplace allows you to quickly set up your projects and teams, leaving more time to focus on developing, building, and testing your applications in a collaborative SDLC framework before deploying them to CloudFoundry.
CloudForge is available in all CloudFoundry marketplaces among the various applications you might want to include in your Application Space. CloudForge does not run within the CloudFoundry PaaS but it is associated with your CloudFoundry Space to help you quickly organize your development team.
When you choose to add the CloudForge development to your CloudFoundry Space (most likely development) the name you choose for your instance will be used to create a new organization name in CloudForge. You can create different CloudForge accounts for different CloudFoundry Applications or Spaces but it isn’t required. You can always deploy your code from a shared CloudForge repository to different Spaces for testing or production. CloudForge is an external application so it does not need to bind to a CloudFoundry application.
In this case, I am creating a new instance called “PivotalDemo” in my development Space and not binding it to a specific application. Your account name in the CloudForge development platform needs to be unique so choose an instance name that has significance for you.
When you have successfully created a new CloudForge instance it will be listed in your Space Services. Click on “Manage” to finish configuring your CloudForge account.
The instance name you chose for CloudForge service will be used for your new CloudForge account. By default, any user clicking on “Manage” within CloudFoundry will be automatically logged into CloudForge via oAuth as the CloudFoundry Space user. However, you will need to choose a username and a password to access your SVN and Git repositories. These SCM services do not support oAuth and are accessed directly from your SCM client, IDE or your command line. Changing your first and last name are optional.
Regardless of how many developers you have it is always useful to maintain version control, even if you are the only developer. Using a Cloud-based source code management provider like the CloudForge development platform means that you always have a full copy of your source code backed up and ready for retrieval from any computer. It also makes it very easy to add collaborators on your projects.
In order to add collaborators simply click on Admin->Manage Users.
You can invite as many collaborators as you like (depending upon your plan) to join your CloudForge account regardless of whether they are users on CloudFoundry. Each user will create a new username on CloudForge so you can track their commits, issue updates, and comments separately as you develop your application.
Now that you have invited others to collaborate on your projects it’s time to create your first project. Click on Projects->New Project.
After you name your project you can add a SVN or Git repository (or both), by far the two most popular SCM tools available today. If you want to include Bug/Issue Tracking, Agile Planning, Wiki, or Discussions you can also choose to add TeamForge to your project. All of these services will be provisioned within your project and the direct links for each provided on your project landing page.
Once you have coded your application and merged all of your branches into a stable trunk you can easily deploy your application to CloudFoundry using the CF command utility or directly from the SpringSource tool. You are able to deploy to any CloudFoundry target, Space, or Org; your CloudForge project is not bound to a specific instance of CloudFoundry.
Feel free to create as many Projects in CloudForge development platform as you need. Your account can be used to manage multiple applications and projects across several Spaces within CloudFoundry. The CloudForge development platform will accelerate the development of your applications to the Cloud Foundry-based platform, whether it is hosted in a private or public cloud so you can deliver great products to market fast.
If you using the SpringSource IDE, I highly recommend installing the CollabNet Desktop as well. This allows you to manage your CloudForge account, including all repositories and all tasks, from within the same environment that manages your code.