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
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, --help | Print 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, --help | Print 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 |
--offline | Accept 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, --help | Print 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 |
--offline | Accept 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, --help | Print help |