Update Home wiki page with project documentation

Oleks
2026-05-20 12:34:35 +03:00
parent 5a3915510b
commit ea517f1b89
+16 -7
@@ -1,11 +1,14 @@
## Що це
# Що це
Каталог CMS-плагінів, побудований на Emdash (Astro 6 + TypeScript + SQLite). Початкові дані — матриця сумісності плагінів WordPress → Emdash з проєкту `kotkanagrilli.fi`. Нові записи додаються через адмін-панель Emdash (`/_emdash/admin`).
Каталог CMS-плагінів, побудований на Emdash (Astro 6 + TypeScript + SQLite).
Початкові дані — матриця сумісності плагінів WordPress → Emdash з проєкту
`kotkanagrilli.fi`. Нові записи додаються через адмін-панель Emdash
(`/_emdash/admin`).
## Репозиторії
| Репозиторій | Опис |
|---|---|
| --- | --- |
| `oleks/cms-plugins` (git.oleks.space) | Цей репозиторій: вихідний код, Dockerfile, Helm-чарт, пайплайн Woodpecker |
| `oleks/emdash-kotkanagrilli` | Референсний Emdash-деплой, структуру якого копіює цей репозиторій |
| `oleks/kotkanagrilli.fi` | Оригінальний WordPress-сайт, звідки взяті початкові дані плагінів |
@@ -14,16 +17,18 @@
## Середовища
| Гілка | Середовище | Кластер | URL |
|---|---|---|---|
| --- | --- | --- | --- |
| `develop` | Локальний DDEV | Хост розробника | `https://cms-plugins.ddev.site/` |
| `staging` | Staging k3s | Вузол `kotkan` | `https://cms-plugins-staging.kotkanagrilli.fi/` |
| `production` | Production k3s | Вузол `kotkan` | `https://cms-plugins-production.kotkanagrilli.fi/` |
## CI/CD
Woodpecker (`ci.oleks.space`), репо `oleks/cms-plugins`, пайплайн `.woodpecker/container.yaml`.
Woodpecker (`ci.oleks.space`), репо `oleks/cms-plugins`, пайплайн
`.woodpecker/container.yaml`.
Кожен push до `staging` або `production` збирає Docker-образ (arm64) і публікує три теги до реєстру `git.oleks.space/oleks/cms-plugins`:
Кожен push до `staging` або `production` збирає Docker-образ (arm64) і
публікує три теги до реєстру `git.oleks.space/oleks/cms-plugins`:
- `0.1.<номер>` — незмінний тег версії
- `<гілка>` — плаваючий тег гілки
@@ -31,9 +36,11 @@ Woodpecker (`ci.oleks.space`), репо `oleks/cms-plugins`, пайплайн `.
## Кластер
Усі ресурси (HelmRelease, GitRepository, ImagePolicy, Secret, поди) розміщені в namespace `kotkan` на кластері armer/kotkan.
Усі ресурси (HelmRelease, GitRepository, ImagePolicy, Secret, поди)
розміщені в namespace `kotkan` на кластері armer/kotkan.
Flux-маніфести знаходяться в `anton/helm-workloads` у директоріях:
- `cms-plugins-staging/`
- `cms-plugins-production/`
@@ -42,6 +49,7 @@ Flux-маніфести знаходяться в `anton/helm-workloads` у ди
Зашифровані через sops (age) у `anton/helm-workloads`.
Кожне середовище має:
- `cms-plugins-deploy-key` — SSH-ключ для Flux
- `cms-plugins-<env>-secrets` — містить `EMDASH_ENCRYPTION_KEY`
@@ -76,5 +84,6 @@ git switch production && git merge --ff-only staging && git push origin producti
## Детальніша документація
Див. також:
- `DEPLOYMENT.md` — повне описання пайплайну
- `ARCHITECTURE.md` — контракти чарту, образу, Flux