caplo secret
Manage workspace secrets that package secrets bind to.
caplo secretA workspace secret holds one value for many packages: each package secret bound to it with caplo tool secret bind receives its value. Rotating it with caplo secret set changes the value for every bound package within a minute. Values are never shown again. Names match [a-z][a-z0-9-]{1,63}.
Examples
caplo secret set orders-api-keycaplo secret usage orders-api-keyCommands
caplo secret delete
Section titled “caplo secret delete”Delete a workspace secret that no package secret binds.
caplo secret delete <name> [flags]Deletes a workspace secret. A secret that package secrets are bound to is not deleted; the command lists the bindings to remove first with caplo tool secret unbind. It asks first; –yes skips the question.
Examples
caplo secret delete orders-api-key --yesFlags
| Flag | Value | Default | Description |
|---|---|---|---|
--yes, -y |
do not ask for confirmation |
caplo secret list
Section titled “caplo secret list”List the workspace secrets and how many package secrets bind each.
caplo secret list [flags]Examples
caplo secret listFlags
| Flag | Value | Default | Description |
|---|---|---|---|
--output, -o |
string | table |
output format: table, json, or yaml |
caplo secret set
Section titled “caplo secret set”Create a workspace secret or rotate its value, from a hidden prompt or from stdin when it is not a terminal.
caplo secret set <name> [flags]Creates a workspace secret, or rotates the value of an existing one for every package secret bound to it. The value comes from a hidden prompt, or from standard input without its final newline when that is not a terminal, and is 1 to 8192 bytes. –description sets what it is for; without it, a rotation keeps the current description.
Examples
caplo secret set orders-api-key --description "Orders API key"printf %s "$ORDERS_API_KEY" | caplo secret set orders-api-keyFlags
| Flag | Value | Default | Description |
|---|---|---|---|
--description |
string | what the secret is for (default: keep the current one) |
caplo secret usage
Section titled “caplo secret usage”List the package secrets bound to a workspace secret.
caplo secret usage <name> [flags]Examples
caplo secret usage orders-api-keyFlags
| Flag | Value | Default | Description |
|---|---|---|---|
--output, -o |
string | table |
output format: table, json, or yaml |