Установка — КАСКАД 360

Содержание

1. Системные требования
2. Установка ядра (Linux x86_64)
3. Конфигурация (config.yml)
4. Первичная настройка (setup)
5. База данных и источники
6. Сервисы и маршрутизация
7. Центр обновлений (1.0.2)
8. Проверка работоспособности

Версия 1.0.2 доступна для запуска и распространения. Инструкция описывает установку ядра, настройку БД, запуск админ-панели, центр обновлений и базовую проверку API.

1. Системные требования

Минимальные требования

Компонент	Требование
ОС	Linux x86_64 (Ubuntu 20.04+, CentOS 8+, и др.), Windows 10+, macOS 12+
ОЗУ	от 512 МБ (рекомендуется 2 ГБ)
Диск	от 500 МБ свободного места
СУБД	MySQL 8.0+ или PostgreSQL 14+

2. Установка ядра (Linux x86_64)

Рекомендуемый способ для Linux — скачать готовый дистрибутив и распаковать его на сервере.

2.1. Скачивание архива

# Скачать архив (wget)
wget https://cascad360.ru/downloads/core/1.0.2/cascad360-1.0.2-linux-x86_64.tar.gz

# или через curl
curl -LO https://cascad360.ru/downloads/core/1.0.2/cascad360-1.0.2-linux-x86_64.tar.gz

2.2. Распаковка и установка

# Распаковать архив
tar -xzf cascad360-1.0.2-linux-x86_64.tar.gz

# Перейти в каталог
cd cascad360-1.0.2-linux-x86_64

# (Опционально) Установить в /opt для всех пользователей
# sudo mv cascad360-1.0.2-linux-x86_64 /opt/cascad360
# cd /opt/cascad360

2.3. Запуск

# Запуск шлюза (из каталога распакованного архива)
./cascad360 start

# или, если исполняемый файл в подкаталоге bin:
# ./bin/cascad360 start

После запуска шлюз доступен по адресу http://localhost:5000. Админ-панель: http://localhost:5000/admin

Прямая ссылка на скачивание: cascad360-1.0.2-linux-x86_64.tar.gz

3. Конфигурация

Основной файл конфигурации — config.yml в корне проекта.

# config.yml — минимальный пример для версии 1.0.2

app:
  name: Контур
  version: 1.0.2
  beta: false
  setup_completed: false

web:
  host: 0.0.0.0
  port: 5000

database:
  driver: mysql            # mysql или postgresql
  host: localhost
  port: 3306               # 5432 для postgresql
  database: cascad360
  username: cascad_user
  password: change-me

sessions:
  cookie_name: CASCAD360_SESSION
  cookie_secure: false
  cookie_httponly: true

updates:
  registry_url: https://cascad360.ru/registry
  download_base_url: https://cascad360.ru/downloads
  channel: stable
  execution_mode: dry_run

Важно: обязательно измените secret_key и пароль БД перед использованием в продакшене.

4. Первичная настройка (setup)

После первого запуска откройте мастер настройки по адресу http://localhost:5000/setup. Мастер:

Проверяет и сохраняет параметры подключения к БД
Создаёт первую учётную запись администратора
Сохраняет базовые параметры приложения
Завершает настройку (setup_completed: true)

В версии 1.0.2 нет жёсткого дефолтного логина/пароля — администратор создаётся в мастере setup.

5. База данных и источники

Одна база данных

По умолчанию используется одно подключение, указанное в config.yml. Этого достаточно для большинства сценариев.

Несколько источников данных

Для внешнего API БД доступны источники данных (datasource_id). Минимально используйте core, дополнительные источники добавляются в конфигурации окружения.

{
  "query": "SELECT id, username FROM users LIMIT %s",
  "params": [10],
  "datasource_id": "core"
}

В API-запросах указывайте datasource_id для выбора подключения.

Текущий фокус: распространение бесплатной версии и сбор обратной связи по реальным сценариям внедрения.

6. Сервисы и маршрутизация

В версии 1.0.2 управление сервисами обычно выполняется через админ API и интерфейс. Ключевые маршруты:

GET  /api/v1/admin/services/list
GET  /api/v1/admin/services/{service_name}/status
POST /api/v1/admin/services/{service_name}/scale

GET  /api/v1/admin/routing/rules
POST /api/v1/admin/routing/rules
POST /api/v1/admin/routing/reload

7. Центр обновлений (1.0.2)

Начиная с версии 1.0.2 доступен центр обновлений через админ API. Он поддерживает проверку каталога релизов, создание задач обновления и rollback с контролем безопасности.

# Проверить доступные обновления
curl -b cookies.txt "http://localhost:5000/api/v1/admin/updates/check?channel=stable"

# Проверить readiness перед production rollout
curl -b cookies.txt "http://localhost:5000/api/v1/admin/updates/readiness"

# Создать задачу обновления ядра
curl -X POST http://localhost:5000/api/v1/admin/updates/core \
  -b cookies.txt \
  -H "Content-Type: application/json" \
  -d '{"artifact_id":"cascad360-core","version":"1.0.2"}'

Для production рекомендуется включить строгую политику источников и подписи релизов в секции updates конфигурации.

8. Проверка работоспособности

# Проверка здоровья шлюза
curl http://localhost:5000/api/health

# Ожидаемый ответ:
# {"status":"ok","version":"1.0.2"}

# Проверка авторизации в админ API (сессия)
curl -X POST http://localhost:5000/api/v1/admin/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "your-password"}'

# Проверка внешнего API к БД (по API-ключу)
curl -X POST http://localhost:5000/api/v1/db/query \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "SELECT 1 as ok"
  }'

Подробное описание API — на странице Документация API.

Перейти к документации API Отправить обратную связь

Установка КАСКАД 360