Manage Runners
Documentation menu

manage-runners cache update

Update a cache; connection or sharing changes recreate the VMs of active runners that use it

Required scopes runners:read, runners:write
Required flags none
Changes state yes
Destructive no
Paid resource effect recreate
Confirmation paid_resource
Non-interactive use supported

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

Usage

Update a cache; connection or sharing changes recreate the VMs of active runners that use it

Usage:
  manage-runners cache update [flags]

Flags:
      --access-key-id string            S3 access key ID
      --bucket string                   bucket name
      --id string                       cache id
      --insecure[=true|false]           use plain HTTP instead of HTTPS
      --name string                     cache name; resolving it needs runners:read
      --new-name string                 rename the cache
      --path-prefix string              optional object path prefix inside the bucket
      --path-style string               addressing style: auto|path|virtual (default auto for create)
      --profile string                  configuration profile
      --region string                   bucket region, for example fsn1 or eu-central-1
      --secret-key-env string           environment variable containing the S3 secret key
      --secret-key-stdin[=true|false]   read the S3 secret key from stdin
      --server-address string           S3 server host[:port] without scheme, for example fsn1.your-objectstorage.com
      --shared string                   share the cache between runners: on|off (default on for create)
      --yes[=true|false]                confirm recreating the VMs of active runners that use the cache; required when the connection or sharing changes

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