Commit graph

140 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
Maximilian Bosch 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
Maximilian Bosch 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
Maximilian Bosch 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
Maximilian Bosch 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
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
Eelco Dolstra 55f9d23933 Add a command `hydra-create-user' for managing user accounts 2013-11-06 13:36:29 +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 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
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
Rob Vermaas c37b90ee3e hydra: use autoconf/-make 2010-09-30 14:29:15 +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 Visser 2599cbcf53 why nix is covered in intro 2008-12-01 23:23:01 +00:00
Eelco Visser 6415d25b93 ripped intro from the SCP paper and manualized it 2008-12-01 23:20:42 +00:00
Eelco Visser 96f7c0b2cd general information 2008-12-01 20:50:50 +00:00
Eelco Visser 2810e5e280 general information 2008-12-01 20:43:09 +00:00
Eelco Visser c0b220e5f1 boilerplate, platform stuff 2008-12-01 20:20:39 +00:00
Eelco Visser d5c5f90742 draft manual 2008-12-01 20:03:18 +00:00