Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 62 additions & 0 deletions configuring/customize-build-strategy-runtime-options.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
:_mod-docs-content-type: ASSEMBLY
[id="customize-build-strategy-runtime-options"]
= Customize Your Build Strategy and Runtime Options

include::_attributes/common-attributes.adoc[]
:context: customize-build-strategy-runtime-options

toc::[]

[role="_abstract"]
Platform engineers can customize build execution by configuring source inputs, strategy selection, build specifications, pod settings, volumes, environment variables, and runtime parameters. These configuration options enable fine-grained control over how builds run on the cluster.

include::modules/ob-define-build-inputs-source-code.adoc[leveloffset=+1]

include::modules/ob-defining-the-source.adoc[leveloffset=+2]

include::modules/ob-defining-the-strategy.adoc[leveloffset=+2]

include::modules/ob-defining-the-container-file.adoc[leveloffset=+2]

include::modules/ob-defining-the-build-specification.adoc[leveloffset=+2]

include::modules/ob-configuring-pods-in-build.adoc[leveloffset=+2]

include::modules/ob-defining-the-service-account.adoc[leveloffset=+2]

include::modules/ob-specifying-environment-variables.adoc[leveloffset=+2]

include::modules/ob-defining-volumes.adoc[leveloffset=+2]

include::modules/ob-resource-management-in-tekton-pipelines.adoc[leveloffset=+2]

include::modules/ob-configure-build-inputs-outputs.adoc[leveloffset=+1]

include::modules/ob-defining-the-output.adoc[leveloffset=+2]

include::modules/ob-defining-param-values.adoc[leveloffset=+2]

include::modules/ob-defining-the-build-reference.adoc[leveloffset=+2]

include::modules/ob-run-customize-build-execution.adoc[leveloffset=+1]

include::modules/ob-configuring-pods-in-build-run.adoc[leveloffset=+2]

include::modules/ob-defining-volumes-in-build-run.adoc[leveloffset=+2]

include::modules/ob-defining-param-values-in-build-run.adoc[leveloffset=+2]

include::modules/ob-defining-retention-parameters-in-build-run.adoc[leveloffset=+2]

include::modules/ob-track-build-progress-manage-running-builds.adoc[leveloffset=+1]

include::modules/ob-understanding-the-status-of-a-build-run.adoc[leveloffset=+2]

include::modules/ob-canceling-a-build-run.adoc[leveloffset=+2]

include::modules/ob-defining-system-results.adoc[leveloffset=+2]

include::modules/ob-build-snapshot.adoc[leveloffset=+1]

// [role="_additional-resources"]
// == Additional resources
11 changes: 11 additions & 0 deletions modules/ob-configure-build-inputs-outputs.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
// This module is included in the following assembly:
//
// * configuring/customize-build-strategy-runtime-options.adoc

:_mod-docs-content-type: REFERENCE
[id="ob-configure-build-inputs-outputs_{context}"]
= Configure build inputs and outputs

[role="_abstract"]
Build inputs and outputs define how {builds-shortname} sources content for the build process and where it delivers the resulting container image. The input configuration specifies the source code location, authentication credentials, and any parameters that customize the build behavior. The output configuration determines the registry destination, push credentials, and optional metadata for the built image.

10 changes: 10 additions & 0 deletions modules/ob-define-build-inputs-source-code.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
// This module is included in the following assembly:
//
// * configuring/customize-build-strategy-runtime-options.adoc

:_mod-docs-content-type: REFERENCE
[id="ob-define-build-inputs-source-code_{context}"]
= Define build inputs and source code

[role="_abstract"]
Build inputs and source code configuration determine how {builds-shortname} locates, retrieves, and processes your application source code during the build process. These configuration options specify the source repository, build strategy, containerization instructions, and runtime environment needed to transform source code into a container image.
10 changes: 10 additions & 0 deletions modules/ob-run-customize-build-execution.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
// This module is included in the following assembly:
//
// * configuring/customize-build-strategy-runtime-options.adoc

:_mod-docs-content-type: REFERENCE
[id="ob-run-customize-build-execution_{context}"]
= Run and customize a build execution

[role="_abstract"]
Running and customizing a build execution involves configuring the runtime environment and resource behavior for a BuildRun custom resource. These settings control how {builds-shortname} executes a build, including pod configuration, volume mounts, parameter values, and retention policies for completed build runs.
10 changes: 10 additions & 0 deletions modules/ob-track-build-progress-manage-running-builds.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
// This module is included in the following assembly:
//
// * configuring/customize-build-strategy-runtime-options.adoc

:_mod-docs-content-type: REFERENCE
[id="ob-track-build-progress-manage-running-builds_{context}"]
= Track build progress and manage running builds

[role="_abstract"]
Tracking build progress and managing running builds enables you to monitor the current state of build executions and control their lifecycle. You can observe build status through the BuildRun custom resource, which provides real-time information about build progression, completion, and any errors that occur. When necessary, you can cancel running builds before they complete.