Какой вариант установки выбрать

Эта страница помогает выбрать способ установки Portal до того, как вы начнёте команды.

Читайте сверху вниз. В конце — ссылки на пошаговые инструкции под ваш вариант.

Если вы уже знаете, что ставите через Docker — сразу откройте Быстрый старт: Docker.

0. Что такое «канал установки»

Portal поставляется тремя способами (каналами). Это не три разных продукта, а три способа запустить один и тот же Portal на сервере.

Канал	Простыми словами	Типичная команда
Docker	Всё крутится в контейнерах на одном сервере	`./portal-cli/portal-cli install --mode docker`
Kubernetes / Helm	То же в кластере (несколько машин, отказоустойчивость)	`./portal-cli/portal-cli install --mode k8s`
Native	Без Docker: службы ОС (Linux systemd или Windows)	Linux: `--mode native`; Windows: `portal-cli.ps1`

Файл лицензии LICENSE.key привязан к каналу. Ключ для Docker не подойдёт к Kubernetes и наоборот. Подробнее: Лицензии и тарифы.

1. Ответьте на три вопроса

Вопрос 1. Разрешены ли контейнеры?

Ответ	Что выбрать
Да, Docker / Kubernetes можно	Docker или Kubernetes (см. вопрос 2)
Нет, политика «только обычные службы ОС»	Native (Linux или Windows)

Вопрос 2. Один сервер или кластер?

Ситуация	Рекомендация
Пилот, демо, один сервер	Docker
До ~3000 пользователей, нет опыта с Kubernetes	Docker (при нагрузке — с флагом `--prod`)
Нужна отказоустойчивость, 10 000+ пользователей, уже есть Kubernetes	Kubernetes / Helm
Уже есть корпоративные PostgreSQL, Redis, S3	Любой канал, но с внешними сервисами — см. Внешние сервисы

Вопрос 3. Какая ОС у сервера?

ОС	Что доступно
Linux	Docker, Kubernetes, Native Linux
Windows Server без Docker	Только Native Windows
Windows с Docker Desktop	Обычно ставят Portal на Linux-сервер; Native Windows — если контейнеры запрещены

2. Матрица «ситуация → вариант»

Ситуация	Рекомендуемый вариант	Дальше читайте
Быстрый пилот на одном сервере	Docker	Быстрый старт: Docker
Нет опыта с Kubernetes, до ~3000 пользователей	Docker (+ при необходимости `--prod`)	Быстрый старт: Docker
Нужна отказоустойчивость, 10K+ пользователей	Kubernetes / Helm	Быстрый старт: Kubernetes
Политика «контейнеры запрещены», Linux	Native Linux	Быстрый старт: Native Linux
Windows Server без Docker	Native Windows	Быстрый старт: Native Windows
Уже есть PostgreSQL, Redis, корпоративный S3	Docker, Native или K8s с внешними сервисами	Внешние сервисы
Сервер без интернета	Тот же канал, но офлайн-сценарий	Air-gapped установка

3. Docker Compose — самый частый выбор

Плюсы:

Простая установка из готового архива (bundle).
Полный стек «из коробки» (база, кэш, файлы, сайт, API).
Portal Office (редактор документов) уже в образах.

Минусы:

Масштабирование вручную (например --scale).
Нет встроенной отказоустойчивости как в Kubernetes.

Как выглядит успешный выбор: у вас есть Linux-сервер с Docker, вы скачали файл вида portal-1.0.0-docker-bundle.tar.gz.

Команда установки (из каталога после распаковки):

./portal-cli/portal-cli install --mode docker

Пошагово: Быстрый старт: Docker.

4. Kubernetes / Helm

Плюсы:

Отказоустойчивость (HA), автомасштабирование (HPA).
Стандарт для крупных внедрений.
Portal Office входит в поставку образов.

Минусы:

Нужен администратор Kubernetes.
Выше порог входа (Ingress, StorageClass, registry).

Как выглядит успешный выбор: есть кластер Kubernetes 1.28+, Helm, kubectl, Ingress Controller.

Пошагово: Быстрый старт: Kubernetes.

5. Native (без Docker)

Плюсы:

Соответствует политикам «контейнеры запрещены».
Удобнее подключить уже существующую БД и S3.
При разработке своих расширений проще подключать отладчик к процессам Api/Worker.

Минусы:

Установка сложнее, чем Docker.
Portal Office не входит в native-бандл. Его скачивают отдельно с korport.ru/portal-office или редактор отключают. См. Portal Office.

ОС	Инструкция
Linux	Быстрый старт: Native Linux
Windows	Быстрый старт: Native Windows

6. Portal Office по каналам

Portal Office — встроенный редактор документов (Word/Excel/…). Это не отдельный тариф.

Канал	Linux	Windows
Docker / Kubernetes	Уже в bundle	Сервер обычно Linux/кластер
Native	Пакет systemd или Docker с korport.ru/portal-office	Только Docker Desktop или Office на отдельном Linux

Подробности: Portal Office.

7. Что общее для всех вариантов

Независимо от канала:

Лицензия — один формат файла LICENSE.key от поставщика. Без активации запись в Portal недоступна.
Миграции БД — через компонент Portal.DbInit (установщик запускает сам).
Версия продукта — в браузере/API: GET /api/v1/system/version; в поставке также файл RELEASE. Обновление: Обновление Portal.
Пробный период — 30 дней по подписанному trial-ключу от поставщика.
Тарифы зависят от канала (для Native — ещё и от платформы Linux/Windows). Цены: korport.ru/pricing. Модель: Лицензии и тарифы.
Расширения — через Extension SDK. Отладка по каналам: Отладка расширений.

8. Как проверить, что вы выбрали правильно

Перед скачиванием дистрибутива убедитесь:

Проверка	Ожидание
Канал в заявке / договоре	Совпадает с тем, что будете ставить (`docker` / `k8s` / `native`)
Имя файла bundle	Docker: `…-docker-bundle.tar.gz`; K8s: `…-k8s-bundle.tar.gz`; Native Linux: `…-native-linux-…`; Native Windows: `…-native-windows-…`
На сервере есть нужное ПО	Docker 24+ или kubectl+Helm или права ставить systemd/IIS

Если канал лицензии и способ установки разойдутся, Portal заблокирует запись (402 LICENSE_CHANNEL_MISMATCH). Это нормальная защита, не «поломка».

9. Что делать дальше

Выберите строку в матрице §2.
Получите у поставщика bundle и (при необходимости) trial/LICENSE.key.
Откройте соответствующий быстрый старт и идите по шагам сверху вниз.
После установки — активация лицензии.
Обновления позже: Обновление Portal.
Закрытый контур: Air-gapped установка.