no_list | title | linkTitle | weight | description |
---|---|---|---|---|
true |
Reference |
Reference |
4 |
This section contains a reference of configuration options for the Vela worker service.
|
The worker is made up of several components, responsible for specific tasks, necessary for the service to operate:
Name | Description |
---|---|
executor |
coordinates with the runtime to manage workload resources and reports results back to the server |
queue |
integrates with a queue provider for pulling workloads, provided by the server, that will be run |
runtime |
integrates with a runtime environment for executing workload resources |
This section contains a list of all variables that must be provided to the worker.
This configuration variable is used by the queue component for the worker.
Examples using this configuration variable are provided in the above reference documentation.
This variable sets a fully qualified URL to the queue instance for pulling workloads provided by the server.
The variable should be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable should match the VELA_QUEUE_ADDR
variable provided to the server.
{{% /alert %}}
This configuration variable is used by the queue component for the worker.
Examples using this configuration variable are provided in the above reference documentation.
This variable sets the driver to use for the queue functionality for the worker.
The variable should be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable should match the VELA_QUEUE_DRIVER
variable provided to the server.
The possible options to provide for this variable are:
redis
{{% /alert %}}
This variable sets a fully qualified URL to the Vela server address.
The variable should be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable should match the VELA_ADDR
variable provided to the server.
{{% /alert %}}
This variable sets a fully qualified URL to the Vela worker address.
The variable should be provided as a string
.
This section contains a list of all variables that can be provided to the worker.
This variable sets a shared secret for authenticating communication between workers and the server.
Only necessary to provide if utilizing the server-worker trusted symmetric worker authentication method.
The variable should be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable should match the VELA_SECRET
variable provided to the server.
{{% /alert %}}
This variable sets a number to control the maximum amount of builds that are allowed to run concurrently on the worker.
The variable can be provided as an integer
.
{{% alert title="Note:" color="primary" %}}
This variable has a default value of 1
.
{{% /alert %}}
This variable sets the maximum duration of time a build can run for on the worker before being terminated.
The variable can be provided as a duration
(i.e. 5s
, 10m
).
{{% alert title="Note:" color="primary" %}}
This variable has a default value of 30m
.
{{% /alert %}}
This variable sets the maximum duration of time a worker will wait before registering with the Vela server.
The variable can be provided as a duration
(i.e. 5s
, 10m
).
{{% alert title="Note:" color="primary" %}}
This variable has a default value of 15m
.
The value should coordinate with the VELA_WORKER_ACTIVE_INTERVAL
setting provided to the server.
{{% /alert %}}
This configuration variable is used by the executor component for the worker.
Examples using this configuration variable are provided in the above reference documentation.
This variable sets the driver to use for the executor functionality for the worker.
The variable can be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable has a default value of linux
.
The possible options to provide for this variable are:
linux
local
{{% /alert %}}
This configuration variable is used by the executor component for the worker.
This variable sets the maximum number of bytes for logs allowed to be uploaded per step.
The variable can be provided as an integer
.
{{% alert title="Note:" color="primary" %}}
This variable has a default value of 0
. No limit.
{{% /alert %}}
This configuration variable is used by the executor component for the worker.
This variable sets whether or not the executor will verify a repository is trusted
before executing a build that contains privileged images (see runtime privileged images).
The variable can be provided as a boolean
.
{{% alert title="Note:" color="primary" %}}
This variable has a default value of true
.
{{% /alert %}}
This configuration variable is used by the queue component for the worker.
This variable enables the worker to connect to a queue cluster rather than a standalone instance.
The variable can be provided as a boolean
.
{{% alert title="Note:" color="primary" %}}
This variable should match the VELA_QUEUE_CLUSTER
variable provided to the server.
{{% /alert %}}
This configuration variable is used by the queue component for the worker.
This variable sets the maximum duration of time the worker will wait before timing out requests sent for pulling workloads.
The variable can be provided as a duration
(i.e. 5s
, 10m
).
{{% alert title="Note:" color="primary" %}}
This variable has a default value of 60s
.
{{% /alert %}}
This configuration variable is used by the queue component for the worker.
This variable sets the unique channels or topics to pull workloads from.
The variable can be provided as a comma-separated list
(i.e. myRoute1,myRoute2
).
{{% alert title="Note:" color="primary" %}}
This variable has a default value of vela
.
{{% /alert %}}
This configuration variable is used by the runtime component for the worker.
Examples using this configuration variable are provided in the above reference documentation.
This variable sets a fully qualified system path to a configuration file for the worker.
The variable can be provided as a string
.
This configuration variable is used by the runtime component for the worker.
Examples using this configuration variable are provided in the above reference documentation.
This variable sets the driver to use for the runtime functionality for the worker.
The variable can be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable has a default value of docker
.
The possible options to provide for this variable are:
docker
kubernetes
{{% /alert %}}
This configuration variable is used by the runtime component for the worker.
Examples using this configuration variable are provided in the above reference documentation.
This variable sets a namespace (for Kubernetes only) to use for runtime workloads.
The variable can be provided as a string
.
This configuration variable is used by the runtime component for the worker.
Examples using this configuration variable are provided in the kubernetes runtime documentation.
This variable sets a PipelinePodsTemplate
name (for Kubernetes only) to use for runtime workloads.
The named template must be in the VELA_RUNTIME_NAMESPACE
.
The variable can be provided as a string
.
This configuration variable is used by the runtime component for the worker.
This variable sets the path to a PipelinePodsTemplate
YAML file (for Kubernetes only) to use for runtime workloads.
This file is only used if VELA_RUNTIME_PODS_TEMPLATE_NAME
is empty.
An example file is provided in the kubernetes runtime documentation.
This is useful for Kubernetes clusters that do not allow loading CRDs. It is also used for testing Vela.
The variable can be provided as a string
.
This configuration variable is used by the runtime component for the worker.
This variable sets the Docker image(s) that are allowed to have privileged access on the worker.
The variable can be provided as a comma-separated list
(i.e. myImage1,myImage2
).
{{% alert title="Note:" color="primary" %}} Please use with caution. This setting essentially grants any defined image root access to the host machine. {{% /alert %}}
This configuration variable is used by the runtime component for the worker.
This variable leverages the --cap-drop
Docker run flag to disable certain kernel capabilities given to the container by default.
This variable can be provided as a comma-separated list
(e.g. CAP_CHOWN,CAP_DAC_OVERRIDE
). There is some validation in place to ensure accurate capabilities are provided.
This configuration variable is used by the runtime component for the worker.
This variable sets the fully qualified system path(s) to file(s) on the host machine that will be mounted into workloads executed on that worker.
The variable can be provided as a comma-separated list
(i.e. myVolume1,myVolume2
).
This variable sets a fully qualified system path to the TLS certificate used for HTTPS for the worker.
The variable can be provided as a string
.
This variable sets a fully qualified system path to the TLS certificate key used for HTTPS for the worker.
The variable can be provided as a string
.
This variable sets the minimum TLS version that the worker API will accept.
The variable can be provided as a string
.
{{% alert title="Note:" color="primary" %}}
This variable has a default value of 1.2
.
The possible options to provide for this variable are:
1.0
1.1
1.2
1.3
{{% /alert %}}