Bundle Spec
Which of Link's programs to build from source, for which targets, and how to seal and sign them into one release folder. The bundle spec is TOML, given to a command that reads it as a file, and a field flag sets the field it names, overriding the file. Its JSON Schema is bundle.schema.json.
Use It
Give lnk bundle create a bundle spec as a file, and set any field below with its field flag, which overrides the file. lnk bundle spec show prints the spec as it is read.
Every Option
Every field the reader takes, with an example value.
kind = "bundle"
schema = 1
build = "dev"
file = ["manifest.toml"]
from = ["part-linux"]
out = "dist"
outside = ["outside.toml"]
program = [
"lnk",
"lnk-box",
]
signer = "dev"
source = ["."]
target = ["x86_64-unknown-linux-musl"]
version = "0.14.0"build
Type one of
dev,staging,prod· Flag--build
Its stage, which says what its lnk trusts: dev (the bundle's own
signer and Link's), staging (the staging signer and Link's) or prod
(the bundle's own signer alone, at the workspace's version).
file
Type a list, each text · Flag
--file
A file sealed beside the programs, such as a manifest its installer reads, repeated for more.
from
Type a list, each text · Flag
--from
Parts built before, unsigned, sealed instead of building, repeated for each part.
out
Type text · Flag
--out
Where the bundle goes, ~/.lnk/data/bundles/<name>/<version> when none is
given.
outside
Type a list, each text · Flag
--outside
A TOML file declaring programs Link doesn't build, such as Caddy, repeated for more.
program
Type a list, each text · Flag
--program
A program to build, by its file name, such as lnk-measure or a program
of your own, repeated for more. It's lnk and every module of the first
source when none is given.
signer
Type text · Flag
--signer
Who signs it: link, staging, a signer of your own by name, kept in
~/.lnk/safe/bundles/signers and made on first use, or an
allowed-signers file. Dev and prod require a signer, including unsigned
parts that must embed its trust. Staging may omit it for unsigned parts.
source
Type a list, each text · Flag
--source
A workspace to find programs in, repeated for more. It's this folder when none is given.
target
Type a list, each one of
host,aarch64-apple-darwin,x86_64-apple-darwin,x86_64-unknown-linux-musl,aarch64-unknown-linux-musl· Flag--target
A target to build for, one of Link's release targets, such as
x86_64-unknown-linux-musl, or host for this computer's, repeated for
more. It's host when none is given.
version
Type text · Flag
--spec.version
Its version. It's the workspace's, stamped for staging and dev, when none is given.