77 lines
3.6 KiB
Markdown
77 lines
3.6 KiB
Markdown
# VERSIONS — taler-monitoring
|
|
|
|
Release history for the standalone **taler-monitoring** suite
|
|
(https://git.hacktivism.ch/hernani/taler-monitoring).
|
|
|
|
## Version scheme
|
|
|
|
Tags and `VERSION` use **MAJOR.FEATURE.FIX** (three components):
|
|
|
|
| Part | Meaning |
|
|
|------|---------|
|
|
| **MAJOR** | Breaking changes to CLI, layout, or host-agent contract |
|
|
| **FEATURE** | New capabilities (phases, HTML features, i18n packs, …) |
|
|
| **FIX** | Bugfixes and docs that do not add a feature |
|
|
|
|
Git tags: `vMAJOR.FEATURE.FIX` (e.g. `v1.7.0`). File `VERSION` omits the `v` prefix.
|
|
|
|
| Tag | Date (UTC) | Notes |
|
|
|-----|------------|--------|
|
|
| **v1.8.0** | *planned* | **L10n** packs for user-facing strings that need localization: **fr-CH** (FrancPaysan) and **de-CH** (hacktivism / Taler CH German). |
|
|
| **v1.7.0** | 2026-07-18 | **CLI version:** `./taler-monitoring.sh --ver` / `--version` / `-V` prints suite version, git commit, branch, and repo/tag/commit URLs. |
|
|
| **v1.6.0** | 2026-07-18 | **Mail monitoring:** phase `mail` (`check_mail.sh` + `mail-catalog.conf`) for **firefly** (taler.net, gnunet.org) and **pixel**/TSA (taler-systems.com, mail.anastasis.lu); MX/SMTP/IMAP/SPF/DMARC; host-agent `/taler-monitoring-mail*`. |
|
|
| **v1.5.0** | 2026-07-18 | **Mattermost monitoring:** phase `mattermost` (`check_mattermost.sh`) for `mattermost.taler.net` (SPA + `/api/v4/system/ping` + TLS); host-agent HTML `/taler-monitoring-mattermost*`; hourly timer. |
|
|
| **v1.4.1** | 2026-07-18 | **Docs/versioning:** canonical tree `~/src/taler-monitoring`; docs use generic ops/outside-runner wording (no client hostnames); tags always **MAJOR.FEATURE.FIX**. |
|
|
| **v1.3.4** | 2026-07-18 | Summary i18n, monpages code-21, aptdeploy rsync path. |
|
|
| **v1.3.3** | 2026-07-18 | GIT notes vs GUI notes; monpages in TESTS. |
|
|
| **v1.3.2** | 2026-07-18 | Suite paths only `~/src/taler-monitoring` (no admin-log suite tree). |
|
|
| **v1.3.1** | 2026-07-18 | monpages FQDN check + deploy no longer silent-skip. |
|
|
| **v1.3.0** | 2026-07-18 | Sticky bar suite version + Forgejo tag link. |
|
|
| **v1.2.0** | 2026-07-18 | Language selection: `--lang` / `TALER_MON_LANG` (en\|fr). |
|
|
| **v1.1.0** | 2026-07-18 | i18n chrome: English default; French for FrancPaysan. |
|
|
| **v1.0.0** | 2026-07-18 | Initial standalone release. |
|
|
|
|
Older short tags (`v1`, `v1.0`, `v1.1`, `v1.2`, `v1.3`) are obsolete; use the three-component tags above.
|
|
|
|
## Sticky bar version (v1.3.0+)
|
|
|
|
Generated HTML shows the installed release tag (e.g. `v1.7.0`) next to the host line.
|
|
Clicking opens the tag page on Forgejo:
|
|
|
|
`https://git.hacktivism.ch/hernani/taler-monitoring/src/tag/<tag>`
|
|
|
|
Resolved via `git describe --tags` after `update-suite.sh`, with fallback to the `VERSION` file.
|
|
|
|
## Public monitoring pages (v1.3.1+)
|
|
|
|
Host-agent must publish under `DEPLOY_WWW_ROOT` **and** the reverse proxy must `handle` the paths.
|
|
If not, public FQDNs return merchant **JSON code 21**.
|
|
|
|
| Check | How |
|
|
|-------|-----|
|
|
| Phase | `./taler-monitoring.sh monpages` (or `pages`) |
|
|
| Auto | host-agent default phases include `monpages`; post-check after HTML write |
|
|
| URLs | `https://$MON_HOSTS$HTML_URL_OK` |
|
|
|
|
On the stack host (e.g. koopa), publish + Caddy handles:
|
|
|
|
```bash
|
|
sudo ~/koopa-caddy/apply-monitoring-live.sh
|
|
```
|
|
|
|
## Language (v1.2.0+)
|
|
|
|
| Method | Example |
|
|
|--------|---------|
|
|
| CLI | `./taler-monitoring.sh --lang fr …` |
|
|
| Env | `TALER_MON_LANG=en` or `fr` |
|
|
| Auto | `*lefrancpaysan*` → fr, else en |
|
|
|
|
Full locale packs (fr-CH / de-CH) are scheduled for **v1.8.0**.
|
|
|
|
## Pin a release
|
|
|
|
```bash
|
|
git clone https://git.hacktivism.ch/hernani/taler-monitoring.git ~/src/taler-monitoring
|
|
cd ~/src/taler-monitoring && git checkout v1.7.0
|
|
```
|