Add AuthenSASL to perl deps; improve email docs
[?]
Apr 24, 2021, 8:41 PM
JXFYZYDJWE5LFOWH6D25A7T2MWWBALO4RJGTRW6P65LWNQBDPTKACDependencies
Change contents
- edit in doc/manual/src/projects.md at line 460
The feature can be turned on by adding the following line to `hydra.conf```` confemail_notification = 1```By default, Hydra only sends email notifications if a previously successfulbuild starts to fail. In order to force Hydra to send an email for each build(including e.g. successful or cancelled ones), the environment variable`HYDRA_FORCE_SEND_MAIL` can be declared:``` nixservices.hydra-dev.extraEnv.HYDRA_FORCE_SEND_MAIL = "1";``` - edit in doc/manual/src/projects.md at line 476
SASL Authentication for the email address that's used to send notificationscan be configured like this:``` confEMAIL_SENDER_TRANSPORT_sasl_username=hydra@example.orgEMAIL_SENDER_TRANSPORT_sasl_password=verysecretEMAIL_SENDER_TRANSPORT_port=587EMAIL_SENDER_TRANSPORT_ssl=starttls```Further information about these environment variables can be found at the[MetaCPAN documentation of `Email::Sender::Manual::QuickStart`](https://metacpan.org/pod/Email::Sender::Manual::QuickStart#specifying-transport-in-the-environment).It's recommended to not put this in `services.hydra-dev.extraEnv` as this wouldleak the secrets into the Nix store. Instead, it should be written into anenvironment file and configured like this:``` nix{ systemd.services.hydra-notify = {serviceConfig.EnvironmentFile = "/etc/secrets/hydra-mail-cfg";};}``` - edit in flake.nix at line 293[4.1287][4.1287]
AuthenSASL