Commit graph

174 commits

Author SHA1 Message Date
Graham Christensen ba1ea8d9c4
Merge pull request #989 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 #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
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