drpcli contents¶
drpcli contents¶
Manage DRP content packs (bundles of bootenvs, templates, tasks, and more)
Synopsis¶
Commands for creating, uploading, downloading, and managing DRP content packs.
Content packs are versioned bundles that group DRP objects (bootenvs, templates, tasks, workflows, profiles, etc.) for distribution and deployment. They are the primary mechanism for distributing reusable DRP configuration.
list— show all installed content packsshow [id]— retrieve a specific content pack's full definitioncreate [json]— upload a new content pack from JSONupdate [id] [json]— replace an existing content packupload [file]— upload or replace a content pack from a filedestroy [id]— remove a content pack from the endpointbundle [file]— bundle the current directory into a content pack fileunbundle [file]— expand a content pack file into directory structurebundlize [file]— capture specific live objects into a content pack fileconvert [file]— load content pack objects as read-write objectsdocument [file]— generate RST documentation from a content packwatch— watch the current directory and auto-bundle/upload on changesdeps— analyze dependency relationships across all catalog content packs
Examples¶
# List all installed content packs
drpcli contents list
# Upload a content pack from a file
drpcli contents upload my-content.yaml
# Bundle the current directory into a JSON content pack
drpcli contents bundle content.json Name=my-content Version=v1.0.0
# Expand a content pack into the current directory
drpcli contents unbundle my-content.yaml
Options¶
Options inherited from parent commands¶
--ca-cert string CA certificate used to verify the server certs (with the system set)
-c, --catalog string The catalog file to use to get product information (default "https://repo.rackn.io")
--catalog-path string The path to where the catalog file exists on the drp server. By default and historically this has been /files/rebar-catalog. For example, if no catalog urls are provided, the complete path will be https://drp-ip:8090/files/rebar-catalog (default "/files/rebar-catalog")
-S, --catalog-source string A location from which catalog items can be downloaded. For example, in airgapped mode it would be the local catalog
--client-cert string Client certificate to use for communicating to the server - replaces RS_KEY, RS_TOKEN, RS_USERNAME, RS_PASSWORD
--client-key string Client key to use for communicating to the server - replaces RS_KEY, RS_TOKEN, RS_USERNAME, RS_PASSWORD
-C, --colors string The colors for JSON and Table/Text colorization. 8 values in the for 0=val,val;1=val,val2... (default "0=32;1=33;2=36;3=90;4=34,1;5=35;6=95;7=32;8=92")
-d, --debug Whether the CLI should run in debug mode
-D, --download-proxy string HTTP Proxy to use for downloading catalog and content
-E, --endpoint string The Digital Rebar Provision API endpoint to talk to (default "https://127.0.0.1:8092")
-X, --exit-early Cause drpcli to exit if a command results in an object that has errors
--fetch-catalogs all Determines which catalog urls to use to fetch the catalog. If set to all, all the catalog urls defined with catalog_url and catalog_urls as well as the default catalog will be used. If set to server, only the catalog urls defined on the server will be used. If set to cli, then the specific url specified with the -c flag will be used. It defaults to `all`. Allowed values `all, `server`, `cli`. (default "all")
-f, --force When needed, attempt to force the operation - used on some update/patch calls
--force-new-session Should the client always create a new session
-F, --format string The serialization we expect for output. Can be "json" or "yaml" or "text" or "table" (default "json")
--http-request-retry-count int Specifies the number of retries for downloads in case of failure
--http-request-retry-delay-max int Specifies the maximum delay (in seconds) between HTTP/HTTPS retry attempts (default 60)
--ignore-unix-proxy Should the client ignore unix proxies
-N, --no-color Whether the CLI should output colorized strings
-H, --no-header Should header be shown in "text" or "table" mode
-x, --no-token Do not use token auth or token cache
-P, --password string password of the Digital Rebar Provision user (default "r0cketsk8ts")
-p, --platform string Platform to filter details by. Defaults to current system. Format: arch/os
-J, --print-fields string The fields of the object to display in "text" or "table" mode. Comma separated
-r, --ref string A reference object for update commands that can be a file name, yaml, or json blob
--server-verify Should the client verify the server cert
-G, --show-global-help-flags Show global flags in help message
-T, --token string token of the Digital Rebar Provision access
-t, --trace string The log level API requests should be logged at on the server side
-Z, --trace-token string A token that individual traced requests should report in the server logs
-j, --truncate-length int Truncate columns at this length (default 40)
-u, --url-proxy string URL Proxy for passing actions through another DRP
-U, --username string Name of the Digital Rebar Provision user to talk to (default "rocketskates")
SEE ALSO¶
- drpcli - A CLI application for interacting with the DigitalRebar Provision API
- drpcli contents bundle - Bundle the current directory into a content pack
[file] - drpcli contents bundlize - Capture specific live DRP objects from the endpoint into a content pack
[file] - drpcli contents convert - Load content pack
[file]objects into DRP as individual read-write objects - drpcli contents create - Upload a new content pack to the endpoint from a JSON definition
- drpcli contents deps - Download and analyze cross-references across all catalog content packs
- drpcli contents destroy - Remove the content pack
[id]from the endpoint - drpcli contents document - Generate RST documentation from a content pack
[file] - drpcli contents document-md - Generate Markdown documentation from content pack
[file]into[dir] - drpcli contents exists - Check whether content pack
[id]exists on the endpoint - drpcli contents list - List all installed content packs on the endpoint
- drpcli contents show - Show the full definition of the content pack
[id] - drpcli contents unbundle - Expand a content pack
[file]into a directory structure - drpcli contents update - Replace an existing content pack
[id]with a new definition - drpcli contents upload - Upload or replace a content pack on the endpoint from a file
- drpcli contents watch - Watch the current directory for changes and automatically
bundleandupload