diff options
author | Karen Arutyunov <karen@codesynthesis.com> | 2018-08-23 22:29:35 +0300 |
---|---|---|
committer | Karen Arutyunov <karen@codesynthesis.com> | 2018-08-28 21:46:41 +0300 |
commit | 8a094bb0481a9c53646cc15db2e8acecafc3d10c (patch) | |
tree | 4fd7012b6a26eb852d42fba8b52bfcf8f1cf2fdd /doc/manual.cli | |
parent | 7e0e141273032c7afc1a9129512aa42c672fcf5d (diff) |
Add basic support for CI request handling
Diffstat (limited to 'doc/manual.cli')
-rw-r--r-- | doc/manual.cli | 26 |
1 files changed, 14 insertions, 12 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index 322c414..4c10689 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -190,12 +190,14 @@ message: <string> The CI functionality allows submission of package CI requests as well as additional, repository-specific information via the HTTP \c{GET} and \c{POST} -methods. The implementation in \c{brep} only handles reception as well as -basic parameter verification expecting the rest of the CI logic to be handled -by a separate entity according to the repository policy. Such an entity can be -notified by \c{brep} about a new CI request as an invocation of the \i{handler -program} (as part of the HTTP request) and/or via email. It could also be a -separate process that monitors the CI data directory. +methods using the \c{application/x-www-form-urlencoded} or +\c{multipart/form-data} parameters encoding. The implementation in \c{brep} +only handles reception as well as basic parameter verification expecting the +rest of the CI logic to be handled by a separate entity according to the +repository policy. Such an entity can be notified by \c{brep} about a new CI +request as an invocation of the \i{handler program} (as part of the HTTP +request) and/or via email. It could also be a separate process that monitors +the CI data directory. The CI request without any parameters is treated as the CI form request. If \c{ci-form} is configured, then such a form is generated and returned. @@ -208,11 +210,11 @@ For each CI request \c{brep} performs the following steps. \li|Verify the required \c{repository} and optional \c{package} parameters. -The \c{repository} parameter is the repository URL that contains the packages -to be tested. If one or more \c{package} parameters are present, then only the -specified packages are tested. If no \c{package} parameters are specified, -then all the packages present in the repository (but excluding complement -repositories) are tested. +The \c{repository} parameter is the remote \c{bpkg} repository location that +contains the packages to be tested. If one or more \c{package} parameters are +present, then only the specified packages are tested. If no \c{package} +parameters are specified, then all the packages present in the repository (but +excluding complement repositories) are tested. Each \c{package} parameter can specify either just the package name, in which case all the versions of this package present in the repository will be @@ -322,7 +324,7 @@ timestamp: <date-time> [user-agent]: <string> \ -The \c{package} value can be repeated multiple time. The \c{timestamp} value +The \c{package} value can be repeated multiple times. The \c{timestamp} value is in the ISO-8601 \c{<YYYY>-<MM>-<DD>T<hh>:<mm>:<ss>Z} form (always UTC). Note also that \c{client-ip} can be IPv4 or IPv6. |