Manage Runners Logo
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 scopesrunners:read, runners:write
Required flagsnone
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 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                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        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                     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.