acid/README.adoc

35 lines
1.1 KiB
Plaintext
Raw Normal View History

2024-03-29 14:08:15 +01:00
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"
2024-04-18 07:10:32 +02:00
by a normal HTTP server, and as such it will not provide TLS support to secure
2024-03-29 14:08:15 +01:00
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.
2024-04-10 15:39:38 +02:00
2024-04-18 07:10:32 +02:00
For a step-by-step guide, see
https://p.janouch.name/text/continuous-integration.html[the related article].
2024-04-10 15:39:38 +02:00
Demo
----
'acid' is deployed on https://git.janouch.name[].