aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
diff options
context:
space:
mode:
authorPřemysl Eric Janouch <p@janouch.name>2024-03-29 14:08:15 +0100
committerPřemysl Eric Janouch <p@janouch.name>2024-04-04 19:40:14 +0200
commitfd6959fff82a87e92d9e73cb07e210cebb675050 (patch)
treed7fd170022d99e9d6a978208ab31f169f3574ad8 /README.adoc
downloadacid-fd6959fff82a87e92d9e73cb07e210cebb675050.tar.gz
acid-fd6959fff82a87e92d9e73cb07e210cebb675050.tar.xz
acid-fd6959fff82a87e92d9e73cb07e210cebb675050.zip
Initial commit
Diffstat (limited to 'README.adoc')
-rw-r--r--README.adoc27
1 files changed, 27 insertions, 0 deletions
diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..27be041
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,27 @@
+acid
+====
+
+'acid' is A Continuous Integration Daemon.
+
+The aim of this project is to provide a trivial CI daemon for Gitea.
+I find most alternatives way too complex to set up and run in a local setting,
+while the gist of it is actually very simple--run some stuff on new git commits.
+
+'acid' provides a simple web frontend, as well as a webhook endpoint
+for notifications about new commits. The daemon is supposed to be "firewalled"
+by a normal HTTP server, and it will not provide TLS support to secure
+communications.
+
+'acid' runs tasks over SSH, which should be universal enough.
+It can tell you the build results via any method you can put in a shell script.
+
+Getting it to work
+------------------
+ # apt install git golang asciidoctor
+ $ git clone https://git.janouch.name/p/acid.git
+ $ cd acid
+ $ make
+ $ man -l acid.1
+
+You will need to write your own runner scripts, which may be nontrivial.
+The author suggests using __cloud-init__-enabled virtual machines with QEMU.