README.md update
[?]
May 15, 2020, 11:59 AM
43CQEJTEQTKAA2WATBOZPD3PT35ZT76NBCRS2N6VIRY5KP467OTACDependencies
- [2]
LA5L7JCUREADME.md: info about runHydra/foreman - [3]
KH55FNTFUpdate README - [4]
LX326CB7Add hydra OpenAPI description (#750) - [*]
NVMDS7GEAdd README.md
Change contents
- edit in README.md at line 87
### Development WorkflowWhen working on new features or bug fixes you want to be able to run Hydra from your working copy. There aretwo ways to do this. One is better for interactive development and provides faster feedback cycles, the otheris more convenient for a single test run of Hydra from the working copy (suiteable for PR reviews). - replacement in README.md at line 88
#### Using runHydra### Executing Hydra During Development - replacement in README.md at line 90
Hydra can be built and executed using the `runHydra` shell:When working on new features or bug fixes you need to be able to run Hydra from your working copy. Thiscan be done using [foreman](https://github.com/ddollar/foreman): - replacement in README.md at line 94
$ nix-shell default.nix -A runHydra$ nix-shell$ # hack hack$ make$ foreman start - replacement in README.md at line 100
This will spawn a shell that starts hydra-server, hydra-queue-runner, hydra-evaluator and postgres using [foreman](https://github.com/ddollar/foreman).In order to not collide with potentially existing installations running on default ports hydra and postgres are running on custom ports:Have a look at the [Procfile](./Procfile) if you want to see how the processes are being started. In order to avoidconflicts with services that might be running on your host, hydra and postgress are started on custom ports: - replacement in README.md at line 106
**Note**: In some cases you may want to skip test execution. You can do so by passing `doCheck false`:```$ nix-shell default.nix -A runHydra --arg doCheck false```Note that this is only ever meant as an ad-hoc way of executing Hydra during development. Please make use of theNixOS module for actually running Hydra in production. - edit in README.md at line 109
#### Using foremanWhen you are actively working on the code, you need fast feedback cycles and thus want incremental builds. Instead of using`runHydra` you can just run `foreman start` directly in the normal `nix-shell` environment:```$ nix-shell$ # hack hack$ make$ foreman start```