aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2021-07-31 10:16:38 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2021-07-31 10:17:44 +0300
commit9181b3a021acc7585cb6f9f20da6accfce0015e0 (patch)
tree0fcb4d5a99be02ac7a934817491f50d0d32d757d /README.md
parentadd some unit tests (diff)
downloadcgitize-9181b3a021acc7585cb6f9f20da6accfce0015e0.tar.gz
cgitize-9181b3a021acc7585cb6f9f20da6accfce0015e0.zip
merge my_repos.py to the config
The config is also in the TOML format now. It's a bit messy for the moment, but I'll fix it.
Diffstat (limited to 'README.md')
-rw-r--r--README.md21
1 files changed, 8 insertions, 13 deletions
diff --git a/README.md b/README.md
index ee493b5..a74e4c0 100644
--- a/README.md
+++ b/README.md
@@ -15,28 +15,23 @@ Installation
Usage
-----
-cgitize uses two config files.
+Pass the path to the config to `cgitize` (/etc/cgitize/cgitize.toml by
+default):
-* cgitize.conf contains all the settings; see example at
-[examples/cgitize.conf].
-* my_repos.py contains the list of repositories to mirror; see example at
-[examples/my_repos.py].
+ cgitize --config path/to/cgitize.toml
-Pass the path to cgitize.conf using the `--config` parameter:
-
- cgitize --config path/to/cgitize.conf
+See an example config file at [examples/cgitize.toml].
cgitize uses the `git` executable, which might use `ssh` internally.
-Make sure the required keys are loaded to a ssh-agent (or use authentication
-tokens).
+Make sure the required keys are loaded to a ssh-agent (or use access
+tokens/application passwords).
-[examples/cgitize.conf]: examples/cgitize.conf
-[examples/my_repos.py]: examples/my_repos.py
+[examples/cgitize.toml]: examples/cgitize.toml
### Docker
The image is **egortensin/cgitize**.
-The container reads the config from /etc/cgitize/cgitize.conf and writes the
+The container reads the config from /etc/cgitize/cgitize.toml and writes the
repositories to /var/tmp/cgitize/output.
If SSH is required, the socket should be mapped to
/var/run/cgitize/ssh-agent.sock.