Commit Graph

132 Commits

Author SHA1 Message Date
Eelco Dolstra
2dc6d58845 Merge pull request from Mic92/docs
Document github integration further.
2021-11-02 15:29:07 +01:00
Andrei Rybak
a462a9f488 docs: fix typos
Fix various typos in Markdown documentation files.
2021-11-02 14:39:58 +01:00
Jörg Thalheim
1593e0212e docs: document github webhooks 2021-10-30 09:42:32 +02:00
Jörg Thalheim
70f1db2762 docs: improve github refs documentation 2021-10-30 09:40:37 +02:00
Jörg Thalheim
cdddbb89f3 docs: improve github status plugin documentation 2021-10-30 09:40:36 +02:00
Jörg Thalheim
243291f9bd add basic documentation for all plugins
Co-authored-by: Pablo Ovelleiro Corral <mail@pablo.tools>
Co-authored-by: Graham Christensen <graham@grahamc.com>
2021-10-03 13:56:44 +02:00
Your Name
45e8fa5319 hydra-notify: support sending diagnostic dumps to STDERR on request 2021-08-24 10:56:13 -04:00
Your Name
6d7ee27d25 hydra-notify: make the prometheus endpoint configurable, default-off 2021-08-24 10:56:13 -04:00
Graham Christensen
ba1ea8d9c4 Merge pull request from DeterminateSystems/docs/connect-local-db
docs: note how to connect to the database
2021-08-06 14:56:20 -04:00
Graham Christensen
5900e4d0b3 docs/notifications: fixup sending a notification 2021-08-06 14:35:38 -04:00
Graham Christensen
23ac4a665c docs: note how to connect to the database 2021-08-06 14:34:59 -04:00
Shay Bergmann
d64caea870 Remove clause suggesting absolute paths don't work 2021-07-26 19:51:29 +00:00
Shay Bergmann
f36bffa008 Use absolute path in example as it seems to be working now
might have something to do with `-IncludeRelative`...
2021-07-26 19:29:28 +00:00
Shay Bergmann
45077a120d ... fix embarrassing typo... 2021-07-23 22:10:00 +00:00
Shay Bergmann
774194d681 Update docs 2021-07-22 23:12:25 -04:00
Cole Helbling
5e72d42575 Docs: fixup maintainers derivation meta field example 2021-06-28 11:16:25 -07:00
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 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
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 ()
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. () 2016-11-29 15:27:53 +01:00
Leonid Onokhov
96dc9ccecb Document how to serve hydra behind reverse proxy () 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