rBuilder:Create a Project

From rPath Wiki

As a registered user in rBuilder, you may choose to create your own rBuilder projects.

To create a new project in rBuilder, click the Create a new project link in your project panel. Complete the form on the Create a Project page as follows.

1. Type the project name and project title in the required fields of the Create a Project page.
2. Change the project domain name if necessary. Further information is contained in a later section on this page: choosing a project domain name.
3. Type or paste a description of your project in the Project Description text box to aid other users who are browsing projects.
4. If desired, use the options provided to link to an external website for the project.
5. Click Create.

Creating a project is irreversible! The project URL, created from the original project name, cannot be changed after you click Create, so be sure you are satisfied with the syntax of the project name before you click. Other details of the project can be modified later using the Edit link beside the project name on the project's main page.

The creator of the project is immediately listed as a project owner on the project's Members page. As owner of your project, you will be able to add other users to the project as owners or developers.

Branch Name Selection

The Default Branch Name is set to an rBuilder default. Use the Edit link beside the project name on the project's main page to modify this value to fit with your planned release management structure.

Choosing a Project Domain Name

You do not need to change the project domain name from its default in rBuilder Appliance if the following is true:

• The software stored in the project's repository is destined to be used exclusively within your organization
• All the systems within your organization will access this project's repository to install and update this locally used software using the fully qualified domain name corresponding to the project name and default domain name

Please be aware that a project name (repository name) must differ from the rBuilder hostname. See this TECHTIP for more information.

For other cases, you will need to change the domain name field. The exact domain name required depends on the details of your organization. Some common examples include:

• The project repository is accessible using project.devel.example.com, but appliances updating from the repository are part of production.example.com and cannot resolve or access project.devel.example.com. In this case, use production.example.com.
• The project repository is accessible using project.devel.example.com, but the appliances updating from the repository are external to example.com and cannot resolve or access project.devel.example.com. In this case, consider using an Update Service appliance on example.com as a tool to which rBuilder can mirror internally-managed repositories for externally-accessible updates.

The following issues must be address when changing the default domain name:

• Development systems must have the appropriate settings in /etc/conaryrc. This could be in the form of repositoryMap entries or a including a centralized repositoryMap registry with includeConfigFile. NOTE: The includeConfigFile option is not recommended for deployed appliances as means of maintaining repository map information.
• If the appliances updating software from the project do not have connectivity to the project's repository, its contents should be mirrored to a separate externally-accessible repository (such as when using an Update Service appliance).