d9b282150e
Add manpage creation to make docs target to keep them updated.
(cherry picked from commit 7500a17f27)
254 lines
6.9 KiB
Groff
254 lines
6.9 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "COMPOSER-CLI" "1" "Oct 24, 2018" "30.5" "Lorax"
|
|
.SH NAME
|
|
composer-cli \- Composer Cmdline Utility Documentation
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.INDENT 0.0
|
|
.TP
|
|
.B Authors
|
|
Brian C. Lane <\fI\%bcl@redhat.com\fP>
|
|
.UNINDENT
|
|
.sp
|
|
\fBcomposer\-cli\fP is used to interact with the \fBlorax\-composer\fP API server, managing blueprints, exploring available packages, and building new images.
|
|
.sp
|
|
It requires \fI\%lorax\-composer\fP to be installed on the
|
|
local system, and the user running it needs to be a member of the \fBweldr\fP
|
|
group. They do not need to be root, but all of the \fI\%security precautions\fP apply.
|
|
.SH COMPOSER-CLI CMDLINE ARGUMENTS
|
|
.sp
|
|
Lorax Composer commandline tool
|
|
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
usage: composer\-cli [\-h] [\-j] [\-s SOCKET] [\-\-log LOG] [\-a APIVER]
|
|
[\-\-test TESTMODE] [\-V]
|
|
...
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SS Positional Arguments
|
|
.INDENT 0.0
|
|
.TP
|
|
.Bargs
|
|
.UNINDENT
|
|
.SS Named Arguments
|
|
.INDENT 0.0
|
|
.TP
|
|
.B\-j, \-\-json
|
|
Output the raw JSON response instead of the normal output.
|
|
.sp
|
|
Default: False
|
|
.TP
|
|
.B\-s, \-\-socket
|
|
Path to the socket file to listen on
|
|
.sp
|
|
Default: "/run/weldr/api.socket"
|
|
.TP
|
|
.B\-\-log
|
|
Path to logfile (./composer\-cli.log)
|
|
.TP
|
|
.B\-a, \-\-api
|
|
API Version to use
|
|
.sp
|
|
Default: "0"
|
|
.TP
|
|
.B\-\-test
|
|
Pass test mode to compose. 1=Mock compose with fail. 2=Mock compose with finished.
|
|
.sp
|
|
Default: 0
|
|
.TP
|
|
.B\-V
|
|
show program\(aqs version number and exit
|
|
.sp
|
|
Default: False
|
|
.UNINDENT
|
|
.sp
|
|
.INDENT 0.0
|
|
.TP
|
|
.B compose start <BLUEPRINT> <TYPE>
|
|
Start a compose using the selected blueprint and output type.
|
|
.TP
|
|
.B compose types
|
|
List the supported output types.
|
|
.TP
|
|
.B compose status
|
|
List the status of all running and finished composes.
|
|
.TP
|
|
.B compose list [waiting|running|finished|failed]
|
|
List basic information about composes.
|
|
.TP
|
|
.B compose log <UUID> [<SIZE>]
|
|
Show the last SIZE kB of the compose log.
|
|
.TP
|
|
.B compose cancel <UUID>
|
|
Cancel a running compose and delete any intermediate results.
|
|
.TP
|
|
.B compose delete <UUID,...>
|
|
Delete the listed compose results.
|
|
.TP
|
|
.B compose info <UUID>
|
|
Show detailed information on the compose.
|
|
.TP
|
|
.B compose metadata <UUID>
|
|
Download the metadata use to create the compose to <uuid>\-metadata.tar
|
|
.TP
|
|
.B compose logs <UUID>
|
|
Download the compose logs to <uuid>\-logs.tar
|
|
.TP
|
|
.B compose results <UUID>
|
|
Download all of the compose results; metadata, logs, and image to <uuid>.tar
|
|
.TP
|
|
.B compose image <UUID>
|
|
Download the output image from the compose. Filename depends on the type.
|
|
.TP
|
|
.B blueprints list
|
|
List the names of the available blueprints.
|
|
.TP
|
|
.B blueprints show <BLUEPRINT,...>
|
|
Display the blueprint in TOML format.
|
|
.TP
|
|
.B blueprints changes <BLUEPRINT,...>
|
|
Display the changes for each blueprint.
|
|
.TP
|
|
.B blueprints diff <BLUEPRINT> <FROM\-COMMIT> <TO\-COMMIT>
|
|
Display the differences between 2 versions of a blueprint.
|
|
FROM\-COMMIT can be a commit hash or NEWEST
|
|
TO\-COMMIT can be a commit hash, NEWEST, or WORKSPACE
|
|
.TP
|
|
.B blueprints save <BLUEPRINT,...>
|
|
Save the blueprint to a file, <BLUEPRINT>.toml
|
|
.TP
|
|
.B blueprints delete <BLUEPRINT>
|
|
Delete a blueprint from the server
|
|
.TP
|
|
.B blueprints depsolve <BLUEPRINT,...>
|
|
Display the packages needed to install the blueprint.
|
|
.TP
|
|
.B blueprints push <BLUEPRINT>
|
|
Push a blueprint TOML file to the server.
|
|
.TP
|
|
.B blueprints freeze <BLUEPRINT,...>
|
|
Display the frozen blueprint\(aqs modules and packages.
|
|
.TP
|
|
.B blueprints freeze show <BLUEPRINT,...>
|
|
Display the frozen blueprint in TOML format.
|
|
.TP
|
|
.B blueprints freeze save <BLUEPRINT,...>
|
|
Save the frozen blueprint to a file, <blueprint\-name>.frozen.toml.
|
|
.TP
|
|
.B blueprints tag <BLUEPRINT>
|
|
Tag the most recent blueprint commit as a release.
|
|
.TP
|
|
.B blueprints undo <BLUEPRINT> <COMMIT>
|
|
Undo changes to a blueprint by reverting to the selected commit.
|
|
.TP
|
|
.B blueprints workspace <BLUEPRINT>
|
|
Push the blueprint TOML to the temporary workspace storage.
|
|
.TP
|
|
.B modules list
|
|
List the available modules.
|
|
.TP
|
|
.B projects list
|
|
List the available projects.
|
|
.TP
|
|
.B projects info <PROJECT,...>
|
|
Show details about the listed projects.
|
|
.TP
|
|
.B sources list
|
|
List the available sources
|
|
.TP
|
|
.B sources info <SOURCE\-NAME,...>
|
|
Details about the source.
|
|
.TP
|
|
.B sources add <SOURCE.TOML>
|
|
Add a package source to the server.
|
|
.TP
|
|
.B sources change <SOURCE.TOML>
|
|
Change an existing source
|
|
.TP
|
|
.B sources delete <SOURCE\-NAME>
|
|
Delete a package source.
|
|
.UNINDENT
|
|
.sp
|
|
status show Show API server status.
|
|
|
|
.SH EDIT A BLUEPRINT
|
|
.sp
|
|
Start out by listing the available blueprints using \fBcomposer\-cli blueprints
|
|
list\fP, pick one and save it to the local directory by running \fBcomposer\-cli
|
|
blueprints save http\-server\fP\&. If there are no blueprints available you can
|
|
copy one of the examples \fI\%from the test suite\fP\&.
|
|
.sp
|
|
Edit the file (it will be saved with a .toml extension) and change the
|
|
description, add a package or module to it. Send it back to the server by
|
|
running \fBcomposer\-cli blueprints push http\-server.toml\fP\&. You can verify that it was
|
|
saved by viewing the changelog \- \fBcomposer\-cli blueprints changes http\-server\fP\&.
|
|
.SH BUILD AN IMAGE
|
|
.sp
|
|
Build a \fBqcow2\fP disk image from this blueprint by running \fBcomposer\-cli
|
|
compose start http\-server qcow2\fP\&. It will print a UUID that you can use to
|
|
keep track of the build. You can also cancel the build if needed.
|
|
.sp
|
|
The available types of images is displayed by \fBcomposer\-cli compose types\fP\&.
|
|
Currently this consists of: ami, ext4\-filesystem, live\-iso, partitioned\-disk,
|
|
qcow2, tar, vhd, vmdk
|
|
.SH MONITOR THE BUILD STATUS
|
|
.sp
|
|
Monitor it using \fBcomposer\-cli compose status\fP, which will show the status of
|
|
all the builds on the system. You can view the end of the anaconda build logs
|
|
once it is in the \fBRUNNING\fP state using \fBcomposer\-cli compose log UUID\fP
|
|
where UUID is the UUID returned by the start command.
|
|
.sp
|
|
Once the build is in the \fBFINISHED\fP state you can download the image.
|
|
.SH DOWNLOAD THE IMAGE
|
|
.sp
|
|
Downloading the final image is done with \fBcomposer\-cli compose image UUID\fP and it will
|
|
save the qcow2 image as \fBUUID\-disk.qcow2\fP which you can then use to boot a VM like this:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
qemu\-kvm \-\-name test\-image \-m 1024 \-hda ./UUID\-disk.qcow2
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH AUTHOR
|
|
Weldr Team
|
|
.SH COPYRIGHT
|
|
2018, Red Hat, Inc.
|
|
.\" Generated by docutils manpage writer.
|
|
.
|