diff --git a/docs/content/cli.md b/docs/content/cli.md index 1363d713b6..0f2aecf866 100755 --- a/docs/content/cli.md +++ b/docs/content/cli.md @@ -776,6 +776,18 @@ File paths can be specified as URLs to resolve ambiguity in paths containing col $ opa run file:///c:/path/to/data.json +URL paths to remote public bundles (http or https) will be parsed as shorthand +configuration equivalent of using repeated --set flags to accomplish the same: + + $ opa run -s https://example.com/bundles/bundle.tar.gz + +The above shorthand command is identical to: + + $ opa run -s --set "services.cli1.url=https://example.com" \ + --set "bundles.cli1.service=cli1" \ + --set "bundles.cli1.resource=/bundles/bundle.tar.gz" \ + --set "bundles.cli1.persist=true" + The 'run' command can also verify the signature of a signed bundle. A signed bundle is a normal OPA bundle that includes a file named ".signatures.json". For more information on signed bundles