gritpack bundle

Carry a lock file's packages to another machine in a signed bundle

Generated from gritpack bundle --helpGritpack 1.2.63
gritpack bundle [OPTIONS] <COMMAND>

Commands

export
Write a signed bundle of a lock file's packages, taken from the cache
inspect
Show what a bundle holds, without checking who signed it
verify
Check a bundle completely, signed by keys you trust
import
Check a bundle and copy its packages into the local cache

Options

-h, --helpPrint help

gritpack bundle export

Write a signed bundle of a lock file's packages, taken from the cache

gritpack bundle export [OPTIONS] --output <OUTPUT> --signing-seed <SIGNING_SEED> --actor <ACTOR>

Options

--lock <LOCK>Lock file whose packages go into the bundleDefault: gritpack.lock
--cache-dir <CACHE_DIR>Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache
--output <OUTPUT>Where to write the bundle
--signing-seed <SIGNING_SEED>File with the Ed25519 signing seed: 32 raw bytes or 64 lowercase hex digits
--actor <ACTOR>Person or service making the bundle, recorded in it
--destination-repository <DESTINATION_REPOSITORY>UUID of the repository the bundle is meant for, if known
--evidence <EVIDENCE>A signed package or approval record to carry in the bundle; repeatable
--root <ROOTS>A hub's signed root document, carried for offline checks; repeatable
--lifecycle <LIFECYCLE>A hub's signed lifecycle checkpoint, carried for offline checks; repeatable
--consumer <CONSUMER>A JSON file of your own to carry in the bundle unchanged; repeatable
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help

gritpack bundle inspect

Show what a bundle holds, without checking who signed it

gritpack bundle inspect [OPTIONS] <BUNDLE>

Arguments

<BUNDLE>Bundle file to inspect

Options

--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help

gritpack bundle verify

Check a bundle completely, signed by keys you trust

gritpack bundle verify [OPTIONS] --trusted-key <TRUSTED_KEYS> <BUNDLE>

Arguments

<BUNDLE>Bundle file to check

Options

--trusted-key <TRUSTED_KEYS>File with an Ed25519 public key you trust to sign the bundle; repeatable
--threshold <THRESHOLD>How many of the trusted keys must have signed the bundleDefault: 1
--offlineAccept expired lifecycle checkpoints, reporting them as out of date
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help

gritpack bundle import

Check a bundle and copy its packages into the local cache

gritpack bundle import [OPTIONS] --trusted-key <TRUSTED_KEYS> <BUNDLE>

Arguments

<BUNDLE>Bundle file to check

Options

--trusted-key <TRUSTED_KEYS>File with an Ed25519 public key you trust to sign the bundle; repeatable
--threshold <THRESHOLD>How many of the trusted keys must have signed the bundleDefault: 1
--offlineAccept expired lifecycle checkpoints, reporting them as out of date
--cache-dir <CACHE_DIR>Directory of the shared cache of downloaded package filesEnvironment: GRITPACK_CACHE_DIR · Default: ~/.frogfish/gritpack/cache
--format <FORMAT>Output format: human or jsonDefault: human · Values: human, json
--json[=<FIELDS>]Same as --format json; --json=name,version keeps only those fields
--jq <EXPRESSION>Print the JSON output through a jq expression, strings unquoted
-h, --helpPrint help