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