Build repository

3 minute read

The build repository is the tool that stores the build binary. CloudBees Release Orchestration SaaS supports JFrog and Amazon Elastic Container (AWS ECR) repositories.

Configuring an AWS ECR repository

You can add AWS ECR as a build repository to CloudBees Release Orchestration SaaS.

To configure an AWS ECR build repository:

  1. From the CloudBees Release Orchestration SaaS Home page, select Admin  Settings.

  2. Select Build Repository on the left pane.

  3. Select Add new to display a blank form. If there are no current configurations, the blank form is displayed by default.

  4. Select the AWS ECR Tool Type from the options.

    AWS ECR
    Figure 1. AWS ECR configuration
  5. Enter a Tool name.

  6. Select the AWS ECR Tool Type from the options.

  7. Enter the Tool URL.

  8. Select a Region from the options.

  9. Add the following policy to both your Access key and Secret key files:

    AWS ECR Access key and Secret key policy
    { } "Effect": "Allow", "Action":[ "ecr:DescribelmageScanFindings", "ecr:StartImageScan", "ecr:CreateRepository", "ecr:GetDownloadUrlForLayer", "ecr:DescribeRegistry", "ecr:PutImageScanning Configuration", "ecr:GetAuthorizationToken", "ecr:UploadLayerPart", "ecr:BatchDeletelmage", "ecr:PutImage", "ecr:BatchGetImage", "ecr:CompleteLayerUpload", "ecr:Describelmages", "ecr:TagResource", "ecr:DescribeRepositories", "ecr:InitiateLayerUpload", "ecr:BatchCheckLayerAvailability" ], "Resource":"*" }
  10. Enter your Access key.

  11. Enter your Secret key.

  12. Select Save.

Your AWS ECR build repository tool configuration is saved and listed on the right pane.

Configuring a JFrog Artifactory repository

You can add JFrog Artifactory as a build repository to CloudBees Release Orchestration SaaS.

To configure a JFrog Artifactory build repository:

  1. From the CloudBees Release Orchestration SaaS Home page, select Admin  Settings.

  2. Select Build repository on the left pane.

  3. Select Add new to display a blank form. If there are no current configurations, the blank form is displayed by default.

    Add new
    Figure 2. Tool configuration Add new highlighted
  4. Enter a Tool name.

  5. Select the JFrog Artifactory Tool type from the options.

  6. Enter the Tool URL.

  7. Enter your User name.

  8. Enter your Access token.

    The JFrog Access token must have:

    • A Never Expires configuration

    • Access to Xray and Artifactory services

    JFrog
    Figure 3. JFrog access token configuration
  9. Select Save.

Your JFrog Artifactory build repository tool configuration is saved and listed on the right pane.

Configuring JFrog webhooks

Using a JFrog webhook, CloudBees Release Orchestration SaaS can integrate with automated notifications, thus enabling pipelines to work seamlessly. You can add any number of JFrog webhooks.

To configure JFrog webhooks:

  1. From the CloudBees Release Orchestration SaaS Home page, select Admin  Settings.

  2. Select Build repository on the left pane.

  3. Select a JFrog Artifactory tool configuration from the right pane.

  4. Enter a Repo config name.

  5. Select the Webhook Repo config type.

  6. Select Event types from the options.

    Event type
    Figure 4. Selecting the Build was uploaded event type.
    • For Artifact or Docker Event types, enter the Repo Name and an optional Artifact location.

    • For Build Event types, enter the Build Name.

      • To uncheck an event type, select the event type again.

      • Once an event type is selected, only related event types remain available for selection.

      • To add or remove a webhook configuration, select Plus or Minus, respectively.

Your webhook configuration in the JFrog build repository is saved and listed on the right pane.

Webhook
Figure 5. A configured webhook
Select Reset to clear your selection at any time.

Updating a configuration

You can update the build repository configuration.

To update your build repository configuration:

  1. From the CloudBees Release Orchestration SaaS Home page, select Admin  Settings.

  2. Select Build repository on the left pane.

  3. Select a configuration on the right pane.

  4. Make any updates.

  5. Select Update.

Your build repository configuration is updated.

Deleting a configuration

To delete your build repository configuration:

  1. From the CloudBees Release Orchestration SaaS Home page, select Admin  Settings.

  2. Select Build repository on the left pane.

  3. Select a configuration on the right pane.

  4. Select Trash can Delete.

  5. Select DELETE.

Your build repository configuration is deleted.