Air-gapped (офлайн) установка

Развёртывание Portal в сети без доступа в интернет.

Что передать клиенту

Полный дистрибутив:

portal-1.0.0-full.tar.gz

или отдельные bundle по выбранному каналу.

Дополнительно:

LICENSE.key
Документация docs-install/
Контрольные суммы (SHA256) — по запросу

Подготовка на площадке клиента

1. Перенос архива

USB / внутренний файловый сервер → сервер установки.

2. Распаковка

tar xzf portal-1.0.0-full.tar.gz
cd portal-1.0.0-full

3. Docker (рекомендуется для air-gapped)

tar xzf portal-1.0.0-docker-bundle.tar.gz
cd portal-1.0.0-docker-bundle

docker load -i images/portal-images.tar

# Опционально: сторонние образы (если не в tar)
# docker load -i images/postgres-valkey-seaweedfs.tar

cp portal.config.example.yaml portal.config.yaml
# отредактируйте секреты и домен

PORTAL_SKIP_WIZARD=1 ./portal-cli/portal-cli install --mode docker --yes
./portal-cli/portal-cli license activate --file /path/to/LICENSE.key

4. Kubernetes

tar xzf portal-1.0.0-k8s-bundle.tar.gz
cd portal-1.0.0-k8s-bundle

docker load -i images/portal-images.tar
# Импорт в registry кластера (Harbor/Nexus):
# docker tag portal/api:1.0.0 registry.corp.local/portal/api:1.0.0
# docker push ...

PORTAL_SKIP_WIZARD=1 ./portal-cli/portal-cli install --mode k8s --yes

При private registry обновите values.yaml:

imageRegistry: registry.corp.local

5. Native Linux

tar xzf portal-1.0.0-native-linux-amd64.tar.gz
# PostgreSQL, Redis, S3 — установлены заранее из локальных репозиториев

PORTAL_SKIP_WIZARD=1 ./portal-cli/portal-cli install --mode native --yes

Зависимости без интернета

Компонент	Источник
Docker Engine	ISO/RPM локального mirror
Kubernetes	Дистрибутив клиента (RKE2, k3s offline bundle)
PostgreSQL 16	RPM/DEB с локального mirror
Valkey/Redis	RPM/DEB
MinIO / S3	Локальный кластер хранения

Обновления offline

Получите новый portal-X.Y.Z-full.tar.gz
Backup (см. backup-restore.md)
docker load / замена пакетов
portal-cli upgrade --mode <канал>

Проверка целостности

sha256sum -c portal-1.0.0-full.tar.gz.sha256

Файл .sha256 поставляется вендором вместе с дистрибутивом.

Ограничения

Online license server (если включён в будущем) недоступен — используйте офлайн LICENSE.key
Collabora — перенесите образ collabora/code отдельно или отключите