Manage Runners Logo
Manage Runners
Documentation menu

manage-runners runner update

Update one runner; product, GitLab host, runner token, concurrency, executor, SSH key or monitoring changes recreate an active runner's VM

Required scopesrunners:read, runners:write
Required flags--id
Changes stateyes
Destructiveno
Paid resource effectrecreate
Confirmationpaid_resource
Non-interactive usesupported

This command may delete and recreate an active runner's VM. Read confirmations before running it non-interactively.

Usage

Update one runner; product, GitLab host, runner token, concurrency, executor, SSH key or monitoring changes recreate an active runner's VM

Usage:
  manage-runners runner update [flags]

Flags:
      --concurrency int            runner concurrency
      --executor string            runner executor
      --gitlab-host string         GitLab host
      --hetzner-token-env string   environment variable containing the Hetzner token
      --id string                  id
      --interval duration          polling interval (default 2s)
      --label stringArray          runner label
      --monitoring string          resource monitoring: on|off; on requires an active paid subscription
      --name string                runner name
      --product-id string          product id
      --profile string             configuration profile
      --runner-token-env string    environment variable containing the runner token
      --ssh-key-id stringArray     SSH key id
      --timeout duration           maximum wait duration (default 10m0s)
      --wait                       wait for a terminal runner state
      --yes                        confirm recreating an active runner's VM; required with --product-id, --gitlab-host, --runner-token-env, --concurrency, --executor, --ssh-key-id or --monitoring

Every command also accepts the global flags. For machine-readable help, run manage-runners help runner update --output json.