Skip to content

Kubernetes (Helm) ​

Требования ​

  • Kubernetes-кластер и Helm 3
  • Ingress-контроллер ingress-nginx; аннотации в примере values.yaml относятся к нему
  • PostgreSQL 15 (поддерживается 14) с базами приложения и ai-core (flip_ai_core), Valkey 9 (standalone-режим), S3-совместимое хранилище, развёрнутые отдельно и доступные из кластера
  • Два DNS-имени и TLS-сертификаты: приложение (example.flip-chart.ru) и MCP-сервер (mcp.example.flip-chart.ru)
  • Учётные данные SMTP-сервера
  • Исходящий доступ из кластера по HTTPS к ai.flip-chart.ru для AI-функций (ai-core)

Состав чарта ​

СабчартОбразПортIngress
backendflip-backend9000/app/api, /app/api/v1/ws, /app/api/v1/flip/backup/upload, редирект /
ai-coreflip-ai-core9100—
file-handlersflip-file-handlers8080—
frontendflip-frontend80/app, /app/s3/ → S3-хранилище
mcp-serverflip-mcp-server8090mcp.example.flip-chart.ru/

Helm-чарт ​

bash
helm registry login cr.yandex --username json_key --password-stdin < credentials/authorized_key.json
helm show chart oci://cr.yandex/crpbj8irels1kqult74e/onpremise/flip-chart --version 1.2.0
helm show values oci://cr.yandex/crpbj8irels1kqult74e/onpremise/flip-chart --version 1.2.0 > values.yaml

Пример values.yaml совпадает с helm show values.

Файлы поставки ​

├── credentials
│   ├── authorized_key.json      — ключ доступа к реестру образов и Helm-чарта
│   └── License_key.txt          — лицензионный ключ приложения
└── deploy
    ├── docker-compose
    │   └── config               — примеры конфигурационных файлов сервисов
    └── kubernetes
        └── values.yaml          — пример values

Шаги установки ​

1. Namespace и доступ к реестру ​

bash
kubectl create namespace flip
kubectl -n flip create secret docker-registry registrykey \
  --docker-server=cr.yandex \
  --docker-username=json_key \
  --docker-password="$(cat credentials/authorized_key.json)"

2. TLS-сертификаты ​

bash
kubectl -n flip create secret tls flip-tls     --cert=crt.pem     --key=key.pem
kubectl -n flip create secret tls flip-mcp-tls --cert=mcp-crt.pem --key=mcp-key.pem

При использовании cert-manager его аннотации указываются в ingress соответствующих сабчартов; имена секретов сохраняются.

3. Конфигурационные файлы ​

Заполните конфигурации по описаниям: backend, ai-core, file-handlers, frontend, mcp-server.

Адреса внутри кластера

Примеры конфигураций рассчитаны на docker-compose. В Kubernetes сервисы адресуются по именам Service чарта:

Полеdocker-composeKubernetes
backend → FileHandlerServiceConfig.Addresshttp://flip-file-handlers:8080/apihttp://file-handlers.flip.svc.cluster.local:8080/api
backend → AI.LocalCore.BaseURLhttp://flip-ai-core:9100http://ai-core.flip.svc.cluster.local:9100
mcp-server → flipApi.internalUrlhttp://flip-backend:9000http://backend.flip.svc.cluster.local:9000

flip в адресе — namespace установки (namespace релиза -n или global.namespace). Адреса PostgreSQL, Valkey и S3 — внешних сервисов.

Создайте секреты с конфигурациями (имена секретов и ключей должны совпадать с volumes/volumeMounts в values):

bash
kubectl -n flip create secret generic backend-config       --from-file=config.yaml=config/backend/config.yaml
kubectl -n flip create secret generic file-handlers-config --from-file=config.yaml=config/file-handlers/config.yaml
kubectl -n flip create secret generic frontend-config       --from-file=config.js=config/frontend/config.js
kubectl -n flip create secret generic mcp-server-config    --from-file=config.yaml=config/mcp-server/config.yaml
kubectl -n flip create secret generic ai-core-config       --from-file=config.yaml=config/ai-core/config.yaml \
  --from-literal=POSTGRES_DSN='postgres://flip:secret-passwd@postgres.example.ru:5432/flip_ai_core?sslmode=require'

База flip_ai_core создаётся на сервере PostgreSQL заранее: CREATE DATABASE flip_ai_core OWNER flip;. Ключ POSTGRES_DSN секрета ai-core-config — строка подключения к ней (формат).

Обновление конфигурации

bash
kubectl -n flip create secret generic backend-config --from-file=config.yaml=config/backend/config.yaml \
  --dry-run=client -o yaml | kubectl apply -f -

4. S3-хранилище ​

  • Создайте бакет и разрешите анонимное чтение объектов.
  • Загрузите медиа-ресурсы: распакуйте deploy/sources/s3-assets.tar и загрузите содержимое в корень бакета (каталоги app, flip-shape-sets, flip-templates, gifs, logo, spaces).
  • В values.yaml укажите хост хранилища в frontend.service.s3.storageurl. Чарт создаёт Service типа ExternalName и Ingress /app/s3/(.*), проксирующий запросы к хранилищу через домен приложения.

5. values.yaml ​

Отредактируйте values.yaml: домены (tlshosts, permanent-redirect), имена TLS-секретов, хост S3, версию образов (image.tag, единая для всех компонентов), ресурсы. Описание параметров — в разделе Параметры values.yaml.

6. Установка ​

bash
helm registry login cr.yandex --username json_key --password-stdin < credentials/authorized_key.json
helm install flip oci://cr.yandex/crpbj8irels1kqult74e/onpremise/flip-chart --version 1.2.0 -f values.yaml -n flip

7. Проверка ​

bash
kubectl -n flip get pods
kubectl -n flip get ingress

Все поды должны быть в состоянии Running. Приложение доступно по адресу https://example.flip-chart.ru/app. Дальнейшие действия — первый запуск.

Параметры values.yaml ​

global ​

ПараметрОписание
global.namespaceNamespace установки. Пустое значение — namespace релиза (helm -n).
global.imagePullSecretsСписок секретов доступа к реестру образов.

Общие параметры сабчартов ​

Одинаковы для backend, ai-core, file-handlers, frontend, mcp-server.

ПараметрОписание
enabledВключение компонента.
replicaCountКоличество реплик.
image.repository, image.tag, image.pullPolicyОбраз компонента.
annotationsАннотации Deployment и подов.
affinity, tolerations, nodeSelectorРазмещение подов.
strategyСтратегия обновления Deployment (RollingUpdate, Recreate).
containers.containerPortПорты контейнера.
containers.readinessProbe, containers.livenessProbe, containers.startupProbeПробы контейнера. В примере — tcpSocket на порт сервиса (у backend readiness — httpGet /metrics, у ai-core — httpGet /readyz и /healthz на порт 9102). При замене типа пробы прежний тип указывается как null, например tcpSocket: null.
env, envFromПеременные окружения. У ai-core — POSTGRES_DSN из секрета ai-core-config.
service.enabled, service.type, service.portsKubernetes Service.
resourcesЗапросы и лимиты CPU/памяти.
volumes, volumeMountsМонтирование секрета с конфигурацией. Путь внутри контейнера фиксирован (см. конфигурационные файлы).
securityContextКонтекст безопасности контейнера.
podSecurityContextКонтекст безопасности пода.
serviceMonitor.enabledServiceMonitor для Prometheus Operator (backend, file-handlers).
terminationGracePeriodSecondsВремя на остановку пода (ai-core, по умолчанию 120 секунд).

Ingress ​

ПараметрОписание
backend.ingress.ingressClassNameКласс Ingress-контроллера.
backend.ingress.tlshosts, backend.ingress.tlssecretДомен приложения и TLS-секрет.
backend.ingress.externalREST API /app/api.
backend.ingress.websocketWebSocket /app/api/v1/ws и вложенные пути (/ws/space, /ws/document), тайм-ауты 86400s.
backend.ingress.uploadИмпорт досок /app/api/v1/flip/backup/upload, лимит тела 6G, тайм-ауты 3600s.
backend.ingress.redirectРедирект / → /app; домен задаётся в аннотации permanent-redirect.
frontend.ingress.uiИнтерфейс /app.
frontend.ingress.s3Проксирование S3 /app/s3/(.*) на Service frontend-s3; для хранилища по HTTPS требуются аннотации backend-protocol: "HTTPS" и upstream-vhost.
frontend.service.s3.storageurlХост S3-хранилища для Service ExternalName.
mcp-server.ingressMCP-сервер на отдельном домене tlshosts/tlssecret.

Обновление ​

bash
helm upgrade flip oci://cr.yandex/crpbj8irels1kqult74e/onpremise/flip-chart --version 1.2.0 -f values.yaml -n flip
kubectl -n flip get pods

Порядок обновления версий — в разделе Обновления.

Удаление ​

bash
helm uninstall flip -n flip
kubectl delete namespace flip

Документация flip On-Premise и Cloud