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.