Type object
File match batect.yml batect-bundle.yml
Schema URL https://catalog.lintel.tools/schemas/schemastore/batect-yml/latest.json
Source https://ide-integration.batect.dev/v1/configSchema.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

containers Record<string, object>

Definitions for each of the containers that make up your various environments

tasks Record<string, object>

Definitions for each of your tasks, the actions you launch through Batect

config_variables Record<string, object>

Definitions for each of the config variables used to configure your tasks and containers

project_name string

The name of your project. Used to label any images built.

minLength=1
forbid_telemetry boolean

Forbid reporting telemetry information for this project, even if the user has previously consented to telemetry.

include include[]

List of configuration files to include in this project

Definitions

containers Record<string, object>

Definitions for each of the containers that make up your various environments

container object
image string

Image name (in standard Docker image reference format) to use for this container

minLength=1
build_directory string

Path (relative to the configuration file's directory) to a directory containing a Dockerfile to build and use as an image for this container

minLength=1
build_args Record<string, string>
build_target string

Dockerfile stage name to build and use for this container

minLength=1
build_ssh object[]
build_secrets Record<string, environmentSecret | fileSecret>
dockerfile string

Dockerfile (relative to build_directory) to use when building the image. Defaults to Dockerfile if not set.

minLength=1
command string

Command to run when the container starts

minLength=1
entrypoint string

Entrypoint to use to run the command

minLength=1
environment Record<string, string | number>
working_directory string

Working directory to start the container in

minLength=1
dependencies string[]
uniqueItems=true
health_check object
5 nested properties
retries integer

The number of times to perform the health check before considering the container unhealthy

min=0
interval string

The interval between runs of the health check. Accepts values such as 2s (two seconds) or 1m (one minute).

minLength=1
start_period string

The time to wait before failing health checks count against the retry count. The health check is still run during this period, and if the check succeeds, the container is immediately considered healthy. Accepts values such as 2s (two seconds) or 1m (one minute).

minLength=1
timeout string

The time to wait before timing out a single health check command invocation. Accepts values such as 2s (two seconds) or 1m (one minute).

minLength=1
command string

The command to run to check the health of the container. If this command exits with code 0, the container is considered healthy.

minLength=1
run_as_current_user object | object
privileged boolean

Enable privileged mode for the container

enable_init_process boolean

Set to true to run an init process inside the container that forwards signals and reaps processes

capabilities_to_add string[]
capabilities_to_drop string[]
additional_hostnames string[]
uniqueItems=true
additional_hosts Record<string, string>

Additional hostnames to add to /etc/hosts in the container

setup_commands object[]
log_driver string

Docker log driver to use

log_options Record<string, string>

Additional options to pass to Docker log driver

image_pull_policy string

Whether or not to pull image (including base image for containers that use a built image), even if it has already been pulled

Values: "Always" "IfNotPresent"
shm_size string

Size of /dev/shm (shared memory for IPC) for the container

pattern=^\d+\s*[mkg]?b?$
labels Record<string, string>

Labels to apply to the container

tasks Record<string, object>

Definitions for each of your tasks, the actions you launch through Batect

task object

Definition of a single task

run object

Specifies what to do when this task starts

6 nested properties
container string required

Container to run for this task

minLength=1
command string

Command to run for this task

minLength=1
entrypoint string

Entrypoint to use to run the command for this task

minLength=1
environment Record<string, string | number>
working_directory string

Working directory to start the container in

minLength=1
description string

Description shown when running batect --list-tasks

minLength=1
group string

Name used to group tasks when running batect --list-tasks

minLength=1
dependencies string[]
uniqueItems=true
prerequisites string[]

List of other tasks that should be run before running this task

uniqueItems=true
customise Record<string, object>

Customisations for dependency containers run as part of this task

taskRunOptions object

Specifies what to do when this task starts

container string required

Container to run for this task

minLength=1
command string

Command to run for this task

minLength=1
entrypoint string

Entrypoint to use to run the command for this task

minLength=1
environment Record<string, string | number>
working_directory string

Working directory to start the container in

minLength=1
taskContainerCustomisation object
environment Record<string, string | number>
working_directory string

Working directory to start the container in

minLength=1
containerDependencyList string[]
additionalHostnamesList string[]
environmentVariableList Record<string, string | number>
buildArgList Record<string, string>
buildSSHAgentList object[]
buildSecretsList Record<string, environmentSecret | fileSecret>
buildSecret environmentSecret | fileSecret
environmentSecret object
environment string required

Name of the environment variable to expose as a secret

minLength=1
fileSecret object
path string required

Path to the file to expose as a secret

minLength=1
portMappingList string | object | object[]
volumeMountList string | object | object | object[]
healthCheckOptions object
retries integer

The number of times to perform the health check before considering the container unhealthy

min=0
interval string

The interval between runs of the health check. Accepts values such as 2s (two seconds) or 1m (one minute).

minLength=1
start_period string

The time to wait before failing health checks count against the retry count. The health check is still run during this period, and if the check succeeds, the container is immediately considered healthy. Accepts values such as 2s (two seconds) or 1m (one minute).

minLength=1
timeout string

The time to wait before timing out a single health check command invocation. Accepts values such as 2s (two seconds) or 1m (one minute).

minLength=1
command string

The command to run to check the health of the container. If this command exits with code 0, the container is considered healthy.

minLength=1
runAsCurrentUserOptions object | object
capabilityList string[]
setupCommandsList object[]
configVariablesList Record<string, object>

Definitions for each of the config variables used to configure your tasks and containers

configVariable object

Definition of a single config variable

description string

Human-readable description of the purpose of the variable

minLength=1
default string

Default value of the variable if one is not provided elsewhere

minLength=1
includesList include[]

List of configuration files to include in this project

include string | object | object