CLI command

skarbiec bindings list

Keep, on this host, the list of bindings files programs are run with, so a rename rebinds every one of them and doctor finds the line that would break before a deploy does — without anyone remembering where each project keeps its file.

Invocation#

Shell
skarbiec bindings list
skarbiec bindings remember <file>
skarbiec bindings forget <file>

Purpose#

Keep, on this host, the list of bindings files programs are run with, so a rename rebinds every one of them and doctor finds the line that would break before a deploy does — without anyone remembering where each project keeps its file.

Required inputs and options#

  • list takes nothing. remember and forget take one bindings file, relative to the working directory. tool import and env import --bindings remember the file they write themselves. POST /v1/operator/bindings/list, /v1/operator/bindings/remember and /v1/operator/bindings/forget take the same, file an absolute path; they act on the machine the backend runs on.

Output and state effects#

  • The list lives beside the vault file in <vault file>.bindings.json and names files, never a value. list prints ok, the store and each file with the number of bindings, ok and the failing lines as bindings check names them — or, for a file that cannot be read, the error. remember adds a file once and says whether it was new, journalling bindings-remembered; forget drops it, journalling bindings-forgotten. rename rewrites each NAME=<old id>:<field> line of every known file to the new id and answers them under bindings_files, and doctor's bindings_files check fails naming each failing line or unreadable file.

Refusals#

  • A flag other than --refuse exits 2 (arguments-flag-unknown). Anything else exits 2 with the usage. remember refuses a file that cannot be read or binds nothing, as exec --env-from would, so a typo is not remembered; forget refuses a file the host does not know of, pointing at bindings list.

Examples#

skarbiec bindings list skarbiec bindings remember deploy/bindings skarbiec bindings forget old-project/.skarbiec-env