Getting started

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.

CloudBees SDM requires some initial setup before users can access it. As a CloudBees SDM administrator, you will first need to:

  • Verify your account credentials provided by CloudBees.

  • Configure integrations for services like GitHub.

Accessing CloudBees SDM

When you joined the Preview program, your existing or new CloudBees account has a new subscription for CloudBees SDM. If an account was created for you as part of your Preview program on-boarding, you should receive initial administrative credentials for your CloudBees account and subscription management.

To access your CloudBees organization and user management:

  1. Go to app.cloudbees.com and sign in.

  2. From the upper right organization drop-down, select Manage organizations to update or modify an organization or Manage users to add or remove users associated with an organization.

  3. When redirected to CloudBees Network Portal, you may be prompted to log in again.

If you have any problems, contact CloudBees Support at support.cloudbees.com or your preview program coordinator at CloudBees.

You will need to add users for members of your team who will use CloudBees SDM. Refer to Managing accounts for instructions on adding users and modifying an organization.

Forgotten password

If you forget your password, you can reset your password using this page: https://grandcentral.cloudbees.com/forgot-password

Setting up integrations

Integrating external services like GitHub lets CloudBees SDM access data from these services. This data lets you monitor and manage the delivery of your products and features.

Integrating GitHub with CloudBees SDM lets you add GitHub repositories to products so you can display branches, pull requests, commits, and branch status.

Integrating GitHub

CloudBees SDM integrates with GitHub using the CloudBees SDM app, which connects a GitHub organization to your CloudBees SDM account.

You need administrative rights on your GitHub organization to install the CloudBees SDM app. For additional information, refer to the GitHub documentation on permissions levels for organizations.

You can associate a GitHub organization with only a single CloudBees SDM account currently.

To connect GitHub, you must install the CloudBees SDM app on GitHub. After you have connected GitHub to CloudBees SDM, you can see your GitHub repository data in CloudBees SDM. Then, you can link repositories and data to products to help you to prioritize work and locate blockers.

You must have administrative privileges in CloudBees to connect GitHub to CloudBees SDM.

To connect GitHub to CloudBees SDM:

  1. In the top right of any screen, select the organization name.

  2. Select Manage integrations.

  3. Select Add integration.

  4. On the Add integration screen, select GitHub, and then select Add.

  5. On the Add GitHub integration screen, verify that you want to install and configure the CloudBees SDM app, and then click Add.

  6. On the CloudBees SDM app screen, select Configure.

  7. Select the GitHub organization you want to associate with your CloudBees SDM account. If you only have one account, that account is associated automatically. You may be prompted for your GitHub password.

  8. Select one of the following options:

    • To make all repositories in the organization available in CloudBees SDM, select All repositories. All future updates will automatically be imported into CloudBees SDM.

    • To allow CloudBees SDM to access only specific repositories, select Only select repositories, and then select the repositories you want to add. Any time a new repository is added, you must update the list of approved repositories to import the updates into CloudBees SDM.

  9. Select Install and Authorize.

Integrating Jenkins

Adding support for Jenkins integration is explained in the Jenkins integration section.

To remove an integration, refer to the GitHub integrations section.

Integrating Jenkins

Refer to Jenkins integration for instructions.

Policy engine and policies

The Getting started with policies section explains how to create your first policy.