mini-buildd-api - Run API calls against a mini-buildd instance
usage: mini-buildd-api [-h] [--version]
- [-l {CRITICAL,ERROR,WARNING,INFO,DEBUG}] [-v] [-q] [-J]
- [--auto-confirm] [--auto-save-passwords] [--script-mode] <call>
[options] ...
Run API calls against a mini-buildd instance
- -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)
- --script-mode
- force not to be interactive (default: False)
- <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``)