Skip to content

Latest commit

 

History

History
75 lines (63 loc) · 6.51 KB

cosa.md

File metadata and controls

75 lines (63 loc) · 6.51 KB
has_children nav_order
true
5

CoreOS Assembler Command Line Reference

This is a short reference of cosa sub-commands available in a CoreOS Assembler container. See each commands --help output for more details about supported arguments.

Main commands

Name Description
build Build OSTree and image base artifacts from previously fetched packages
clean Delete all build artifacts
fetch Fetch and import the latest packages
init Setup the current working directory for CoreOS Assembler and clone the given project URL as Git config
kola Run tests with kola
list List builds available locally
run Run a CoreOS instance in QEMU with access to a root shell
shell Get an interactive shell or run a command in a CoreOS Assembler container
virt-install "Install" a CoreOS system with libvirt

The following commands only do a partial rebuild to make it faster to develop on a specific part of the OS. Make sure to use the one corresponding to the part that you are working on or you will not benefit from them (i.e. they will not produce an image with your changes):

Name Description
build-fast Creates a new QCOW2 image from an existing build and updates the ostree commit with local overrides. This will only change files located in the final root (i.e. part of an ostree commit).
buildinitramfs-fast Create a new QCOW2 image from an existing build and updates the initramfs with local overrides. This will not re-run dracut to rebuild the initramfs.

buildextend commands

By default, the build command will build an OSTree and a QEMU image as base artifacts. Those commands extend those artifacts to make them functional on other platforms or cloud providers:

Name Description
buildextend-live Generate the Live ISO
buildextend-{dasd,metal,metal4k,qemu} Generate artifacts for the given platforms
buildextend-{aliyun,aws,azure,digitalocean,exoscale,gcp,vultr} Generate artifacts for the given platforms
buildextend-{azurestack,ibmcloud,openstack,vmware} Generate artifacts for the given platforms
{aliyun,aws}-replicate Replicate images on the platforms (AMIs for AWS)

Misc commands

Those less commonly used commands are listed here:

Name Description
basearch Convenient wrapper for getting the base architecture
build-validate Validate the checksum of a given build
buildfetch Fetches the bare minimum from external servers to create the next build
buildupload Upload a build which later can be partially re-downloaded with cmd-buildfetch
compress Compresses all images in a build
dev-overlay Add content on top of a commit, handling SELinux labeling etc.
dev-synthesize-osupdate Synthesize an OS update by modifying ELF files in a "benign" way (adding an ELF note)
dev-synthesize-osupdatecontainer Wrapper for dev-synthesize-osupdate that operates on an oscontainer for OpenShift
koji-upload Performs the required steps to make COSA a Koji Content Generator
meta Helper for interacting with a builds meta.json
oc-adm-release Publish an oscontainer as the machine-os-content in an OpenShift release series
offline-update Given a disk image and a coreos-assembler build, use supermin to update the disk image to the target OSTree commit "offline"
prune This script removes previous builds. DO NOT USE on production pipelines
remote-prune Removes unreferenced builds from s3 bucket
runc Spawn the current build as a container
sign Implements signing with RoboSignatory via fedora-messaging
supermin-shell Get a supermin shell
tag Operate on the tags in builds.json
test-coreos-installer Automate an end-to-end run of coreos-installer with the metal image
upload-oscontainer Upload an oscontainer (historical wrapper for cosa oscontainer)