Готовый пакет YAML для развёртывания Core ClashFlow в стороннем
кластере. Скачайте архив, заполните плейсхолдеры, примените по порядку.
Скачать: clashflow-k8s-core.zip
Общий контекст (реестр образов, Keycloak, лицензия) —
Core в Kubernetes. Windows-часть —
Windows Worker.
В пакет не входят: Seq (логи на Seq IT4BIM), Keycloak площадки
(свой IdP / отдельный чарт), Windows-службы (ставятся Admin-установщиком).
| Файл | Что создаёт |
|---|---|
00-namespace.yaml |
Namespace collisions |
01-secret.yaml |
Secret: Postgres, MinIO, лицензия сайта |
02-postgres.yaml |
PVC + StatefulSet PostgreSQL 16 |
03-minio.yaml |
PVC + StatefulSet MinIO |
04-api.yaml |
Deployment ApiService (+ imagePullSecrets) |
05-frontend.yaml |
Deployment Frontend |
06-services.yaml |
ClusterIP / headless Services |
07-ingress.yaml |
Ingress: один host, UI + API paths |
08-windows-worker-endpoints.yaml |
Service+Endpoints → IP Windows Worker |
kustomization.yaml |
Порядок для kubectl apply -k . |
README.md |
Краткая шпаргалка |
Исходники в репозитории: docs/wiki/04-deployment/k8s/.
Пройдите файлы и замените все CHANGE_ME… / example.com.
01-secret.yaml| Ключ | Сервис | Что указать |
|---|---|---|
POSTGRES_DB / POSTGRES_USER / POSTGRES_PASSWORD |
PostgreSQL | Имя БД, пользователь, свой пароль |
ConnectionStrings__DefaultConnection |
API | Тот же host collisions-postgres, те же user/password |
MINIO_ROOT_USER / MINIO_ROOT_PASSWORD |
MinIO | Root MinIO |
ClashImageStorage__* |
API | Endpoint collisions-minio:9000, те же ключи, bucket clash-images, UseSsl=false внутри кластера |
License__Username / License__Password / License__SiteId |
API | Учётка сайта от IT4BIM (license.site.*) |
Пароли в git/wiki не кладите — правьте локальную копию архива.
04-api.yaml| Параметр (env) | Назначение | Пример / правило |
|---|---|---|
image |
Образ API | …/backend:<ТЕГ> от IT4BIM |
imagePullSecrets |
Pull из GitLab | Secret gitlab-it4bim-registry (создать отдельно) |
Seq__ServerUrl |
Централизованные логи | URL Seq IT4BIM (как выдали при внедрении) |
Authentication__Authority |
Вход сотрудников | https://auth.ВАШ_ДОМЕН/realms/collisions |
Authentication__Audience |
JWT audience | Обычно collisions-api |
| Authority / ClientId лицензии | Зашиты в коде API | https://auth.it4bim.ru/realms/collisions-license / collisions-license — не задавать License__AuthorityUrl / License__ClientId в YAML |
License__Username/Password/SiteId |
Из Secret | см. выше |
CollisionReportServices__ModelInventoryServiceBaseUrl |
Bootstrap до UI-save | опционально; после Save в UI — Postgres |
CollisionReportServices__NavisReportServiceBaseUrl |
Bootstrap до UI-save | опционально |
CollisionReportServices__NwcExportServiceBaseUrl |
Bootstrap до UI-save | опционально |
ClashImageStorage__* |
Картинки | Из Secret |
БД и MinIO в Deployment не дублируются строками — только через Secret.
05-frontend.yaml| Параметр | Назначение |
|---|---|
image |
…/frontend:<ТЕГ> — тот же тег, что у API |
imagePullSecrets |
Тот же gitlab-it4bim-registry |
URL Keycloak / API для SPA обычно вшиты в образ при сборке релиза
под площадку или задаются согласованным способом с IT4BIM. Если на
пилоте вход не открывается — сверьте с IT4BIM конфиг Frontend под ваш
домен.
07-ingress.yaml| Поле | Что указать |
|---|---|
spec.rules[].host / tls.hosts |
Ваш DNS, например collisions.example.com |
tls[].secretName |
Secret с сертификатом (cert-manager или ручной) |
ingressClassName |
Обычно nginx |
| annotations timeout / body-size | Уже заданы под длинные импорты и отчёты |
Обязательные path на API: /api, /hubs, /scalar, /openapi,
/health, /alive. Остальное / → Frontend.
08-windows-worker-endpoints.yaml| Поле | Что указать |
|---|---|
subsets[].addresses[].ip |
IP Windows-машины Worker из сети, доступной подам |
| порты | 57439 Inventory, 57429 Report, 58429 Actualization |
Пока Worker не установлен — файл можно не применять (закомментирован в
kustomization.yaml). URL в API уже указывают на эти Service-имена.
При необходимости раскомментируйте storageClassName и задайте класс
хранилища площадки. Размеры по умолчанию: Postgres 50Gi, MinIO 100Gi
(см. также Железо).
kubectl create namespace collisions
kubectl -n collisions create secret docker-registry gitlab-it4bim-registry \
--docker-server=registry.gitlab.it4bim.ru \
--docker-username='CHANGE_ME' \
--docker-password='CHANGE_ME' \
--docker-email='deploy@example.com'
Подробнее: Core в Kubernetes §2.
01-secret.yaml, теги образов в 04-api.yaml / 05-frontend.yaml,07-ingress.yaml, Authority Keycloak в 04-api.yaml.Рекомендуемый порядок вручную (если не используете kustomize):
kubectl apply -f 00-namespace.yaml
kubectl apply -f 01-secret.yaml
kubectl apply -f 02-postgres.yaml
kubectl apply -f 03-minio.yaml
kubectl apply -f 06-services.yaml
# Дождаться Ready:
kubectl -n collisions rollout status statefulset/collisions-postgres
kubectl -n collisions rollout status statefulset/collisions-minio
kubectl apply -f 04-api.yaml
kubectl apply -f 05-frontend.yaml
kubectl apply -f 07-ingress.yaml
kubectl -n collisions rollout status deployment/collisions-api
kubectl -n collisions rollout status deployment/collisions-frontend
Или одной командой из каталога пакета:
kubectl apply -k .
kubectl -n collisions get pods,svc,ingress
curl -fsS https://collisions.example.com/health
curl -fsS https://collisions.example.com/alive
Откройте UI и {API}/scalar. Настройте Keycloak площадки и лицензию —
см. Core в Kubernetes.
https://inventory.example.com), откройте «/scalar»08-windows-worker-endpoints.yaml / отдельный Ingress на host/scalar (не обход SPA).| Параметр | Postgres | MinIO | API | Frontend | Ingress | Worker endpoints |
|---|---|---|---|---|---|---|
| Пароль БД | ✓ | ✓ (connection) | ||||
| Пароль MinIO | ✓ | ✓ (ClashImage*) | ||||
| Лицензия сайта | ✓ | |||||
| Keycloak Authority | ✓ | (образ) | ||||
| Тег образа GitLab | ✓ | ✓ | ||||
| imagePullSecret | ✓ | ✓ | ||||
| Seq IT4BIM URL | ✓ | |||||
| DNS / TLS | ✓ | |||||
| IP Windows | URL Service | ✓ | ||||
| Порты 57439/57429/58429 | ✓ |
kubectl -n collisions set image deployment/collisions-api \
api=registry.gitlab.it4bim.ru/it4bim/it4bim.collisions/backend:<НОВЫЙ_ТЕГ>
kubectl -n collisions set image deployment/collisions-frontend \
frontend=registry.gitlab.it4bim.ru/it4bim/it4bim.collisions/frontend:<НОВЫЙ_ТЕГ>
Перед мажором — бэкап PVC Postgres (и MinIO при необходимости).
| Симптом | Действие |
|---|---|
ImagePullBackOff |
Secret gitlab-it4bim-registry, тег, firewall до registry |
| API CrashLoop, БД | Secret connection string vs Postgres user/password; PVC Ready |
| Картинки не грузятся | MinIO keys в Secret = root MinIO; bucket |
502 на /api |
Порядок path в Ingress, Service collisions-api:8080 |
| Дерево моделей пустое | Файл 08-…, IP Worker, учётка служб на UNC |
| Невалидный Endpoints | Заменили CHANGE_ME_WINDOWS_WORKER_IP на реальный IP до apply |