Welcome to the IBM Dependency Based Build (DBB) community repository. The helpful and handy location for finding and sharing example DBB scripts and snippets when building out DevOps pipelines for the mainframe.
- IBM Dependency Based Build Product Page
- IBM DBB Documentation
- IBM DBB zBuilder Build Framework - DBB zBuilder is an integrated configuration-based build framework for building z/OS applications. Build configuration is defined in YAML files.
- IBM DBB zAppBuild - The zAppBuild project is a community-driven build framework implemented in Groovy.
- IBM DBB Git Migration Modeler - An asset to provide a guided approach to plan and migrate source codebase, and help to identify and document the boundaries of mainframe applications.
- IBM Development and Pipeline Community
- IBM DevOps Acceleration Program Solution Page
Branches convey the purpose of their assets. Releases are published frequently to highlight important updates. Tags no longer mirror product version numbers — samples document their own version requirements. Backward compatibility is not a primary objective.
Note
In future releases, the repository layout will be simplified. In a next generation of the main branch, main will focus on assets targeting the use of the zBuilder framework with DBB 3.0 and later. A new epic branch will support the development of required changes. Contents of the current main branch will be kept available via a new groovy-based branch, acting as a maintenance branch, that will provide access to existing Groovy-based assets.
Until this change, the below branches' purposes are:
-
main - keeps the existing structure for both zBuilder and Groovy-based assets.
-
simplify/community-templates - the new development branch focussing on the zBuilder framework with DBB 3.0 and later. This holds the simplified, designated target layout for the project.
See releases for prior versions of the community assets.
For instructions on how to contribute new samples and bug fixes, please read the Contributions Guidelines.
| Sample | Description |
|---|---|
| IDE/GitISPFClient | An ISPF interface that interacts with a Git repository to allow cloning, staging, checking in, pushing and pulling as well as other git commands. |
| Pipeline/AnalyzeCodeCoverageReport | Sample script to extract and print Code Coverage information as collected by IBM Debug. |
| Pipeline/CreateUCDComponentVersion | Post-build script to parse the DBB Build report to generate a UCD component shiplist file and to create a new UCD component version. |
| Pipeline/DeployUCDComponentVersion | Sample script to trigger a UCD deployment from the pipeline, where the pipeline orchestrator does not provide standard plugins for this task. |
| Pipeline/PackageBuildOutputs | Post-build script to create a generic package with the produced build outputs, optionally uploads results to an Artifactory repository. Artifactory deploy/download sample script. |
| Pipeline/RunIDZCodeReview | Post-build script to integrate IBM IDz Code Review application into a pipeline. |
| Pipeline/SimplePackageDeploy | Post-build script to deploy the tar package contents to the target libraries. |
| Scanners | Sample dependency scanner implementations using the extension framework of the DBB toolkit. |
| Schema | zBuilder schema used to configure YAML validation for build and application configurations in an IDE. |
| Templates | Contains Pipeline templates for various Pipeline orchestrators such as AzureDevOps, Gitlab, Github Actions and Jenkins. |
| Templates/Common-Backend-Scripts | Asset to encapsulate pipeline steps to simplify the pipeline implementation. |
| Utilities/DeletePDS | Sample script to delete PDSes on z/OS that are no longer needed. |
| Utilities/Jenkins | Utility shell scripts supplied to address issues when running Jenkins remote agents on z/OS UNIX System Services (USS). |
| Utilities/PermissionCheck | Groovy script to check the DBB role for a provided user. |
| Utilities/ReadSMFRecords | Groovy scripts to read System Management Facilities (SMF) records using IBM's Dependency Based Build capabilities. |
| WaziDeploy/Reporting | This category provides templates for querying IBM Wazi Deploy evidence files and generating detailed reports. |
| WaziDeploy/Schemas | Wazi Deploy schemas used to configure Yaml validation for the config file, the deployment method file and the manifest file. |
| WaziDeploy/zDeploy | Wazi Deploy deployment configuration framework for both Ansible and Python, that allows maintaining application specific configuration along the core deployment configuration for Wazi Deploy. |
| zBuilder extensions | IBM zBuilder extensions showcasing advanced scenarios. |
| zBuilder/MortgageApplication | Mortgage Application sample application prepared to be built with IBM DBB zBuilder. |