Commit Graph
66 Commits
Author SHA1 Message Date
Lars Wirzenius ade641d76d doc: add a more realistic configuration example to user guide 2026-08-24 15:24:42 +03:00
Lars Wirzenius 64def56ddf chore: drop mention of obsolete RADICLE_CI_BROKER_WEBOOT from docs
Also drop PATH from the `cib` config example in the user guide, as it's
not always necessary.
2026-07-27 13:03:23 +03:00
Lars Wirzenius 12a32a0798 fix: disable generation of sample messages
The "signer" change in Radicle broke this and I can't figure out how to
do fix this, while using a mock repository. I'll disable it for now.
Will fix later.
2026-07-09 12:41:42 +03:00
Lars Wirzenius 564abab42d doc: add update_job_cobs to config 2026-06-16 20:02:37 +03:00
Lars Wirzenius 8aa71af4d0 fix: link markup in user guide 2026-05-26 13:18:05 +03:00
Lars Wirzenius 2d3a0e377d doc: point to installation script and playbook in userguide 2026-05-26 12:16:30 +03:00
Lars Wirzenius ed7170c39e chore: update Radicle home page URLs to new domain 2026-05-12 10:03:30 +03:00
Lars Wirzenius bf535363c1 chore: update Radicle Explorer URLs to new official instance 2026-05-12 09:40:16 +03:00
Lars Wirzenius d93a285e33 fix(doc/userguide.md): fix typo 2026-04-13 11:49:45 +03:00
Lars Wirzenius 472d6486f0 fix: document installing from Radicle APT repository 2026-03-04 09:48:41 +02:00
Lars Wirzenius ac530cf29e doc: explain limit on concurrency per repo 2025-11-28 16:09:09 +02:00
Lars Wirzenius 5d8d60beee doc: write document on how to implement a CI adapter 2025-11-17 15:51:58 +02:00
Lars Wirzenius 179ce402ca doc: add AnyDelegate to list of filters 2025-11-12 14:41:27 +02:00
Lars Wirzenius 0a77f80d31 fix: typo in filename 2025-11-10 18:18:33 +02:00
Lars Wirzenius 0dc74cf8e7 doc: document how to add a new event filter 2025-11-10 17:31:17 +02:00
Lars Wirzenius 92f309a75b chore: drop unused doc/publish.sh
This was a remenant from an older era of Radicle CI.
2025-10-20 09:25:44 +03:00
Lars Wirzenius 5379b676d5 doc(doc/userguide.md): add note about RAD_PASSPHRASE for node key 2025-10-08 08:40:16 +03:00
Lars Wirzenius a73a1c7fe8 doc: add an overview document of Radicle CI 2025-10-06 18:26:57 +03:00
Arnaud Bailly acba124206 doc: highlight the need to filter node ids 2025-09-15 12:04:01 +03:00
Lars Wirzenius 6909e4659b feat: deprecate the status_update_interval_seconds config field
It has never actually been used.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-07-30 11:45:22 +03:00
Lars Wirzenius bda46bb06a fix(doc/architecture.md): fix typo
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-07-24 09:37:06 +03:00
Richard Levitte b151768bbd fixup! doc(doc/userguide.md): document configuration file fields
Signed-off-by: Richard Levitte <richard@levitte.org>
2025-07-15 12:55:13 +02:00
Lars Wirzenius 9d218bd92f doc(doc/userguide.md): document configuration file fields
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-07-15 12:37:41 +03:00
Tshepang Mbambo 97a904c6cb use a consistent config name 2025-06-14 16:11:20 +02:00
Tshepang Mbambo 0261d2523d remove debatable statement
Installing a Rust toolchain installed is not obviously more easy than
adding a distro package repo.
2025-06-14 16:08:30 +02:00
Tshepang Mbambo 3c0e165763 some text fixes 2025-06-14 16:08:10 +02:00
Lars Wirzenius a90788296f docs(doc/userguide.md): tweak Debian installation
Add note about `kvm` kernel module and Unix group.

Add step to create log directory.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-05-21 18:21:37 +03:00
Lars Wirzenius 941343071d Revert "docs(doc/install.md): oops, add the installation document to Git"
This reverts commit 5ae86e9103.

The doc is part of the user guide already, no need to have it as a
separate file as well. It'll just get out of sync.
2025-05-19 11:24:54 +03:00
Lars Wirzenius 5ae86e9103 docs(doc/install.md): oops, add the installation document to Git
Had forgotten to add that. Bummer.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-05-19 10:56:52 +03:00
Lars Wirzenius 4e5dbdae20 docs(doc/userguide.md): add detailed installation guide for Debian
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-05-15 15:54:28 +03:00
Lars Wirzenius 6c14e56371 Merge branch 'patch/9437534' 2025-05-14 13:37:02 +03:00
Lars Wirzenius 93177407b4 docs(doc/architecture.md): update architecture components
Have just one component description, instead of separating "external"
and "native CI". Native CI doesn't need t be mentioned anyway.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-05-13 10:24:51 +03:00
Lars Wirzenius 5ce95bc360 feat: add "concurrent_adapters" to configuration file
This doesn't yet affect anything, but it's a step towards implementing
concurrent adapters. The default is 1, which will be no change from
previous behavior, once I add support.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-05-13 09:02:12 +03:00
Tshepang Mbambo 1d4442d42f avoid confusing terminology
Got confused here, where I did not know if what was referred was the
normal node or the CI node.

Also, "seed node" is used elsewhere to refer to nodes which need to
remain online.
2025-05-13 08:58:27 +03:00
Tshepang Mbambo b80a97d146 typo 2025-05-02 23:55:09 +02:00
Lars Wirzenius 6ec75d1978 doc(doc/userguide.md): document new tag events and filters
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-04-04 11:51:04 +03:00
Lars Wirzenius 6dc057e27f doc: add a "Getting started" section to the user guide
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-03-31 15:46:41 +03:00
Lars Wirzenius 0d1d3291cc fix: use new Git refs module, fix bugs found
This is a huge change, but it's mostly a few kinds of similar changes
in a lot of places. Unfortunately, they were not easy to tease apart
into small, easily reviewed commits.

Use the Git ref types created by the new refs module. Fix problems
this exposes.

The CiEvent enum variants for branch events now use the BranchName
type for branch names. In other words, they have a plain branch name.
The CiEvent::from_node_event constructor also always sets the branch
name to a plain branch name, instead of a name spaced ref for updated
or deleted branches. The ci_event.rs module's unit tests have been
fixed to use the correct kind of Git ref in each test. (It used to be
a mess.)

The CI event filter "Branch" now contains a BranchName, previously a
RefString. This should not break anything, as a RefString will always
work as a BranchName.

The DefaultBranch filter now works, because it compares plain branch
names, where it previously would compare a plain and a name spaced
branch name, and those are never equal.

"cibtool trigger" and "cibtool event add" now add branch events with a plain
branch instead of a name spaced ref.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-03-20 18:33:39 +02:00
Lars Wirzenius b0adc805ec doc(doc/userguide.md): add a chapter on configuration
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-03-13 18:03:06 +02:00
Lars Wirzenius a01aa8ce49 doc(doc/userguide.md): add DefaultBranch, HasFile, NoneOf, AnyOf, AllOf
Also sort table alphabetically, for easier skimming.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-02-18 15:55:31 +02:00
Lars Wirzenius 25a8d24d30 docs(doc/userguide.md): document "triggers" feature
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2025-01-23 18:20:22 +02:00
Lars Wirzenius dc61d2bbbb doc: reorder sections so that the more general case comes first
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-11-13 09:47:26 +02:00
Lars Wirzenius 92cbd0c730 doc: add goals to CI architecture doc
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-11-13 09:47:26 +02:00
Lars Wirzenius b199175ac0 doc: generate sample adapter messages with code
This removes the need to update them manually. Now they'll always be
up to date.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-11-13 09:47:26 +02:00
Lars Wirzenius 7ddb877a15 doc: format with Subplot, improve text
Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-11-13 09:47:22 +02:00
Lars Wirzenius d537fd39d1 feat: filter on originating node for an event
Add the `Node(nid)` event filter.

Add the `from_node` field to the `BranchDeleted` event so that it too
can be filtered based on node.

Adjust debug logging for event filtering so that it reports the
filtering decision.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-10-21 14:07:11 +03:00
Lars Wirzenius 69f10e3eb2 docs: start user guide; document CI events and filters 2024-09-30 14:01:03 +03:00
Richard Levitte 1a46a855e1 doc: RefsUpdated → RefsFetched
Since that's what's actually looked at (and RefsUpdated isn't an existing
type anyway).
2024-09-17 17:43:15 +02:00
Lars Wirzenius 9c822c67d2 docs: always publish
This works around a limitation in the native CI adapter, which checks
out the commit, but doesn't tell the CI run from which branch it came
from.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-05-14 16:34:20 +03:00
Lars Wirzenius 98db404e73 docs: move publishing shell snippet out of Makefile
Makefiles are an extra layer of escaping that doesn't help.

Signed-off-by: Lars Wirzenius <liw@liw.fi>
2024-05-14 16:26:46 +03:00