cb-ctl

SYNOPSIS

cb-ctl -h | --help
cb-ctl --build-package-local --dist=<name>
    [--clean]
    [--debug]
cb-ctl --build-package=<package> --project-path=<path> --arch=<name> --dist=<name> --runner-group=<name>
    [--debug]
cb-ctl --build-image-local --selection=<name>
    [--debug]
cb-ctl --build-image=<image> --project-path=<path> --arch=<name> --runner-group=<name> --selection=<name>
    [--debug]
cb-ctl --build-dependencies=<package│image> --project-path=<path> --arch=<name> (--dist=<name>|--selection=<name>)
    [--timeout=<time_sec>]
    [--debug]
cb-ctl --build-dependencies-local (--dist=<name>|--selection=<name>)
    [--debug]
cb-ctl --build-log=<package│image> --project-path=<path> --arch=<name> (--dist=<name>|--selection=<name>)
    [--keep-open]
    [--timeout=<time_sec>]
    [--debug]
cb-ctl --build-info=<package│image> --project-path=<path> --arch=<name> (--dist=<name>|--selection=<name>)
    [--timeout=<time_sec>]
    [--debug]
cb-ctl --get-binaries=<package│image> --project-path=<path> --arch=<name> --target-dir=<dir> (--dist=<name>|--selection=<name>)
    [--timeout=<time_sec>]
    [--debug]
cb-ctl --watch
    [--filter-request-id=<uuid>]
    [--filter-service-name=<name>]
    [--timeout=<time_sec>]
    [--debug]

DESCRIPTION

Control plane for accessing the Cloud Builder services.

OPTIONS

--build-package=<package>

Create a request to build the given package. The provided argument is appended to the project-path and forms the directory path to the package in the git repository

projects/
  └── <project-path>/
         └── <package>/...

Please note, the root directory is by convention a fixed name set to ‘projects’

--build-package-local

Build package from local checkout. The package sources will be looked up from the current working directory

--build-image-local

Build image from local checkout. The image sources will be looked up from the current working directory

--build-image=<image>

Create a request to build the given image. The provided image argument is used in the same way as the package argument from –build-package

--project-path=<path>

Project path that points to the package in the git. See the above structure example

--arch=<name>

Target architecture name

--dist=<name>

Target distribution name for package builds

--selection=<name>

Image selection name for image builds

--runner-group=<name>

Send build request to specified runner group

--build-dependencies=<package>

Provide latest build root dependency information

--build-log=<package>

Provide latest raw package build log

--build-info=<package>

Provide latest build result and status information

--get-binaries=<package>

Download latest binary packages

--target-dir=<dir>

Name of target directory for get-binaries download

--watch

Watch response messages of the cloud builder system

--filter-request-id=<uuid>

Filter messages by given request UUID

--filter-service-name=<name>

Filter messages by given service name. Allowed service names are:

  • cb-fetch

  • cb-info

  • cb-run

  • cb-prepare

  • cb-scheduler

  • cb-image

--timeout=<time_sec>

Wait time_sec seconds of inactivity on the message broker before return. Default: 30sec

--clean

Delete package buildroot if present on the runner before building the package

--keep-open

Use tail -f to open the log file on the runner

--debug

Set log level to DEBUG for cloud-builder and kiwi namespaces