Provided by: mini-buildd-utils_2.0.6_all
NAME
mini-buildd-api - Run API calls against a mini-buildd instance
DESCRIPTION
usage: mini-buildd-api [-h] [--version] [-l {CRITICAL,ERROR,WARNING,INFO,DEBUG}] [-v] [-q] [-J] [--auto-confirm] [--auto-save-passwords] <call> [options] ... Run API calls against a mini-buildd instance options: -h, --help show this help message and exit --version show program's version number and exit -l {CRITICAL,ERROR,WARNING,INFO,DEBUG}, --log-level {CRITICAL,ERROR,WARNING,INFO,DEBUG} set log level (DEBUG will enable exception tracebacks and python warnings) (default: INFO) -v, --verbose DEPRECATED (use --log-level): increase log level. Give twice for max logs (default: 0) -q, --quiet DEPRECATED (use --log-level): decrease log level. Give twice for min logs (default: 0) -J, --json use parsable json output (default: False) --auto-confirm force-bypass extra confirmation (for confirmable calls) (default: False) --auto-save-passwords don't ask before saving passwords (via python3-keyring) (default: False) API calls (run 'mini-buildd-api <call> --help' for full single call help): <call> [options] status Get status of this instance JSON result description: { "version": mini-buildd's version "identity": Instance identity "url": Instance URL (HTTP) "incoming_url": Incoming URL (currently FTP) "load": Instance's (0 =< load <= 1). If negative, the instance is stopped "chroots": List of active chroots "remotes": Active or auto-reactivatable remotes ["repositories": Simplified structural representation of all repositories] } Authorization: NONE . pub_key Get public key Get ASCII-armored GnuPG public key of this instance. Used to sign the apt repositories (apt key) and for authorization across instances. Authorization: NONE . dput_conf Get recommended dput config snippet Usually, this is for integration in your personal ``~/.dput.cf``. Authorization: NONE . sources_list Get sources.list (apt lines) Usually, this output is put to a file like ``/etc/apt/sources.list.d/mini-buildd-xyz.list``. Authorization: NONE . ls List source package Authorization: NONE . show Show source package Authorization: NONE . debdiff Compare two internal source packages Authorization: NONE . migrate Migrate source package Migrates a source package along with all its binary packages. If run for a rollback distribution, this will perform a rollback restore. Authorization: STAFF . remove Remove source package Removes a source package along with all its binary packages. Authorization: ADMIN . port Port internal source package An internal 'port' is a no-changes (i.e., only the changelog will be adapted) rebuild of the given locally-installed package. When ``from_distribution`` equals ``to_distribution``, a rebuild will be done. Authorization: STAFF . port_ext Port external source package An external 'port' is a no-changes (i.e., only the changelog will be adapted) rebuild of any given source package. Authorization: STAFF . retry Retry a previously failed source package JSON result description: Changes file name that has been re-uploaded Authorization: STAFF . cancel Cancel an ongoing package build Authorization: STAFF . set_user_key Set a user's GnuPG public key Authorization: LOGIN . subscribe Subscribe to (email) notifications Authorization: LOGIN . unsubscribe Unsubscribe from (email) notifications Authorization: LOGIN . remake_chroots Remake chroots Run actions 'remove', 'prepare', 'check' and 'activate'. Note that Daemon will be stopped before running, cancelling ongoing events (``BUILDING``, ``PACKAGING``). Authorization: ADMIN . start Start Daemon (accept incoming) Does nothing if already started; will fail if Daemon instance is not activated. Authorization: ADMIN . stop Stop Daemon (stop accepting incoming) Does nothing if already stopped. Any possibly running builds will be cancelled. This state is *not persisted*. Please *deactivate* the Daemon instance via :mbdpage:`setup` to persist over *mini-buildd service* restarts. Authorization: ADMIN . wake Wake a remote instance Authorization: STAFF . handshake Check if signed message matches a remote, reply our signed message on success This is for internal use only. Authorization: NONE . cronjob Run a cron job now (out of schedule) Authorization: ADMIN . uploaders Get upload permissions for repositories Authorization: ADMIN . snapshot_ls Get list of repository snapshots for a distribution Authorization: NONE . snapshot_create Create a repository snapshot Authorization: ADMIN . snapshot_delete Delete a repository snapshot Authorization: ADMIN . debmirror Make local partial repository mirror via :debpkg:`debmirror` This may be useful if you plan on publishing a stripped-down (f.e., only certain repos, only ``stable``, omit rollbacks) variant of your repo somewhere remote. .. error:: debmirror: ``apt update`` fails on ``experimental`` suites (contents not mirrored) (:debbug:`819925`) This happens only on systems where APT is configured to download contents, most likely just because ``apt-file`` is installed. So, the easiest workaround is:: apt purge apt-file Closest to an actual fix is to install debmirror variant '+abfixes' from ``Hellfield Archive``, where the "bug" has been fixed (June 2023: at least available for bullseye and bookworm). Authorization: ADMIN . keyring_packages Build keyring packages .. note:: **keyring-packages**: No compat for urold (``apt-key add``) Since ``2.x``, keyring packages will use ``/etc/apt/trusted.gpg.d/<foo>.gpg``, not deprecated ``apt-key add <foo>``. In Debian, this is supported since ``wheezy (2013)``. For distributions ``<= squeeze`` (apt versions ``~<= 0.8.x``), you would manually have to run ``apt-key add /etc/apt/trusted.gpg.d/<foo>.gpg`` after installation of the keyring package. Authorization: ADMIN . test_packages Build test packages Authorization: ADMIN . setup Create, update or inspect your setup Note that Daemon will be stopped before running, cancelling ongoing events (``BUILDING``, ``PACKAGING``). Authorization: ADMIN . Note: Uses ``python3-keyring`` to persist passwords (see ``man 1 keyring``)