Commit Graph
839 Commits
Author SHA1 Message Date
Mike Hillyer cf7f5843ab Add a stronger warning that the quickstart does not produce production-ready installs. 2024-07-05 10:58:37 -04:00
Mike Hillyer c42536ee77 Updating the quickstart tutorial. 2024-07-05 09:48:20 -04:00
Wez Furlong f7604a3f7f docs: cut over toml examples to toml_data data macro
refs: https://github.com/KumoCorp/kumomta/issues/212
2024-07-03 16:09:52 -07:00
Wez Furlong aa22e788c9 mkdocs: make build the default command, rather than serve
This makes it easier to run in woodpecker
2024-07-03 15:37:27 -07:00
Wez Furlong d416b31af9 docs: add toml_data macro
This macro allows embedding TOML data into the docs,
and showing it in a tab that has both the TOML and JSON
representation of that data.

It works by executing the toml2jsonc helper that was added
in an earlier commit.

There's some machinery here to compile that utility to run
in the context of the mkdocs docker image; that works
locally, let's see how well it works in CI!

Usage is simple; before:

```toml
["something"]
foo = "bar"
```

after:

{% call toml_data() %}
["something"]
foo = "bar"
{% endcall %}

The first page to get switched over to this is https://docs.kumomta.com/tutorial/configuring_kumomta/

refs: https://github.com/KumoCorp/kumomta/issues/212
2024-07-03 14:59:52 -07:00
Wez Furlong e49985ff54 logging: capture incoming SMTP command line for Rejections 2024-07-03 06:46:01 -07:00
Wez Furlong acdb8e36d4 docs: add some diagrams to the deployment architecture page
I noticed that this page was totally blank; let's add some
useful content here!

refs: https://github.com/KumoCorp/kumomta/issues/214
2024-07-01 09:50:24 -07:00
Wez Furlong ca3339cebb docs: remove "building docker image" from "using docker" docs
It doesn't fit there, and the topic is a bit more complex
than that brief summary.
2024-07-01 07:21:08 -07:00
Wez Furlong ef8cbea354 docs: fixup links to the rapidoc http page 2024-06-27 19:56:53 -07:00
Wez Furlong 49facb4d0a docs: fixup amqp docs some more 2024-06-27 19:51:09 -07:00
Wez Furlong 5b0d936ef7 docs: improve markdown output for the kcli help 2024-06-27 15:40:39 -07:00
Wez Furlong fa2c6225e8 docs: add kcli reference docs
These are automatically extracted from `kcli --help`.
2024-06-27 15:18:07 -07:00
Wez Furlong 5d7cf4005f docs: fixup AMQP example 2024-06-27 09:42:36 -07:00
Wez Furlong d66d6bd750 docs: fix link 2024-06-27 08:39:03 -07:00
Wez Furlong e683fed556 docs: move Log Record to its own reference page
This makes it a bit easier to find and link to.
2024-06-27 08:28:45 -07:00
Wez Furlong 7330721766 docs: changelog for #211 and kumod --validate 2024-06-27 07:02:10 -07:00
Wez Furlong f8c3429738 serde: move json/toml to new kumo.serde module. Added YAML.
This helps to avoid bloating kumo-server-common, and makes it
easier to group related functions together in the docs.

The original names are still usable; we'll remove them in a
future release.
2024-06-26 11:08:15 -07:00
Wez Furlong 4083afa672 docs: add faq entry for queue flushing 2024-06-24 15:04:12 -07:00
Wez Furlong a2d76df7a9 NEW: rebind API and kcli subcommand
refs: https://github.com/KumoCorp/kumomta/issues/209
2024-06-24 12:26:06 -07:00
Wez Furlong 10bb7f2717 Add some string and regex functions
closes: https://github.com/KumoCorp/kumomta/issues/220
2024-06-21 17:20:04 -07:00
Mike Hillyer 53820402ba Killing off some orphans. 2024-06-20 17:55:52 -04:00
Wez Furlong 6f83f69236 docs: markdown <ol> is tricky, just use bullets/<ul> 2024-06-20 08:38:56 -07:00
Wez Furlong 7fc8dd97e6 docs: discuss creating an always-suspended queue
closes: https://github.com/KumoCorp/kumomta/issues/210
2024-06-20 08:35:17 -07:00
Mike Hillyer 77f9830513 Fix warning in the webhooks page 2024-06-19 16:55:52 -04:00
Mike Hillyer f957d812c1 Add the response rewrite page to the TOC. 2024-06-19 16:35:53 -04:00
Mike Hillyer 43e7023e72 Updated rewriting page for the User Guide. 2024-06-19 15:39:31 -04:00
giuliano-mendez 2c307d4e41 Fix typo 2024-06-19 08:39:23 -07:00
Wez Furlong 015fad5e4f Revert "Add page on rewriting remote server responses to the User Guide."
This reverts commit 82a258a92e0e0eef6c7e483ab25f71146cdfeea3; that new
page is incomplete and has invalid syntax.

Let's take it out for now to unblock the doc build.
2024-06-19 08:37:11 -07:00
Mike Hillyer 82a258a92e Add page on rewriting remote server responses to the User Guide. 2024-06-19 10:13:40 -04:00
Wez Furlong e1d0eb60fd docs: clarify conformance issue description in changelog 2024-06-18 07:38:15 -07:00
Wez Furlong a20ba45520 docs: changelog for #217 2024-06-18 07:35:09 -07:00
Wez Furlong 626a7608e4 Fix bad message-id breaking message rebuild
The issue only triggered when there were issues that required
rebuilding the message body in addition to the bad header.

The fix here is to silently ignore any header parsing errors
during a rebuild.

closes: #216
2024-06-17 13:50:53 -07:00
Wez Furlong 0e401a4b9b ci: fixup docs build
The symlink switcheroo needs to happen sooner
2024-06-12 15:17:54 -07:00
Wez Furlong 7db3bb5eae docs: mention multiarch docker image in the changelog 2024-06-12 15:09:55 -07:00
Wez Furlong 20e7d1052f ci: fixup doc build for new cache dir structure 2024-06-12 12:38:26 -07:00
Wez Furlong c9b98adc10 ci: cache target dir directly 2024-06-12 12:19:29 -07:00
Mike Hillyer 88cdfce76f Fix broken link in the config section of the Tutorial. 2024-06-11 17:26:17 -04:00
Mike Hillyer b24c67ff59 Update install tutorial to point to the User Guide for users not on Rocky. 2024-06-11 14:49:21 -04:00
Wez Furlong 261999bde0 fix: dkim signer must set time before setting expiry
otherwise an error will always be thrown
2024-06-11 06:53:27 -07:00
Mike Hillyer 74a0f2be5b Adding reference to the ARM Docker container to the changelog. 2024-06-10 14:06:09 -04:00
Wez Furlong f392c1d481 docs: update for latest release 2024-06-10 09:36:23 -07:00
Wez Furlong 8673045fff docs: update for latest release 2024-06-10 09:30:17 -07:00
Wez Furlong 29e4ec312d provide helpful reminder that bouncing is async
closes: https://github.com/KumoCorp/kumomta/issues/191
2024-05-30 16:46:03 -07:00
Wez Furlong 1530c6c02e fix: panic if rcpt to issued outside of a transaction 2024-05-18 08:47:36 -07:00
Wez Furlong cbcf5746f5 docs: fix broken doc build 2024-05-17 07:50:03 -07:00
Wez Furlong 03dfa7e870 docs: changelog for https://github.com/KumoCorp/kumomta/pull/179 2024-05-17 07:49:48 -07:00
Wez Furlong a55f726471 docs: utopia openapi doc description updates
The auto-generator changed how it splits the brief/full description
up when rendering it into the openapi spec.
2024-05-17 07:44:39 -07:00
Wez Furlong 8cdadb036c ready_queue: fixup connection goal calculation
I noticed this recently during some testing; for large queue sizes
and large connection limits, we could end up opening more connections
than we currently have queued messages to deliver.

The issue was that the `.min()` constraint was placed on the wrong
term of the calculation, clamping prior to scaling, instead of
after scaling.
2024-05-07 07:24:46 -07:00
Wez Furlong b8a0b26936 NEW: kcli top
This will shows some TUI sparkline charts of major system metrics
over time.
2024-05-04 13:13:09 -07:00
Wez Furlong e48bcd3b57 return 550 for relay_to=false, log_oob=true case
When `log_arf` or `log_oob` are set to true with `relay_to=false`, we
now return a 550 error response for messages that are not ARF or OOB
reports.  Previously, we would return a 250 response and silently drop
the message in this case, which gave the false impression that it was
accepted for relaying.

Expand integration test to explicitly assert that the right things
are allowed/denied/relayed/parsed.
2024-05-02 11:45:07 -07:00