diff --git a/doc/src/SUMMARY.md b/doc/src/SUMMARY.md index 1a32f92..a9121ca 100644 --- a/doc/src/SUMMARY.md +++ b/doc/src/SUMMARY.md @@ -12,6 +12,7 @@ - [musik](./projekte/musik.md) - [TODO](./todo.md) - [Modules]() + - [Gitea-translator](./module/gitea-translator.md) - [Initrd-ssh](./module/initssh.md) - [Disks](./module/disks.md) - [How-to]() diff --git a/doc/src/module/gitea-translator.md b/doc/src/module/gitea-translator.md new file mode 100644 index 0000000..389950d --- /dev/null +++ b/doc/src/module/gitea-translator.md @@ -0,0 +1,21 @@ +# Gitea-tanslator +The module can be used by importing `inputs.self.nixosModules.malobeo.gitea-translator` + +This module starts a python server that fetches the gitea pull request api and translates it to a file that hydra understands. +To use, just set the parameters of the gitea server, then send a GET request to either `http://${host}:${port}/` or `http://${host}:${port}/gitea-pulls-sorted.json` + +## Module config +##### enable (default = false) - enables the module +##### baseurl (default = "git.dynamicdiscord.de") - Base URL of the Gitea instance +##### owner (default = "malobeo") - Repository owner +##### repo (default = "infrastructure") - Repository name +##### host (default = "127.0.0.1") - Address the server binds to +##### port (default = 27364) - Port the server listens on + +## Hydra config +If you change the default port or host, the file `.hydra/spec.json` has to be modified accordingly. +With the module running on the hydra host, create a new hydra project, then: + + - Set `Declarative spec file` to `.hydra/spec.json` + - Change declaritive input type to `Git checkout` + - Set your git repo location in the field below that