Build schema reference

Schema reference for the build section of a Ravion module definition, covering image, Lambda, static, and disabled build configuration types.

Legend

Notation	Meaning
T[]	Array of T
map<string,T>	Object keyed by strings with T values
enum[a,b]	One of the listed values
A | B	One of several types
~template	Field accepts << ... >> template expressions

Build

Build configuration for this module

ModuleBuild

Build configuration — discriminated by module build type

Discriminated union. The type field selects which schema applies.

type value	Schema
disabled	DisabledModuleBuild
image	ImageModuleBuild
lambda	LambdaModuleBuild
static	StaticModuleBuild

DisabledModuleBuild

Disabled build configuration for a module. Additional fields are ignored.

type · enum · required

Build type discriminator

Allowed values: disabled

ImageModuleBuild

Image build configuration for a module.

type · enum · required

Build type discriminator

Allowed values: image

(templateable)

timeout · integer | null

Maximum execution time in seconds before the build is killed.

(format:int32,min:1; templateable)

inputs · InputProperty[] · required

Build-specific inputs shown when running a module build.

See: InputProperty

source · Pipeline.GitSource · required

Git source configuration.

See: Pipeline.GitSource

(templateable)

builder · Pipeline.ImageBuildConfig · required

Builder configuration — dockerfile, nixpacks, or railpack settings.

See: Pipeline.ImageBuildConfig

(templateable)

environment_variables · Pipeline.EnvironmentVariablesValue

Environment variables available during the build.

See: Pipeline.EnvironmentVariablesValue

(templateable)

debug · boolean | null

Enable verbose build output for debugging build issues.

(templateable)

destinations · Pipeline.EcrDestination[] · required

ECR destinations where the built Docker image will be pushed.

See: Pipeline.EcrDestination

(minItems:1; templateable)

infrastructure · Pipeline.StepInfrastructure · required

Execution environment configuration used for the build.

See: Pipeline.StepInfrastructure

(templateable)

LambdaModuleBuild

Lambda build configuration for a module. Produces a zip artifact uploaded to S3, sized for the Lambda Zip package type. Wraps the existing `Pipeline.BuildLam…

type · enum · required

Build type discriminator

Allowed values: lambda

(templateable)

timeout · integer | null

Maximum execution time in seconds before the build is killed.

(format:int32,min:1; templateable)

inputs · InputProperty[] · required

Build-specific inputs shown when running a module build.

See: InputProperty

source · Pipeline.GitSource · required

Git source configuration.

See: Pipeline.GitSource

(templateable)

builder · Pipeline.LambdaBuildConfig · required

Builder configuration — dockerfile or nixpacks settings for the Lambda zip build. Reuses the existing Pipeline.LambdaBuildConfig shape so module builds and…

See: Pipeline.LambdaBuildConfig

(templateable)

environment_variables · Pipeline.EnvironmentVariablesValue

Environment variables available during the build.

See: Pipeline.EnvironmentVariablesValue

(templateable)

debug · boolean | null

Enable verbose build output for debugging build issues.

(templateable)

destinations · Pipeline.S3Destination[] · required

S3 destinations where the Lambda deployment package will be uploaded. At least one is required; the resulting key is passed to the deploy step as `deploy.inp…

See: Pipeline.S3Destination

(minItems:1; templateable)

infrastructure · Pipeline.StepInfrastructure · required

Execution environment configuration used for the build.

See: Pipeline.StepInfrastructure

(templateable)

StaticModuleBuild

Static build configuration for a module.

type · enum · required

Build type discriminator

Allowed values: static

(templateable)

timeout · integer | null

Maximum execution time in seconds before the build is killed.

(format:int32,min:1; templateable)

inputs · InputProperty[] · required

Build-specific inputs shown when running a module build.

See: InputProperty

source · Pipeline.GitSource · required

Git source configuration.

See: Pipeline.GitSource

(templateable)

builder · Pipeline.StaticBuildConfig · required

Builder configuration — dockerfile, nixpacks, or railpack settings.

See: Pipeline.StaticBuildConfig

(templateable)

environment_variables · Pipeline.EnvironmentVariablesValue

Environment variables available during the build.

See: Pipeline.EnvironmentVariablesValue

(templateable)

debug · boolean | null

Enable verbose build output for debugging build issues.

(templateable)

destinations · Pipeline.S3Destination[] · required

S3 destinations where the built static assets will be uploaded.

See: Pipeline.S3Destination

(minItems:1; templateable)

infrastructure · Pipeline.StepInfrastructure · required

Execution environment configuration used for the build.

See: Pipeline.StepInfrastructure

(templateable)

Pipeline.EcrDestination

ECR destination for image builds

id · string · required

Unique destination identifier within the build step

(templateable)

type · enum · required

ECR destination type

Allowed values: ecr

(templateable)

repository_arn · string · required

ECR repository ARN

(templateable)

tags · string[] | null

Docker image tags to apply in ECR after the build finishes

(templateable)

Pipeline.EnvironmentVariablesValue

Environment variable map value.

One of: map<string,Pipeline.EnvironmentVariable>, string.

Pipeline.GitSource

Git source configuration for fetching code

type · enum · required

Source type identifier

Allowed values: git

(templateable)

repo · string · required

Full repository URL including host

(templateable)

branch · string · required

Branch to check out

(minLen:1; templateable)

ref · string | null

Git ref to check out — branch, commit SHA, tag, or other ref. Overrides branch HEAD if set.

(templateable)

base_path · string | null · default: "."

Base path within the repository to use as the working root

(templateable)

Pipeline.ImageBuildConfig

Image build configuration — discriminated by build method

Discriminated union. The type field selects which schema applies.

type value	Schema
disabled	Pipeline.DisabledBuildConfig
dockerfile	Pipeline.ImageDockerfileBuildConfig
nixpacks	Pipeline.ImageNixpacksBuildConfig
railpack	Pipeline.ImageRailpackBuildConfig

Pipeline.StepInfrastructure

Step infrastructure configuration

execution_environment_id · string | null

ID or given ID of a pre-configured execution environment

(templateable)

aws_account_id · string | null

AWS account reference for automatic network selection.

(templateable)

region · string | null

AWS region for automatic network selection

(templateable)

type · enum · required

Instance type — “ec2” for on-demand or “ec2-spot” for cheaper spot instances

Allowed values: ec2 | ec2-spot

(templateable)

instance_size · string | string[] · required

Instance size — a single size like “large” or an array like [“large”, “xlarge”] for spot fallback

(templateable)

ami · string | null

AMI ID for the runner instance

(templateable)

permissions · Pipeline.AwsPermissions

IAM permissions for the runner role — “attach” to add policies or “replace” to override step defaults

See: Pipeline.AwsPermissions

(templateable)

storage · Pipeline.StorageConfig

Root volume storage configuration

See: Pipeline.StorageConfig

(templateable)

Pipeline.LambdaBuildConfig

Lambda build configuration — discriminated by build method

Discriminated union. The type field selects which schema applies.

type value	Schema
disabled	Pipeline.DisabledBuildConfig
dockerfile	Pipeline.LambdaDockerfileBuildConfig
nixpacks	Pipeline.LambdaNixpacksBuildConfig

Pipeline.S3Destination

S3 destination for build artifacts

id · string · required

Unique destination identifier within the build step

(minLen:1; templateable)

type · enum · required

S3 destination type

Allowed values: s3

(templateable)

bucket · string · required

S3 bucket name where built assets will be uploaded

(templateable)

directory · string | null

S3 directory override for the uploaded build output.

(templateable)

region · string · required

AWS region for the destination S3 bucket

(templateable)

Pipeline.StaticBuildConfig

Static build configuration — discriminated by build method

Discriminated union. The type field selects which schema applies.

type value	Schema
dockerfile	Pipeline.StaticDockerfileBuildConfig
nixpacks	Pipeline.StaticNixpacksBuildConfig
railpack	Pipeline.StaticRailpackBuildConfig

Pipeline.EnvironmentVariable

Environment variable — can be a plain string, Parameter Store reference, or Secrets Manager reference

One of: string | null, Pipeline.ParameterStoreEnvVar, Pipeline.SecretsManagerEnvVar.

Pipeline.DisabledBuildConfig

Disabled build configuration. Valid only for module-driven builds.

type · enum · required

Build method — disables module build execution

Allowed values: disabled

(templateable)

Pipeline.ImageDockerfileBuildConfig

Dockerfile configuration for image builds

type · enum · required

Build method — use a custom Dockerfile

Allowed values: dockerfile

(templateable)

dockerfile · string | null · default: "Dockerfile"

Path to Dockerfile relative to source.base_path

(minLen:1; templateable)

context · string | null · default: "."

Docker build context path relative to source.base_path

(templateable)

inject_env_variables_in_dockerfile · boolean | null

Whether to inject environment variables as Docker build args Accepts either a boolean literal or a full template token

(templateable)

cache_from · Pipeline.CacheFromConfig

Docker layer cache configuration

See: Pipeline.CacheFromConfig

(templateable)

Pipeline.ImageNixpacksBuildConfig

Nixpacks configuration for image builds

type · enum · required

Build method — use Nixpacks auto-detection

Allowed values: nixpacks

(templateable)

nixpacks_version · string | null

Nixpacks version to use

(templateable)

build_path · string | null

Directory to run the Nixpacks build from, relative to the repository root

(templateable)

config_file_path · string | null

Path to the Nixpacks configuration file relative to the repository root

(templateable)

nix_pkgs · string[] | null

Additional Nix packages to install

(templateable)

apt_pkgs · string[] | null

Additional apt packages to install

(templateable)

nix_libs · string[] | null

Additional Nix libraries to install

(templateable)

install_cmd · string | null

Custom install command

(templateable)

build_cmd · string | null

Custom build command

(templateable)

start_cmd · string | null

Application start command

(templateable)

cache_from · Pipeline.CacheFromConfig

Docker layer cache configuration

See: Pipeline.CacheFromConfig

(templateable)

Pipeline.ImageRailpackBuildConfig

Railpack configuration for image builds

type · enum · required

Build method — use Railpack auto-detection

Allowed values: railpack

(templateable)

railpack_version · string | null

Railpack version to use

(templateable)

install_cmd · string | null

Custom install command

(templateable)

build_cmd · string | null

Custom build command

(templateable)

start_cmd · string | null

Application start command

(templateable)

cache_from · Pipeline.CacheFromConfig

Docker layer cache configuration

See: Pipeline.CacheFromConfig

(templateable)

Pipeline.AwsPermissions

IAM policies configuration for runner roles Used by EC2-backed steps to specify additional permissions

One of: Pipeline.AwsPermissionsAttach, Pipeline.AwsPermissionsReplace.

Pipeline.InfrastructureType

Execution environment type

Allowed values:

• ec2
• ec2-spot

Pipeline.InstanceSize

Instance size can be a single string or array of strings

One of: string, string[].

Pipeline.StorageConfig

Root volume storage configuration

type · enum

Volume type

Allowed values: gp3 | gp2 | io2 | io1

(templateable)

size · integer | null

Volume size in GiB

(format:int32; templateable)

iops · integer | null

Provisioned IOPS

(format:int32; templateable)

throughput · integer | null

Provisioned throughput in MiB/s

(format:int32; templateable)

Pipeline.LambdaDockerfileBuildConfig

Dockerfile configuration for Lambda builds

type · enum · required

Build method — use a custom Dockerfile

Allowed values: dockerfile

(templateable)

dockerfile · string | null · default: "Dockerfile"

Path to Dockerfile relative to source.base_path

(minLen:1; templateable)

context · string | null · default: "."

Docker build context path relative to source.base_path

(templateable)

inject_env_variables_in_dockerfile · boolean | null

Whether to inject environment variables as Docker build args Accepts either a boolean literal or a full template token

(templateable)

output_directory · string · required

Directory inside the built image containing the Lambda package contents

(minLen:1; templateable)

max_zip_size · integer | null · default: "52428800"

Maximum allowed zip size in bytes — build fails if exceeded

(format:int32; templateable)

Pipeline.LambdaNixpacksBuildConfig

Nixpacks configuration for Lambda builds

type · enum · required

Build method — use Nixpacks auto-detection

Allowed values: nixpacks

(templateable)

nixpacks_version · string | null

Nixpacks version to use

(templateable)

build_path · string | null

Directory to run the Nixpacks build from, relative to the repository root

(templateable)

config_file_path · string | null

Path to the Nixpacks configuration file relative to the repository root

(templateable)

nix_pkgs · string[] | null

Additional Nix packages to install

(templateable)

apt_pkgs · string[] | null

Additional apt packages to install

(templateable)

nix_libs · string[] | null

Additional Nix libraries to install

(templateable)

install_cmd · string | null

Custom install command

(templateable)

build_cmd · string | null

Custom build command

(templateable)

start_cmd · string | null

Application start command

(templateable)

output_directory · string · required

Directory inside the built image containing the Lambda package contents

(minLen:1; templateable)

max_zip_size · integer | null · default: "52428800"

Maximum allowed zip size in bytes — build fails if exceeded

(format:int32; templateable)

Pipeline.StaticDockerfileBuildConfig

Dockerfile configuration for static builds

type · enum · required

Build method — use a custom Dockerfile

Allowed values: dockerfile

(templateable)

dockerfile · string | null · default: "Dockerfile"

Path to Dockerfile relative to source.base_path

(minLen:1; templateable)

context · string | null · default: "."

Docker build context path relative to source.base_path

(templateable)

inject_env_variables_in_dockerfile · boolean | null

Whether to inject environment variables as Docker build args Accepts either a boolean literal or a full template token

(templateable)

output_directory · 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)

Pipeline.StaticNixpacksBuildConfig

Nixpacks configuration for static builds

type · enum · required

Build method — use Nixpacks auto-detection

Allowed values: nixpacks

(templateable)

nixpacks_version · string | null

Nixpacks version to use

(templateable)

build_path · string | null

Directory to run the Nixpacks build from, relative to the repository root

(templateable)

config_file_path · string | null

Path to the Nixpacks configuration file relative to the repository root

(templateable)

nix_pkgs · string[] | null

Additional Nix packages to install

(templateable)

apt_pkgs · string[] | null

Additional apt packages to install

(templateable)

nix_libs · string[] | null

Additional Nix libraries to install

(templateable)

install_cmd · string | null

Custom install command

(templateable)

build_cmd · string | null

Custom build command

(templateable)

output_directory · 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)

Pipeline.StaticRailpackBuildConfig

Railpack configuration for static builds

type · enum · required

Build method — use Railpack auto-detection

Allowed values: railpack

(templateable)

railpack_version · string | null

Railpack version to use

(templateable)

install_cmd · string | null

Custom install command

(templateable)

build_cmd · string | null

Custom build command

(templateable)

output_directory · 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)

Pipeline.ParameterStoreEnvVar

Environment variable from AWS Parameter Store

from_parameter_store · Pipeline.ParameterStoreReferenceValue · required

Parameter Store reference

See: Pipeline.ParameterStoreReferenceValue

(templateable)

Pipeline.SecretsManagerEnvVar

Environment variable from AWS Secrets Manager

from_secrets_manager · Pipeline.SecretsManagerReferenceValue · required

Secrets Manager reference

See: Pipeline.SecretsManagerReferenceValue

(templateable)

Pipeline.CacheFromConfig

Configuration for Docker layer cache source from ECR

digest · string | null

Specific image digest to use for cache

(templateable)

tag · string | null

Specific image tag to use for cache

(templateable)

Pipeline.AwsPermissionsAttach

IAM policies to attach alongside step default policies

attach · string[] · required

AWS managed policy ARNs to attach alongside step default policies

(templateable)

Pipeline.AwsPermissionsReplace

IAM policies to replace step default policies entirely

replace · string[] · required

AWS managed policy ARNs to use instead of step default policies

(templateable)

Pipeline.EbsVolumeType

EBS volume type for the runner root volume

Allowed values:

• gp3
• gp2
• io2
• io1

Pipeline.ParameterStoreReferenceValue

Parameter Store reference — shorthand string or object with optional version metadata

One of: string, Pipeline.ParameterStoreReference.

Pipeline.SecretsManagerReferenceValue

Secrets Manager reference — shorthand string or object with optional JSON key/version metadata

One of: string, Pipeline.SecretsManagerReference.

Pipeline.ParameterStoreReference

Parameter Store reference with optional version metadata

key · string · required

Parameter Store parameter name or path

(templateable)

version · string | null

Parameter version number

(templateable)

Pipeline.SecretsManagerReference

Secrets Manager reference with optional JSON key and version metadata

key · string · required

Secret name or ARN in Secrets Manager

(templateable)

json_key · string | null

JSON key to extract from a JSON-structured secret

(templateable)

version · string | null

Secret version ID or stage

(templateable)