Implement build task, result and log requests handling

2 files changed, 78 insertions, 15 deletions

diff --git a/etc/brep-apache2.conf b/etc/brep-apache2.conf
index b7a481e..5114623 100644
--- a/etc/brep-apache2.conf
+++ b/etc/brep-apache2.conf
@@ -8,6 +8,18 @@
           LoadModule brep_module /home/brep/install/libexec/brep/mod_brep.so
         </IfModule>
 
+        # Repository email. This email is used for the From: header in emails
+        # send by brep (for example, build failure notifications).
+        #
+        brep-email admin@example.org
+
+        # Repository host. It specifies the scheme and the host address (but
+        # not the root path; see brep-root below) that will be used whenever
+        # brep needs to construct an absolute URL to one of its locations (for
+        # example, a link to a build log that is being send via email).
+        #
+        brep-host https://example.org
+
         # Repository root. This is the part of the URL between the host name
         # and the start of the repository. For example, root value /pkg means
         # the repository URL is http://example.org/pkg/. Specify / to use the
diff --git a/etc/brep-module.conf b/etc/brep-module.conf
index 760d4ce..1d9d56d 100644
--- a/etc/brep-module.conf
+++ b/etc/brep-module.conf
@@ -26,7 +26,7 @@ menu About=?about
 
 # Number of pages in navigation (pager).
 #
-# search-pages   5
+# search-pages 5
 
 
 # Number of package description characters to display in brief pages.
@@ -36,31 +36,82 @@ menu About=?about
 
 # Number of package changes characters to display in brief pages.
 #
-# package-changes     5000
+# package-changes 5000
 
 
-# Database connection configuration. By default, brep will try to connect to
-# the local instance of PostgreSQL with the operating system-default mechanism
-# (Unix-domain socket, etc) and use operating system (login) user name and the
-# database called 'brep'. See brep(1) for details.
+# The package database connection configuration. By default, brep will try to
+# connect to the local instance of PostgreSQL with the operating system-default
+# mechanism (Unix-domain socket, etc) and use operating system (login) user
+# name and the database called 'brep_package'. See brep(1) for details.
 #
-# db-user
-# db-password
-# db-name      brep
-# db-host
-# db-port
+# package-db-user
+# package-db-password
+# package-db-name     brep_package
+# package-db-host
+# package-db-port
 
 
-# The maximum number of concurrent database connections per web server
+# The maximum number of concurrent package database connections per web server
 # process. If 0, then no limitation is applied.
 #
-# db-max-connections 5
+# package-db-max-connections 5
 
 
-# The maximum number of times to retry database transactions in the
+# The maximum number of times to retry package database transactions in the
 # face of recoverable failures (deadlock, loss of connection, etc).
 #
-# db-retry 10
+# package-db-retry 10
+
+
+# Build configuration file. If not specified (default), then the package
+# building functionality will be disabled. If specified, then the build
+# database must be configured (see next). Note: must be an absolute path.
+#
+# build-config
+
+# The maximum size of the build task request manifest accepted. Note that the
+# HTTP POST request body is cached to retry database transactions in the face
+# of recoverable failures (deadlock, loss of connection, etc). Default is
+# 100K.
+#
+# build-task-request-max-size 102400
+
+
+# Time to wait before considering the expected task result lost. Must be
+# specified in seconds. Default is 3 hours.
+#
+# build-result-timeout 10800
+
+
+# The maximum size of the build result manifest accepted. Note that the HTTP
+# POST request body is cached to retry database transactions in the face of
+# recoverable failures (deadlock, loss of connection, etc). Default is 10M
+#
+# build-result-request-max-size 10485760
+
+
+# The build database connection configuration. By default, brep will try to
+# connect to the local instance of PostgreSQL with the operating system-default
+# mechanism (Unix-domain socket, etc) and use operating system (login) user
+# name and the database called 'brep_build'. See brep(1) for details.
+#
+# build-db-user
+# build-db-password
+# build-db-name     brep_build
+# build-db-host
+# build-db-port
+
+
+# The maximum number of concurrent build database connections per web server
+# process. If 0, then no limitation is applied.
+#
+# build-db-max-connections 5
+
+
+# The maximum number of times to retry build database transactions in the
+# face of recoverable failures (deadlock, loss of connection, etc).
+#
+# build-db-retry 10
 
 
 # Trace verbosity. Disabled by default.