What Is a Custom Executor?
A custom executor is an extensibility mechanism where the runner calls user-supplied scripts to prepare an environment, run the job, and clean up, instead of using a built-in executor. The scripts can provision any backend the team wants. It is the escape hatch for compute that the standard executors do not support.
Why it matters
When none of the built-in executors fit, a custom executor lets a team wire CI to bespoke infrastructure by implementing a few lifecycle hooks. It offers maximum flexibility at the cost of owning the provisioning logic. It is how unusual hardware or cloud setups get integrated into a runner.
Related guides
What Is a Shell Executor?A shell executor runs CI job commands directly on the host machine's shell, with no container isolation, reus…
What Is an SSH Executor?An SSH executor runs CI job commands on a remote machine by connecting over SSH, using that host's environmen…
What Is an Autoscaling Executor?An autoscaling executor is a runner configuration that provisions fresh compute on demand for each job and te…