Commit graph

166 commits

Author SHA1 Message Date
Graham Christensen
59018323ae Docs: document derivation attributes 2021-06-28 10:00:05 -04:00
Graham Christensen
6eb701fcf2 notifications: Document an example scenario where builds_finished is triggered twice. 2021-06-17 13:20:13 -04:00
Graham Christensen
e8afde5079 Write up some documentation on notifications 2021-06-17 13:15:34 -04:00
Graham Christensen
5700c351e8 Init a docs section for monitoring, document queue-runner-status and the prometheus metrics 2021-06-10 20:13:08 -04:00
963085a04a
Add AuthenSASL to perl deps; improve email docs
The addition of AuthenSASL seems to be necessary to properly
authenticate against an SMTP server. Without this I got errors
such as

    error with Hydra::Plugin::EmailNotification=HASH(0x6ad0128)->buildFinished: SMTP auth requires MIME::Base64 and Authen::SASL
2021-04-26 18:33:57 +02:00
Eelco Dolstra
20c1efeb5b
Merge pull request #904 from Ma27/gitea-integration
Add `GiteaStatus`-Plugin
2021-04-08 17:57:38 +02:00
Graham Christensen
5f91353824
doc/manual/src/installation.md: give a conf syntax type
Co-authored-by: Sandro <sandro.jaeckel@gmail.com>
2021-04-05 16:42:15 +00:00
Graham Christensen
7bb9850656 doc: hacking: fixup nix-shell dependency comment 2021-04-05 16:10:09 +00:00
Graham Christensen
9788c52eff doc: hacking: remove duplicate 'by default' 2021-04-05 16:10:09 +00:00
Graham Christensen
b03fa96186 doc: hacking: Quote perl5lib 2021-04-05 16:10:09 +00:00
Graham Christensen
2e47970a97 doc: switch shell session code blocks to console type. 2021-04-05 16:10:09 +00:00
Graham Christensen
0ddf3d43f2 manual: document working on docs 2021-04-05 15:40:09 +00:00
Graham Christensen
d764eabfcc docs: mention foreman under hacking 2021-04-05 15:40:09 +00:00
f9f5ab2fb1
Make gitea public URL configurable
Otherwise, it will be obtained from the jobset input that contains the
URL to the git repo to build.
2021-03-30 23:01:36 +02:00
fef142f13a
Implement simple status notifications for Git repos hosted on gitea 2021-03-30 14:10:21 +02:00
Janne Heß
9e018d5443
Add the project name to declarative inputs
This allows for more generic declarative configurations which can be
shared between projects.
2021-03-08 17:36:52 +01:00
Matej Cotman
a551fba346
statsd: add a chance to set hostname and port in hydra.conf
Co-authored-by: Graham Christensen <graham@grahamc.com>
2021-03-08 10:03:16 -05:00
Cole Helbling
2befb2c1e1
doc: document how to run tests
Both `make check` and `make && yath test` are now documented ways to
run the test suite.
2021-03-05 09:49:06 -08:00
Ismaël Bouya
bd64b2481d
Remove old files 2021-02-24 01:07:11 +01:00
Ismaël Bouya
9d916877fb
Add markdown files for documentation
projects.xml and declarative-projects.xml were merged with xmllint, and
then I ran that to convert files
for i in *.xml; do pandoc -s -f docbook -t markdown $i -o ${i/xml/md}; done
2021-02-24 01:07:00 +01:00
Janne Heß
3f4d9f8446
manual: Fix XML 2020-09-13 17:52:18 +02:00
Andreas Rammhold
b5d7ed2e99
LDAP: add brief section in the documentation 2020-09-11 15:21:40 +02:00
Graham Christensen
7f16c0d243
declarative projects: support fully static, declarative configuration 2020-09-02 12:35:41 -04:00
Eelco Dolstra
d4e4be4fd1
Remove SHA-1 hash from BuildProducts
SHA-1 is deprecated and it will be expensive to compute with the
streaming NAR handler.
2020-07-27 18:24:10 +02:00
Eelco Dolstra
96a514c169
Remove the "releases" feature
We haven't used this in many years (it was really only used for nix
and patchelf releases).
2020-05-06 12:39:21 +02:00
efcbc08686
Get rid of dependency to SQLite
SQLite isn't properly supported by Hydra for a few years now[1], but
Hydra still depends on it. Apart from a slightly bigger closure this can
cause confusion by users since Hydra picks up SQLite rather than
PostgreSQL by default if HYDRA_DBI isn't configured properly[2]

[1] 78974abb69
[2] https://logs.nix.samueldr.com/nixos-dev/2020-04-10#3297342;
2020-04-16 00:42:40 +02:00
Eelco Dolstra
be0ec2d223
Remove style.css
https://github.com/NixOS/nix/issues/3392
2020-03-13 16:17:48 +01:00
Craige McWhirter
bb4f349161
Corrected grammer typo
Replaced you with look
2019-08-09 13:49:21 +10:00
Chloe Kever
9eb149b509 Fix bad ordering in projects documentation. 2018-01-17 13:34:01 -08:00
Eelco Dolstra
e9670641ec
Distinguish build step states
The web interface now shows whether a build step is connecting,
copying inputs/outputs, building, etc.
2017-12-07 15:35:31 +01:00
Richard Zetterberg
3e0ee24b87 Adds documentation for the external API (#441)
Documents all the endpoints that can be used to retrieve data from
the API without authenticating.

Authentication and manipulating data with the API is not documented.
2017-04-01 11:20:49 +02:00
phile314-isska
cf12356572 Document ssmtp for email notifications. (#426) 2016-11-29 15:27:53 +01:00
Leonid Onokhov
96dc9ccecb Document how to serve hydra behind reverse proxy (#423) 2016-11-24 16:10:50 +01:00
Shea Levy
d6ccbeedbd doc: add basic docs about declarative projects
Conversion of Shea's *.md, added as a subsection.  Shea is left as author.
I made this new bit a separate file, though it might be questionable.
2016-10-31 18:33:17 +01:00
Domen Kožar
607eeda9bb svn.nixos.org -> github.com 2016-10-12 18:00:34 +02:00
Eelco Dolstra
7221bd7e5a manual: Add index.html 2016-10-10 15:52:11 +02:00
Alexander Ried
5232557b1a Update link to hydra nixexpression 2016-04-21 02:36:59 +02:00
Eric Litak
17035661f2 typo 2016-04-06 11:28:32 -07:00
Eelco Dolstra
74426e6820 Simplify running nix-shell
This also removes building a separate source tarball or building a PDF
manual since it's unlikely anybody cares.
2016-03-22 12:53:28 +01:00
Eelco Dolstra
f933762358 Disable building the PDF manual 2015-07-08 16:51:05 +02:00
Eelco Dolstra
e32ee3d5b9 Remove hydra-build and the old hydra-queue-runner 2015-06-22 15:43:15 +02:00
Eelco Dolstra
d9475273c5 trunk -> master 2014-04-25 14:56:29 +02:00
Rob Vermaas
78974abb69 Remove sqlite from the docs. Not (properly) supported. 2014-02-17 12:24:34 +01:00
Rob Vermaas
b3c1c57a5b Add postgresql 9.2 remark 2014-01-24 13:00:18 +01:00
Eelco Dolstra
55f9d23933 Add a command `hydra-create-user' for managing user accounts 2013-11-06 13:36:29 +01:00
Eelco Dolstra
1f711403be Add a dev note 2013-11-05 10:50:02 +01:00
Eelco Dolstra
967791f6f3 Add the actual file 2013-07-19 15:02:01 +02:00
Eelco Dolstra
1b5e0821d1 Add hacking.xml to the distribution 2013-07-19 15:01:18 +02:00
Eelco Dolstra
659c829e88 Tweaks for nix-shell 2013-07-19 14:36:52 +02:00
Eelco Dolstra
289b29791f Add note on restarting builds that times out 2013-06-13 20:54:28 +02:00
Eelco Dolstra
5e0542d3af Use buildEnv to combine Hydra's Perl dependencies
This makes the Perl search path ($PERL5LIB) much shorter, cutting down
the number of stat() calls when starting hydra-server from ~432000 to
~9000.
2013-05-24 15:26:47 -04:00
Eelco Dolstra
507e5bb190 Drop unused "disabled" columns 2013-05-03 16:39:17 +02:00
Eelco Dolstra
fcd511c4de Revert "Remove now-unused SystemTypes table"
This reverts commit 71d020735b.
Unfortunately there are still some cases where we need to set Hydra's
concurrency separately.  (Ideally, Hydra would start *all* queued
builds in parallel and let Nix take care of everything...)
2013-03-05 17:42:16 +01:00
Shea Levy
71d020735b Remove now-unused SystemTypes table 2013-03-04 17:46:37 -05:00
Eelco Dolstra
f5000f0ad2 Update how to restart builds 2013-01-28 18:53:22 +01:00
Eelco Dolstra
67aefde62c Remove trailing whitespace 2013-01-22 14:41:02 +01:00
Eelco Dolstra
fc39034772 Whitespace 2013-01-22 13:19:08 +01:00
Ludovic Courtès
2865569392 doc: Update to use angle brackets and `tarball' in the same evaluation. 2012-05-23 00:07:49 +02:00
Eelco Dolstra
4ad8912aa3 Fix indentation 2012-05-11 18:25:56 -04:00
Eelco Dolstra
770bc15848 Number the sections 2012-05-11 18:22:46 -04:00
Eelco Dolstra
3e6b24930c Sync with the CSS of the Nix manual 2012-05-11 18:22:23 -04:00
Eelco Dolstra
541238030d Provide a command ‘hydra-init’ to initialise/upgrade the database
For schema upgrades, hydra-init executes the files
src/sql/upgrade-<N>.sql, each of which upgrades the schema from
version N-1 to N.  The upgrades are wrapped in a transaction.
2012-02-28 20:16:16 +01:00
Eelco Dolstra
918fc5e6df Manual: Remove tabs, indent consistently 2012-02-28 15:38:47 +01:00
Eelco Dolstra
da26294fdb Don't install hydra-create
It doesn't do anything useful for users.
2012-02-28 15:33:28 +01:00
Ludovic Courtès
6c4e83d454 More command renaming. 2011-12-02 15:58:26 +01:00
Eelco Dolstra
3630421049 Update the docs to reflect the renaming 2011-11-30 18:14:48 +01:00
Eelco Dolstra
26f6211777 Fix stupid change
Oops.
2011-11-22 17:01:55 +01:00
Eelco Dolstra
392996b743 Whitespace 2011-11-22 16:46:07 +01:00
Ludovic Courtès
fa7e563f04 doc: Mention package names. 2011-10-12 21:42:28 +00:00
Ludovic Courtès
3fd1dd47e2 doc: Untabify so that the examples are correctly rendered. 2011-10-12 21:42:24 +00:00
Ludovic Courtès
cfd1da99b9 doc: Re-add Docbook source files to the distribution. 2011-10-12 21:23:21 +00:00
Ludovic Courtès
bcf8dc5ec4 doc: Ship Docbook's callout images. 2011-10-12 21:14:36 +00:00
Ludovic Courtès
ceb38a727a doc: Write "Adding More Jobs". 2011-10-12 14:54:20 +00:00
Ludovic Courtès
f7fe932939 doc: Fix another ID typo. 2011-10-12 14:54:15 +00:00
Ludovic Courtès
46cd25784a doc: Use a CSS and callout images for the HTML output. 2011-10-12 14:20:09 +00:00
Ludovic Courtès
b63e5bdac9 doc: Fix typo in callout ID. 2011-10-12 14:20:06 +00:00
Ludovic Courtès
3892f516ca doc: Write "Building from the Command Line". 2011-10-12 14:20:02 +00:00
Ludovic Courtès
7f85268f86 doc: Show example of `configureFlags'. 2011-10-12 14:19:57 +00:00
Ludovic Courtès
714233a797 doc: Add myself as a co-author. 2011-10-11 21:05:10 +00:00
Ludovic Courtès
46b38dc623 doc: Add preliminary section about `release.nix'. 2011-10-11 21:05:06 +00:00
Ludovic Courtès
073c6f8b90 Fix typo in makefile. 2011-10-04 13:31:10 +00:00
Ludovic Courtès
666f543122 Build the HTML manual; add the HTML & PDF to the distribution; install them.
* doc/manual/Makefile.am (dist_html_DATA, dist_pdf_DATA): New variables.
  (manual.html): New target.
  (manual.pdf): Use $(DBLATEX), uppercase.

* configure.ac: Check for `xsltproc'.  Add `--with-docbook-xsl' option.
2011-07-04 14:48:38 +00:00
Ludovic Courtès
b773b13e9b doc: Import the "Creating Projects" chapter by Visser & Dolstra. 2011-03-16 22:50:09 +00:00
Ludovic Courtès
3426bf59ff doc: Mention the 3 processes that make up Hydra. 2011-03-16 22:50:02 +00:00
Ludovic Courtès
87d1b447c2 doc: Augment the "Installation" section with material by Visser & Dolstra. 2011-03-16 07:56:39 +00:00
Ludovic Courtès
b147e71dcd doc: Reintegrate the intro by Visser & Dolstra from `manual.html'.
The `manual.html' file had been deleted in r21718 ("Hydra/28: Rename
"scheduler" to "evaluator"".)
2011-03-09 17:13:29 +00:00
Ludovic Courtès
0a80c737d0 doc: Mention SQLite. 2011-03-09 16:34:19 +00:00
Eelco Dolstra
31edd973c6 2011-01-09 18:52:58 +00:00
Eelco Dolstra
738712fca0 * Merge the GC branch. 2010-11-19 11:01:31 +00:00
Rob Vermaas
c37b90ee3e hydra: use autoconf/-make 2010-09-30 14:29:15 +00:00
Rob Vermaas
001113f7f9 Hydra/28: Rename "scheduler" to "evaluator" 2010-05-11 11:10:03 +00:00
Rob Vermaas
4550ced942 Hydra/28: Rename "scheduler" to "evaluator" 2010-05-11 11:09:58 +00:00
Rob Vermaas
ad5761bb25 whitespace commit 2010-04-19 10:25:15 +00:00
Rob Vermaas
d41b7c0918 removed some whitespace 2010-04-19 10:25:12 +00:00
Rob Vermaas
9eaaa0c1e9 dummy commit 2010-04-13 08:03:12 +00:00
Rob Vermaas
45b4f045d3 Merge remote branch 'remotes/origin/master' 2010-03-23 19:50:29 +00:00
Rob Vermaas
fb294fa183 start of hydra manual 2010-03-19 13:42:05 +00:00
Eelco Dolstra
7daca03e78 * Store jobset evaluations in the database explicitly. This includes
recording the builds that are part of a jobset evaluation.  We need
  this to be able to answer queries such as "return the latest NixOS
  ISO for which the installation test succeeded".  This wasn't previously
  possible because the database didn't record which builds of (say)
  the `isoMinimal' job and the `tests.installer.simple' job came from
  the same evaluation of the nixos:trunk jobset.

  Keeping a record of evaluations is also useful for logging purposes.
2010-03-05 15:41:10 +00:00
Eelco Dolstra
cb2493eca9 * Store the jobset's nixExprPath and nixExprInput fields in a build to
allow it to be cloned (re-executed with modified inputs) later and
  to provide some traceability.
2009-10-26 13:33:48 +00:00
Eelco Dolstra
929cbe7b7c * Adding persistant releases. A release is a named set of builds. 2009-10-21 15:44:17 +00:00