oroc update bundle
Build a tar archive containing the contents of a directory for use as an update artifact.
Usage#
oroc update bundle [--input=<dir>] [--output=<bundle.tar>] [options]
Options#
| Option | Description |
|---|---|
--input=<dir> |
directory whose contents will be archived (default: project directory) |
--output=<bundle.tar> |
path to the tar archive to write (default: <build_name>-<version>.tar) |
--manifest=<path> |
optional manifest path to update with a new target for this bundle |
--manifest-name=<name> |
manifest filename to use when --manifest is not provided |
--channel=<name> |
update channel to associate with this bundle (default: update_channel or "stable") |
--update-id=<id> |
update id to associate with this bundle (default: <channel>-<version>) |
--platform=<id> |
platform identifier for the bundle target (default: "source") |
--arch=<id> |
architecture identifier for the bundle target (default: "any") |
--artifact-url=<url-or-path> |
artifactUrl to record in the manifest target (default: bundle filename) |
--hash-algorithm=<sha256|sha1> |
hash algorithm to use for the bundle payload (default: sha256 when libsodium is available, otherwise sha1) |
--log-file=<path> |
mirror logs to a JSON file |
-h, --help |
show help |
Notes#
The archive is a plain tar file (no compression) built using the runtime's native tar implementation.
Directory layout and basic metadata (mode bits, mtime) are preserved.
When omitted, '--input' defaults to the project directory (app source),
and '--output' defaults to "<build_name>-<version>.tar" derived from your oro.toml metadata.
When '--manifest' or '--manifest-name' (or ORO_UPDATE_MANIFEST_FILENAME) is provided, the manifest is updated with a new target entry describing this bundle (including length and hash).
Examples#
oroc update bundle
bundle the current project source into <build_name>-<version>.tar
oroc update bundle --manifest manifest.json
bundle the project and record the artifact in manifest.json
oroc update bundle --input dist --output app-1.2.3.tar --manifest manifest.json --channel beta
bundle a custom directory and attach it as a beta update in the manifest
Source repository · Edit this page · View Markdown