Managing build lives

You can review current and historical information that is related to a build life.

Create a build process and run one or more builds.
Several tools are provided to help you manage build lives and diagnose problems.
  1. From the IBM® UrbanCode™ Build dashboard, click Projects, and then use the expand icon that is associated with a project to display the project's build processes.
  2. Select a build process, and then select a build life.
    The Main tab for a build life displays information about the build and provides access to reports and artifacts that are generated by the build.
  3. Optional: To complete actions that are related to the build life, complete these steps.
    1. To see information that is related to the build request that generated the build life, click View Request.
      The Request page displays information about the user who requested the build and the project that is associated with it. You can access the build log and the request's context.
    2. To see information about the build's context, click View Context.
      The Request Context page displays information about related process requests. If a request triggers another request by dependencies, the requests are in the same context. All requests that are created by a schedule are in the same context.
    3. To see information about the build process’s configuration, click View Configuration.
    4. To see information about a job, click the job in the Process/Job/Step list.
      The Job Execution page displays information about the processed job. You can access the output log for the job and the job template.
    5. To restart the build, use the Restart icon .
    6. To run a secondary process, use the Run Secondary Process icon , and select a secondary process.
    7. To add a stamp the build, click Add Stamp, and specify the stamp.
    8. To add a label to the build, click Assign Label, and specify the label.
    9. To deactivate the build life, click Deactivate.
      When you deactivate a build life, it is permanently disabled and its artifacts removed. A deactivated build life can never be enabled nor used in dependency relationships. A build life cannot be deactivated until all the dependency relationships are resolved.
    10. To delete the build life, click Delete.
      Deleting a build life permanently removes all traces of the build life. This action cannot be reversed.
    11. To archive a build life, click Archive.
      This action stores the build properties, such as time of build, labels, and build number, and removes artifacts from CodeStation. Dependencies are locked. Archived build lives can be unarchived.
  4. Optional: To review information that is related to the build life, complete these actions:
    1. To see reports about the build life, click Reports.
      The Reports page displays information about published reports and links.
    2. To see the artifacts that are generated by the build life, click Artifacts.
      The Artifacts page displays information about the generated artifacts. You can also download and review them.
    3. To see the build life's dependent relationships, click Dependencies.
      The Dependencies page displays information about projects the build depends on, and other projects that depend on this build.
    4. To see information about source and dependency changes, click the job in the Dependencies.
    5. To see information about errors that are related to the build, click Issues.
      The Issues page displays information from issue trackers and represents defects or work items that are listed in source changes.
    6. To see information about tests that were done on the build, click Tests.
      The Tests page displays test results that are related to the build.
    7. To see information about test coverage for the build, click Coverage.
      Coverage integrations collect information on coverage tests that were run on the build.
    8. To see analytic reports, click Analytics.
      The Analytics page displays the results of source code analysis reports.
    9. To add a note to the build life, click Notes, and then Add Note, and type the note.