Using products and Product hub

CloudBees platform for 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 support@cloudbees.com.

In software delivery management, a product is any organized work effort that addresses a market need, either internal or external, and delivers an intentional user outcome.

Before you can link data resource with products, your administrator needs to set up integrations. Contact your admin to request any available integrations.

About products

A product is any organized work effort that addresses a market need, either internal or external, and delivers an intentional user outcome. The product provides a way to organize the work involved and the current status of that work.

The number of products you create in CloudBees platform for 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 data sources like repositories for those defined products.

Once you have created a product, you can associate work streams with that product, including GitHub repositories, value streams, and other data sources.

For more information about products, refer to the getting started section of this guide.

About Product hub

The Product hub offers one view of all product development projects across the organization, linking services, components, activities, analytics, teams, and other relevant information needed to manage the software delivery lifecycle.

As you integrate services like GitHub, the Product hub provides a consolidated view of repositories, builds, and pull requests associated with each product. The more services that are integrated, the more complete picture of your software delivery you can create.

Some product hub screens, such as Repositories and Overview, provide status labels or icons color coded according to the status severity:

  • Red indicates an issue that needs immediate attention to deal with something potentially blocking work.

  • Yellow should be investigated soon and could potentially block work.

  • Green notifies you that an action needs to be taken, but nothing is blocked.

Creating a product

To create a product:

  1. Select Product hub.

  2. Select Create product, or Create new product if this is the first product.

  3. Enter a name for the product, and then select Create.

The new product name appears on the Product hub.

Once the product is created, you can use the options menu (three vertical dots) to edit the product name or delete the product.

Viewing products

Once a product is created, it is listed on the Product hub. Selecting the product card displays Product overview, which provides a summary of the latest activities reported by linked services like GitHub.

The Product overview becomes more powerful as more services are integrated.

Editing a product

You can modify a product by changing its name or associated color.

To change the product name:

  1. From the Product hub, select the three vertical dots next to the product name.

  2. Select Edit name.

  3. Modify the product name, and then select Save changes.

The updated product name will appear on the Product hub. === Deleting a product

Deleting a product removes all associated services, repositories, etc. The services are still available within CloudBees platform for SDM and can be associated with other products.

To delete a product:

  1. From the Product hub, select the three vertical dots next to the product name.

  2. Select Delete product.

  3. Check the box to acknowledge that you wish to delete the product, and then select Delete product.

Linking repositories and pull requests from GitHub

You can associate information from GitHub with any product by linking your CloudBees account with a GitHub organization.

To do so, connect to GitHub.

Repository modifications in GitHub, such as creating or deleting a repository, may take several minutes to show up in CloudBees platform for SDM.

Adding repositories to a product

To add GitHub repositories to a product:

  1. Select the product name from the Product hub.

  2. On the left pane, select 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.

Removing a repository from a product

To remove GitHub repositories from a product:

  1. Select the product name from the Product hub.

  2. On the left pane, select Repositories.

  3. Select the repositories you wish to delete by selecting the check box next to the repository name.

  4. Select Unlink selected repositories.

The repository information is no longer associated with the product. The repository data is still available in CloudBees platform for SDM.

Working with pipelines and products

You can link pipelines and jobs to a product by adding one or more Jenkins jobs to a product. Linking the Jenkins jobs to the products surfaces Jenkins pipeline and job information in CloudBees platform for SDM.

Once pipelines and jobs are associated with a product, they are listed on the product’s Jobs screen. This screen lists all pipelines and jobs associated with a product and lets you unlink or add additional ones.

Linking pipelines and jobs with products

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 masters 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 the Product hub, select a product.

  2. Select 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. Select Save changes.

Unlinking pipelines and jobs

Unlinking a pipeline or job from a product disassociates that data from the product. The pipeline and job data remain available in CloudBees platform for SDM.

To unlink one or more pipelines or jobs from a product:

  1. From the Product hub, select the product, and then select Jobs.

  2. Select the check box next to each pipeline that you want to remove.

Copyright © 2010-2020 CloudBees, Inc.Online version published by CloudBees, Inc. under the Creative Commons Attribution-ShareAlike 4.0 license.CloudBees and CloudBees DevOptics are registered trademarks and CloudBees Core, CloudBees Flow, CloudBees Flow Deploy, CloudBees Flow DevOps Insight, CloudBees Flow DevOps Foresight, CloudBees Flow Release, CloudBees Accelerator, CloudBees Accelerator ElectricInsight, CloudBees Accelerator Electric Make, CloudBees CodeShip, CloudBees Jenkins Enterprise, CloudBees Jenkins Platform, CloudBees Jenkins Operations Center, and DEV@cloud are trademarks of CloudBees, Inc. Most CloudBees products are commonly referred to by their short names — Accelerator, Automation Platform, Flow, Deploy, Foresight, Release, Insight, and eMake — throughout various types of CloudBees product-specific documentation. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Jenkins is a registered trademark of the non-profit Software in the Public Interest organization. Used with permission. See here for more info about the Jenkins project. The registered trademark Jenkins® is used pursuant to a sublicense from the Jenkins project and Software in the Public Interest, Inc. Read more at www.cloudbees.com/jenkins/about. Apache, Apache Ant, Apache Maven, Ant and Maven are trademarks of The Apache Software Foundation. Used with permission. No endorsement by The Apache Software Foundation is implied by the use of these marks.Other names may be trademarks of their respective owners. Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks. Where those designations appear in this content, and CloudBees was aware of a trademark claim, the designations have been printed in caps or initial caps. While every precaution has been taken in the preparation of this content, the publisher and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.