Using products to model work

On this page
CloudBees SDM is a preview, with early access for select preview members. Product features and documentation are frequently updated. If you find an issue or have a suggestion, please contact CloudBees Support. Learn more about the preview program.

Products help you conceptualize offerings into segments that represent work to be completed. The products correspond to your team’s or company’s work. For example, a single product could model a software deliverable, an open-source offering, APIs, versioned software, documentation, or graphic designs.

The number of products you create in CloudBees SDM should mirror the organization of work that needs to be tracked. Let’s say that your team works on three offerings: Solution One, Solution Two, and Solution Three. You would create a product for each solution and then associate repositories for those defined products.

The more services like GitHub and Jira are integrated, the more data is available to associate with products.

For more information about products, refer to Modeling work with Products.

Creating a product

The first time you sign in to CloudBees SDM and select Engineering Efficiency, you are prompted to create your first product.

To create your first product:

  1. Select Configure your first product.

  2. Enter a name for your product and select Create.

Linking Jira projects with a product

Once you have created your first product, you need to associate data from your issue tracker, such as Jira Cloud.

If an issue tracker has not been configured, someone with administrator privileges for CloudBees SDM needs to install the Jira Cloud app.

Data import from an issue tracker can take several hours.

To associate issue tracker data with a product:

  1. Select the product name.

  2. Select Manage  Manage issues.

  3. Select Link projects.

  4. Select the check boxes for the projects you wish to associate with the product. You can search projects using the keyword search.

  5. Select Link ticket projects.

The product page may take a while for the pages to update.

Linking GitHub repositories with a product

To add GitHub repositories to a product:

  1. Select the product name from Products.

  2. On the left pane, select Manage repositories.

  3. Select Link repository or, if this is the first time you are adding repositories, select Link your first repository, to display a list of available repositories.

  4. Choose the repositories to associate with the product. You can filter the repositories list by entering a complete or partial repository name in the text box or by selecting a GitHub organization from the Organization drop-down.

  5. Select Save changes.

Linking pipelines and jobs with a product

Linking Jenkins jobs and pipelines allows you to add build and job information to products. Selecting a Jenkins job links the job and any pipelines with the chosen product. Jenkins controllers need to be connected before you can link jobs and pipelines to products.

Each job can be linked to one or more products.

To link pipelines:

  1. From Products, select a product.

  2. Select Manage jobs.

    • If this is the first time you are linking a pipeline, select Link your first job.

    • Otherwise, select Link jobs.

  3. Select one or more check boxes to associate those jobs with the product.

  4. Select Save change.