Main program execution
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|
Display the changes for each of the blueprints
Parameters: |
---|
blueprints changes <blueprint,...> Display the changes for each blueprint.
Process blueprints commands
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|---|
Returns: | Value to return from sys.exit() |
Return type: | int |
This dispatches the blueprints commands to a function
Delete a blueprint from the server
Parameters: |
---|
delete <blueprint> Delete a blueprint from the server
Display the packages needed to install the blueprint
Parameters: |
---|
blueprints depsolve <blueprint,...> Display the packages needed to install the blueprint.
Display the differences between 2 versions of a blueprint
Parameters: |
---|
Handle the blueprints freeze commands
Parameters: |
---|
blueprints freeze <blueprint,...> Display the frozen blueprint’s modules and packages. blueprints freeze show <blueprint,...> Display the frozen blueprint in TOML format. blueprints freeze save <blueprint,...> Save the frozen blueprint to a file, <blueprint-name>.frozen.toml.
Save the frozen blueprint to a TOML file
Parameters: |
---|
blueprints freeze save <blueprint,...> Save the frozen blueprint to a file, <blueprint-name>.frozen.toml.
Show the frozen blueprint in TOML format
Parameters: |
---|
blueprints freeze show <blueprint,...> Display the frozen blueprint in TOML format.
Output the list of available blueprints
Parameters: |
---|
blueprints list
Push a blueprint TOML file to the server, updating the blueprint
Parameters: |
---|
push <blueprint> Push a blueprint TOML file to the server.
Save the blueprint to a TOML file
Parameters: |
---|
blueprints save <blueprint,...> Save the blueprint to a file, <blueprint-name>.toml
Show the blueprints, in TOML format
Parameters: |
---|
blueprints show <blueprint,...> Display the blueprint in TOML format.
Multiple blueprints will be separated by
Tag the most recent blueprint commit as a release
Parameters: |
---|
blueprints tag <blueprint> Tag the most recent blueprint commit as a release.
Undo changes to a blueprint
Parameters: |
---|
blueprints undo <blueprint> <commit> Undo changes to a blueprint by reverting to the selected commit.
Push the blueprint TOML to the temporary workspace storage
Parameters: |
---|
blueprints workspace <blueprint> Push the blueprint TOML to the temporary workspace storage.
Cancel a running compose
Parameters: |
|
---|
compose cancel <uuid>
This will cancel a running compose. It does nothing if the compose has finished.
Process compose commands
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|---|
Returns: | Value to return from sys.exit() |
Return type: | int |
This dispatches the compose commands to a function
Delete a finished compose’s results
Parameters: |
|
---|
compose delete <uuid,...>
Delete the listed compose results. It will only delete results for composes that have finished or failed, not a running compose.
Return detailed information about the compose
Parameters: |
|
---|
compose details <uuid>
This returns information about the compose, including the blueprint and the dependencies.
Download the compose’s output image
Parameters: |
|
---|
compose image <uuid>
This downloads only the result image, saving it as the image name, which depends on the type of compose that was selected.
Return a simple list of compose identifiers
Show the last part of the compose log
Parameters: |
|
---|
compose log <uuid> [<size>kB]
This will display the last 1kB of the compose’s log file. Can be used to follow progress during the build.
Download a tar of the compose’s logs
Parameters: |
|
---|
compose logs <uuid>
Saves the logs as uuid-logs.tar
Download a tar file of the compose’s metadata
Parameters: |
|
---|
compose metadata <uuid>
Saves the metadata as uuid-metadata.tar
Download a tar file of the compose’s results
Parameters: |
|
---|
compose results <uuid>
The results includes the metadata, output image, and logs. It is saved as uuid.tar
Start a new compose using the selected blueprint and type
Parameters: |
|
---|
compose start <blueprint-name> <compose-type>
Return the status of all known composes
Parameters: |
|
---|
This doesn’t map directly to an API command, it combines the results from queue, finished, and failed so raw JSON output is not available.
Return information about the supported compose types
Parameters: |
|
---|
Add additional details to types that are known to composer-cli. Raw JSON output does not include this extra information.
Process modules commands
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|---|
Returns: | Value to return from sys.exit() |
Return type: | int |
Process projects commands
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|---|
Returns: | Value to return from sys.exit() |
Return type: | int |
Output info on a list of projects
Parameters: |
---|
projects info <project,...>
Add or change a source
Parameters: |
---|
sources add <source.toml>
Process sources commands
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|---|
Returns: | Value to return from sys.exit() |
Return type: | int |
Delete a source
Parameters: |
---|
sources delete <source-name>
Output info on a list of projects
Parameters: |
---|
sources info <source-name>
Process status commands
Parameters: | opts (argparse.Namespace) – Cmdline arguments |
---|---|
Returns: | Value to return from sys.exit() |
Return type: | int |
Take a list of human args and return a list with each item
Parameters: | args (list of str) – list of strings with possible commas and spaces |
---|---|
Returns: | List of all the items |
Return type: | list of str |
Examples:
[“one,two”, “three”, ”,four”, ”,five,”] returns [“one”, “two”, “three”, “four”, “five”]
Convert a blueprint name into a filename.toml
Parameters: | blueprint_name (str) – The blueprint’s name |
---|---|
Returns: | The blueprint name with ‘ ‘ converted to - and .toml appended |
Return type: | str |
Log any errors, return the correct value
Parameters: | result (dict) – JSON result from the http query |
---|---|
Return type: | tuple |
Returns: | (rc, should_exit_now) |
Return the correct rc for the program (0 or 1), and whether or not to continue processing the results.