Add/Edit Builds

Introduction

You can add Builds in Plutora manually or via automated jobs. This article provides a brief overview of steps to add a Build using both methods. 

You can create Builds via Systems as well. See, Manage Builds in System.

Pre-requisite

  • Ensure Enable Builds is checked in Build Setup to be able to view ‘Build’ in the menu.
  • You must have ‘Create Builds’ and ‘Edit Builds’ user permissions.
  • To create and delete public filters in the Build grid’s Query Builder, you must have ‘Create/Delete Build Public Query Builder’ user permission.

Environment > Builds

Add or Edit a Build Manually

Builds created manually have fewer fields, and can be added via Systems or via the Builds grid.

To add a Build from a System or the Build grid:

  1. From the Builds grid:
    1. Go to Environment > Builds.
    2. Click New Build.
  2. From the Systems Grid:
    1. Go to Environment > Systems.
    2. Open a System.
    3. Click New Build.
  3. Select a System:
    • Builds grid: The System can be selected.
    • System: System is grayed out, with the current System selected.
  4. Select a Linked Release:
    • Linked Releases available for selection are:
      • Active. In other words, not Completed or in an end state.
      • Linked to the selected System.
      • If a parent Enterprise Release is selected, the child Releases will also be displayed.
      • If a child Release is selected, the parent Release will not be displayed.
  5. Select a Linked Change:
    • Linked Changes available for selection are:
      • Linked to the selected System.
      • If a Linked Release is selected above, only Changes linked to the System and the Release can be selected.
  6. Select an Environment:
    • Environments available for selection are:
      • Linked to the System.
  7. Click the Manual tab if it is not already selected.
  8. Type a Build #. (Mandatory.) (Usually, the internal version number.)
  9. Type a Build Tag. (Usually, the external version number, such as 3.1.1.)
  10. Type a Branch. (Usually, the name of the branch from the source control management tool.)
  11. Select a Build Status. (Mandatory.)
  12. Click Create New Build.

Add a Build using Automated Jobs

To add Jenkins jobs to Builds from a System or the Builds grid:

  1. From the Builds grid:
    1. Go to Environment > Builds.
    2. Click New Build.
  2. From the Systems Grid:
    1. Go to Environment > Systems.
    2. Open a System.
    3. Click New Build.
  3. Select a System:
    • Builds grid: The System can be selected.
    • System: System is grayed out, with the current System selected.
  4. Select a Linked Release:
    • Linked Releases available for selection are:
      • Active. In other words, not Completed or in an end state.
      • Linked to the selected System.
      • If a parent Enterprise Release is selected, the child Releases will also be displayed.
      • If a child Release is selected, the parent Release will not be displayed.
  5. Select a Linked Change:
    • Linked Changes available for selection are:
      • Linked to the selected System.
      • If a Linked Release is selected above, only Changes linked to the System and the Release can be selected.
  6. Select an Environment:
    • Environments available for selection are:
      • Linked to the System.
  7. Click the Automated tab if it is not already selected.
  8. Click to select the checkboxes of Automated Jobs (sourced from Jenkins or Integration Hub).
  9. Select Parameters:
    1. Click + Parameters and select or type the parameters:
      • If default parameters were set, their values can be edited at this point but new parameters cannot be added.
    2. Click Save & Close.
  10. Click Create New Build.

View Build Details

To view and manage Builds in their Systems, go to Environment > Systems and open a System.

Opened Systems show the following panels.

Recent Builds Panel

Loads the 25 most recent Builds for that System.

The Build Status updates in real-time when a Build is run.

To see all the Builds for this System, go to Environment > Builds and filter by System.

Click a Build # to open the following information about that Build.

Build Name

If a Build has been created manually, you can edit its name. Hover the mouse cursor over the Build name and click the pen icon to edit.

Details Panel

The Details panel Build Tags and other information about the Build.

Click to edit:

  • Build Tag.
  • Branch Name.
  • Build Status.
  • Linked Release.

Click to view the Change Log, which is the commit information generated by the CI tool.

Deployment History Panel

The Deployment History panel shows the list of deployments of the Build to various Environments belonging to the Build’s System. This can show the Build’s progression through Environments, from Development to Production, and where the deployment has been triggered from, for example, a TECR or a Deployment Plan Activity.

Job Execution History Panel

The Job Execution History panel shows the data from the automated jobs from Jenkins and Integration Hub that have been linked to the Build.

Click View Log to see the console output.

Changes Panel

The  Changes panel shows the Changes that were selected when creating a Build. These Changes are only selectable if they are linked to the Build’s System and, if a Release is selected, to the Release as well.

Related Articles

Contents

Be the first to find out about new features. Subscribe to the Release Notes email.

Was this article helpful?

Thanks for your answer!