Personal tools
     DOCUMENTATION

Appliance Development:rBuilder Projects

From rPath Wiki

Jump to: navigation, search
Image:Rpath-color-16x16-1bitalpha.png  APPLIANCE DEVELOPMENT

Contents

Appliance developers must configure contexts for the rBuilder projects for which they are building appliances. Prior to configuring contexts, though, developers need to know what labels to use for what purposes on those projects.

If you already have an rBuilder or rBuilder Online project and know what labels you want to use, you can skip this section and move on to configuring contexts on the next page. If you do not have a project or have not identified labels to use, reference the following sections for instructions.

Image:Bulbgraph.png   rPath provides rBuilder Online free for anyone wanting to create and use rBuilder projects. rBO users can use a project repository just for packages, or they can build and release software appliances. Because this is a free public environment, do not use rBO for application software with a license that restricts this type of free distribution.

Create an rBuilder Account

If you are not already registered as a user on rBuilder or rBuilder Online, create an account before proceeding. For rBuilder Online (rBO), click the Set one up link after the "Don't have an account?" question under the login dialog on the right side of the main page. Use the interface to complete the form, and confirm your registration as instructed when rBO sends you a confirmation email.

Create an rBuilder Project

Create a personal project in which to perform training-related appliance development. In rBuilder Online (rBO), log in and click Create a new project in the panel on the right. Create the project as prompted in the form online. Note the Project Name string as it completes the URL shown with the text box; this URL forms the repository hostname part of the labels on your project. (For project example in rBO, the project's repository hostname is example.rpath.org.)

Identify Labels on the Project

Labels were introduced in a previous section of this appliance development guide. Labels on an rBuilder project include the repository hostname for the project (an FQDN that identifies the project specifically within rBuilder). Also, they each include a branch name to identify the development branch in the repository associated with the label.

rBuilder Online projects each have a "default" label given to items unless you specify otherwise when you commit (check in) something to the repository. Click edit project on the project's Project Home page to view and update this default label.

In corporate appliance projects on rBuilder appliances, be sure to follow your company's release management plan when identifying and using labels.


<< PREVIOUS: Set Up a Build Environment NEXT: Contexts >>