vault backup: 2025-03-01 22:27:52

This commit is contained in:
sShemet
2025-03-01 22:27:52 +05:00
parent 1a12fa2521
commit cfdfca04df

View File

@@ -13,7 +13,7 @@ Alfa Cloud — серверный API, который предоставляет
GET:
```
/servers — получить список активных серверов (для разворачивания новых клиентов)
/servers/{id} — получить подробную информацию о сервере
/servers/{server_id} — получить подробную информацию о сервере
(TODO: с параметрами мониторинга и нагрузкой в реальном времени)
/clients — получить список контейнеров клиентов со всеми подробностями (поддерживается пагинация). С флагом доступностью контейнера. На фронте можно сделать прямой переход на облако клиента.
/clients/{id}/demo_enable - применение таблиц демо-данных (demo seeder)
@@ -30,7 +30,7 @@ GET:
POST:
```
/servers/create — создать сервер в БД
/clients/create — создать клиента - после проверки сразу вернётся id
/clients/create — создать клиента - после проверки сразу вернётся id.
во время создания нужно таймером опрашивать
/clients/{id}/create_log и получать актуальный лог о создании контейнера. За окончание создания отвечает статус "completed" => "ok | error".
/clients/owner_password — задать новый пароль администратора лаборатории
@@ -40,7 +40,7 @@ POST:
PUT | PATCH:
```
/servers/{id} — изменить информацию о сервере
/servers/{server_id} — изменить информацию о сервере
/clients/{id} — редактировать данные клиента (кроме пароля администратора лабы)
/clients/{id}/expire_date - обновление крайней даты использования системы
```
@@ -48,26 +48,25 @@ PUT | PATCH:
DELETE
```
/clients/{id} — редкая функция — запуск очистки пользовательских конфигов с серверов
/servers/{id} не реализовано, да и пока что не надо. Тут нужно просто удаление информации о сервере из БД.
/servers/{server_id} не реализовано, да и пока что не надо. Тут нужно просто удаление информации о сервере из БД.
```
Команды менеджмента контейнеров и деплоя (GET)
```
/servers/{id}/images - список доступных образов на сервере (для переключения или создания пользователя)
/servers/{id}/reboot_server - перезапуск сервера
/servers/{server_id}/images - список доступных образов на сервере (для переключения или создания пользователя)
/servers/{server_id}/reboot_server - перезапуск сервера
/clients/{id}/reboot - попытка перезапуска контейнера пользователя
/server/{id}/deploy - пересоздание конфигов и перезапуск серверного кластера
/server/{server_id}/deploy - пересоздание ВСЕХ конфигов и перезапуск серверного кластера (действие, применяющееся после билда и/или смены версий). После этого необходимо сделать migrate_all
/clients/{id}/create_log - Лог создания контейнера
/containers/{server_id}/build_dev - получение кода из ветки dev, сборка фронта и нового образа
/containers/build_prod - получение кода из ветки master, сборка нового образа
/containers/{server_id}/build_prod - получение кода из ветки master, сборка нового образа
/containers/prune - удалить неиспользуемые версии образов (images prune -a)
/clients/{id}/switch - переключить клиента на образ другой версии
/clients/switch_all - переключить всех клиентов на образ другой версии
/server/{server_id}/switch_all - переключить всех клиентов на образ другой версии
/clients/{id}/migrate - запустить обновление БД клиента (artisan migrate)
/clients/migrate_all - запустить обновление БД у всех клиентов
/clients/move_to - переместить клиента на другой сервер
/server/{server_id}/migrate_all - запустить обновление БД у всех клиентов на сервере
/clients/{id}/move_to - переместить клиента на другой сервер
/clients/{id}/copy_to - установить окружение клиента и БД (только на stage-сервер)
```