Skip to main content

Update

Command

$ vela update worker <parameters...> <arguments...>
tip

For more information, you can run vela update worker --help.

Parameters

The following parameters are used to configure the command:

NameDescriptionEnvironment Variables
worker.addressaddress of the workerVELA_WORKER_ADDRESS, WORKER_ADDRESS
worker.hostnamehostname of the workerVELA_WORKER_HOSTNAME, WORKER_HOSTNAME
activecurrent status of the worker (unused)VELA_WORKER_ACTIVE, WORKER_ACTIVE
build-limitbuild limit for the worker (ignored)VELA_WORKER_BUILD_LIMIT, WORKER_BUILD_LIMIT
routesroute assignment for the worker (unused)VELA_WORKER_ROUTES, WORKER_ROUTES
outputformat the output for the workerVELA_OUTPUT, WORKER_OUTPUT
tip

This command also supports setting the following parameters via a configuration file:

  • output

For more information, please review the CLI config documentation.

Permissions

Vela Platform Admin

Sample

warning

This section assumes you have already installed and setup the CLI.

To install the CLI, please review the installation documentation.

To setup the CLI, please review the authentication documentation.

Request

$ vela update worker --worker.hostname MyWorker --worker.address newaddress.example.com

Response

{
ID: 1,
Hostname: MyWorker,
Address: newaddress.example.com,
Routes: [vela],
Active: true,
Status: busy,
LastStatusUpdateAt: 1681486769,
RunningBuildIDs: [123],
LastBuildStartedAt: 1681486769,
LastBuildFinishedAt: 1681486769,
LastCheckedIn: 1681486769,
BuildLimit: 1,
}