Legend
EcrDestination
ECR destination for image buildsstring
required
Unique destination identifier within the build step(templateable)
enum
required
ECR destination typeAllowed values:
ecr(templateable)string
required
ECR repository ARN(templateable)
string[] | null
Docker image tags to apply in ECR after the build finishes(templateable)
GitSource
Git source configuration for fetching code. Ravion partially clones the full history ofbranch
plus tags, fetching file contents on demand, then checks out ref if set. Other branches are not
fetched. Set fetch_depth for a shallow clone.enum
required
Source type identifierAllowed values:
git(templateable)string
required
Full repository URL including host(templateable)
string
required
Branch to check out(minLen:1; templateable)
string | null
Git ref to check out — branch, commit SHA, tag, or other ref. Overrides branch HEAD if set.(templateable)
integer | null
Number of commits of history to fetch, ending at the checked-out commit. Tags are not fetched when set.(format:int32,min:1; templateable)
string | null
default:"."
Base path within the repository to use as the working root(templateable)
ImageBuildConfig
Image build configuration — discriminated by build methodDiscriminated union. Thetype field selects which schema applies.S3Destination
S3 destination for build artifactsstring
required
Unique destination identifier within the build step(minLen:1; templateable)
enum
required
S3 destination typeAllowed values:
s3(templateable)string
required
S3 bucket name where built assets will be uploaded(templateable)
string | null
S3 directory override for the uploaded build output.
When omitted, the build step generates a flat directory from the step ID,
commit short SHA, and pipeline run ID.(templateable)
string
required
AWS region for the destination S3 bucket(templateable)
StaticBuildConfig
Static build configuration — discriminated by build methodDiscriminated union. Thetype field selects which schema applies.DisabledBuildConfig
Disabled build configuration. Valid only for module-driven builds.enum
required
Build method — disables module build executionAllowed values:
disabled(templateable)ImageDockerfileBuildConfig
Dockerfile configuration for image buildsenum
required
Build method — use a custom DockerfileAllowed values:
dockerfile(templateable)string | null
default:"Dockerfile"
Path to Dockerfile relative to source.base_path(minLen:1; templateable)
string | null
default:"."
Docker build context path relative to source.base_path(templateable)
map<string,string> | null
Explicit Docker build args passed to buildx without adding declarations to the Dockerfile.
Values can be literal strings or pipeline templates.(templateable)
boolean | null
Whether to inject environment variables as ARG and ENV declarations after every FROM
in the Dockerfile. Changing injected values invalidates every following layer, and the ENV
declarations persist those values in the image. Prefer build_args when you need explicit
control over ARG placement, and use BuildKit secrets for credentials.
Accepts either a boolean literal or a full template token(templateable)
CacheFromConfig
ImageNixpacksBuildConfig
Nixpacks configuration for image buildsenum
required
Build method — use Nixpacks auto-detectionAllowed values:
nixpacks(templateable)string | null
Nixpacks version to use(templateable)
string | null
Directory to run the Nixpacks build from, relative to the repository root(templateable)
string | null
Path to the Nixpacks configuration file relative to the repository root(templateable)
string[] | null
Additional Nix packages to install(templateable)
string[] | null
Additional apt packages to install(templateable)
string[] | null
Additional Nix libraries to install(templateable)
string | null
Custom install command(templateable)
string | null
Custom build command(templateable)
string | null
Application start command(templateable)
CacheFromConfig
ImageRailpackBuildConfig
Railpack configuration for image buildsenum
required
Build method — use Railpack auto-detectionAllowed values:
railpack(templateable)string | null
Railpack version to use(templateable)
string | null
Custom install command(templateable)
string | null
Custom build command(templateable)
string | null
Application start command(templateable)
CacheFromConfig
StaticDockerfileBuildConfig
Dockerfile configuration for static buildsenum
required
Build method — use a custom DockerfileAllowed values:
dockerfile(templateable)string | null
default:"Dockerfile"
Path to Dockerfile relative to source.base_path(minLen:1; templateable)
string | null
default:"."
Docker build context path relative to source.base_path(templateable)
map<string,string> | null
Explicit Docker build args passed to buildx without adding declarations to the Dockerfile.
Values can be literal strings or pipeline templates.(templateable)
boolean | null
Whether to inject environment variables as ARG and ENV declarations after every FROM
in the Dockerfile. Changing injected values invalidates every following layer, and the ENV
declarations persist those values in the image. Prefer build_args when you need explicit
control over ARG placement, and use BuildKit secrets for credentials.
Accepts either a boolean literal or a full template token(templateable)
string
required
Directory inside the built image containing the static assets to upload
This path is resolved relative to source.base_path(minLen:1; templateable)
StaticNixpacksBuildConfig
Nixpacks configuration for static buildsenum
required
Build method — use Nixpacks auto-detectionAllowed values:
nixpacks(templateable)string | null
Nixpacks version to use(templateable)
string | null
Directory to run the Nixpacks build from, relative to the repository root(templateable)
string | null
Path to the Nixpacks configuration file relative to the repository root(templateable)
string[] | null
Additional Nix packages to install(templateable)
string[] | null
Additional apt packages to install(templateable)
string[] | null
Additional Nix libraries to install(templateable)
string | null
Custom install command(templateable)
string | null
Custom build command(templateable)
string
required
Directory inside the built image containing the static assets to upload
This path is resolved relative to source.base_path(minLen:1; templateable)
StaticRailpackBuildConfig
Railpack configuration for static buildsenum
required
Build method — use Railpack auto-detectionAllowed values:
railpack(templateable)string | null
Railpack version to use(templateable)
string | null
Custom install command(templateable)
string | null
Custom build command(templateable)
string
required
Directory inside the built image containing the static assets to upload
This path is resolved relative to source.base_path(minLen:1; templateable)
CacheFromConfig
Configuration for Docker layer cache source from ECRstring | null
Specific image digest to use for cache(templateable)
string | null
Specific image tag to use for cache(templateable)