Configure and Edit Builds

Builds in a CI/CD environment represent a sequence of steps executed automatically to test, package, or deploy your application. The build configuration includes parameters such as the version control repository, execution steps, artifacts, etc.

Create Build Configuration

1. Navigate to Projects to access the project management interface.

   

2. Select the project where you want to create the build and click New Build Configuration.

   

3. Enter Build Configuration Name and an optional Description.

   

4. Click Create to create the build configuration.

   

5. Navigate to VCS Settings and click Add VCS.

   

6. Enter the following details:

   • VCS Root Type: VCS type from where the source code will be fetched, such as Git, GitHub, Bitbucket, or other repository.
   • VCS Name: A unique name given by the user.
   • Repository URL: URL of the source code placed on Git.
   • Branch: The branch to build from, such as main or develop.
   • Checkout Directory: The local directory (on the Build Agent) where the repository will be checked out.
   • Authentication Mode: The method to authenticate the VCS while fetching the source code from the VCS.

   

7. (Optional) Click Test Connection to verify the configuration before saving.

   

8. Click OK to add the VCS.

   

9. Click Save to save the VCS Settings.

   

10. Navigate to Execution Steps and click Add Execution Step.

    

11. Enter the following details:

    • Select Runner: The machine or environment, such as Command Line, Config File, MS Build, or VS Test, that executes build, test, and deployment steps.
    • Step Name: Name of the step (optional).
    • Working Directory: The directory where the commands will be executed. This is an optional field; if left blank, the default working directory will be used.
    • Commands: The shell command(s) executed as part of your build workflow.
    • Execute Next Steps: Defines whether subsequent steps run when this step fails. You can configure it to either continue execution or stop the build process on failure.

    

    note

    For more information on build runners and their parameters, see Build Runners.

12. Click OK to add the execution step.

    

13. Click Save to save the Execution Steps.

    

14. Navigate to Artifacts and click Add Artifact.

    

15. Enter the following details:

    • Name: Name of the artifact.
    • Condition: Defines when the build artifact will be published.
    • Paths: The location of files that the BuildNinja will save, upload, or pass to later steps or jobs.

    

16. Click OK to add the artifact.

    

17. Click Save to save the Artifacts.

    

18. Navigate to Agents Criteria and click Add Parameter.

    

19. Enter the following details:

    • Parameter Name: The name of a property or capability that the build agent must have.
    • Operator: The condition to check between the parameter and the value.
    • Value: The expected value to compare against the parameter.

    

20. Click OK to add the parameter.

    

21. Click Save to save the Agents Criteria.

    

Edit Build Configuration

BuildNinja enables you to update build configuration settings at any time to reflect changes in your development, infrastructure, or deployment workflows. You can modify the following settings:

Basic Information

Edit your basic build information using the following options:

• Build Configuration Name: Update the display name of the build configuration.
• Description: Add or change the description to clarify purpose, usage, or ownership.

VCS Settings

Edit your Version Control System (VCS) configuration using the following options:

• Cache: Enable or disable configuration caching to control whether cloned repositories and dependencies are reused for faster build execution.
• Add VCS: Connect a new repository.
• Edit: Modify repository details such as URL, branch, or authentication method.
• Delete: Remove VCS settings that are no longer needed.

Execution Steps

Edit your execution steps to define how your code is built, tested, and deployed using the following options:

• Add Execution Step: Add a new step to the process.
• Reorder: Change the execution order using drag-and-drop.
• Edit: Update the configuration of an existing step.
• Duplicate: Copy a step to reuse its configuration.
• Disable: Temporarily turn off a step without deleting it.
• Delete: Remove steps you no longer need.

Artifacts

Edit your artifact settings to manage the files generated during builds using the following options:

• Add Artifact: Define new rules for what gets saved or shared.
• Edit: Update existing artifact rules or destination paths.
• Delete: Remove outdated or unused rules.

Agents Criteria

Edit your agents criteria to control where builds run using the following options:

• Add Parameter: Add filters to match specific build agents.
• Edit: Update existing filters (e.g., OS, tools, tags).
• Delete: Remove parameters that are no longer applicable.

How to Edit a Build Configuration

1. Select the build configuration you want to edit and click Edit Configuration.

   

2. Select the setting you want to edit.

   

3. Make the necessary edits and click Save to save the updated build configuration.

   

Edit Build Configuration via Configuration Details Tab

1. Select the build configuration you want to edit.

   

2. Navigate to Configuration Details tab. You can modify the following settings in the Configuration Details tab:

   • General Settings
   • VCS Settings
   • Execution Steps
   • Artifact Settings
   • Agent Criteria

   

3. Click Edit icon next to the setting name to open its main settings page.

   

4. Make the necessary edits and click Save to save the updated build configuration.