Синхронізація налаштувань у хмарі
SnakeFlow Cloud дозволяє відправити усі ключі devManager.* з .vscode/settings.json на захищений сервіс і завантажити їх на іншому комп’ютері або після випадкових змін. Ви входите тим самим акаунтом GitHub, що вже використовуєте в VS Code або Cursor.
Налаштування прив’язані до GitHub-репозиторію вашого workspace (хто може синхронізувати — ті самі люди, що мають доступ до цього репо на GitHub).
Командні workspaces
Workspace (воркспейс) об’єднує один або кілька патернів репозиторіїв і відстежує активність команди. Адміни створюють workspace, задають патерни репо та правила allowlist програм, а потім передають одноразові коди запрошень.
Патерни репозиторіїв
Кожен workspace має список glob-патернів репозиторіїв (наприклад owner/*, acme-corp/backend), що визначають, які репозиторії вважаються внутрішньою (internal) активністю. Позначка internal ставиться, коли GitHub remote активного редактора відповідає хоча б одному з цих патернів. Адміни керують патернами в панелі налаштувань workspace.
Вимоги
- Увійшли в GitHub через Accounts у VS Code або Cursor (той самий акаунт, що для GitHub Issues у SnakeFlow, якщо ви ним користуєтесь).
- Папка workspace — Git-репозиторій, чий
originвказує на GitHub, щоб розширення знало, який репозиторій використовувати. - За потреби змініть URL хмари лише для self-hosted API/dashboard (Налаштування).
Налаштування
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
devManager.cloud.apiUrl | string | https://snakeflow-api.pro-connect.workers.dev | Базовий URL REST API. |
devManager.cloud.dashboardUrl | string | https://snakeflow-cloud.pages.dev | Веб-dashboard (іконка проєкту в status bar). |
devManager.cloud.repoOverride | string | "" | Примусово owner/repo, якщо origin не GitHub. |
REST API: повний перелік маршрутів — Cloud API (EN) →. Інтерактивний OpenAPI (основні sync-ендпоінти): snakeflow.pages.dev/api-reference/.
Команди
| Назва команди | Опис |
|---|---|
| SnakeFlow: Open Cloud Dashboard | Відкриває веб-dashboard. |
| SnakeFlow: Cloud Login | Під’єднує сеанс GitHub. |
| SnakeFlow: Cloud Logout | Вихід і очищення сеансу. |
| SnakeFlow: Push Settings to Cloud | Відправити devManager.* з .vscode/settings.json. |
| SnakeFlow: Pull Settings from Cloud | Завантажити налаштування (з підтвердженням). |
Також: Ctrl+Alt+M → Cloud, або клік по іконці проєкту в status bar.
Підписка
Усі функції SnakeFlow Cloud безкоштовні після входу через GitHub: push/pull/delete налаштувань, Team Tracker (воркспейси, активність, інвайти) і повний Quality Hub у розширенні.
Відкрийте SnakeFlow: Open Cloud Dashboard → Налаштування, щоб перемкнути мову dashboard (англійська / українська).
Синхронізація командних налаштувань: якщо адмін workspace зробив Push налаштувань з cloud-токенами Quality Hub, учасники можуть підтягнути їх через Pull на своїх машинах без повторного введення ключів.
Учасники
Учасники workspace відображаються з їхньою роллю (admin або member). Адміни можуть підвищувати/знижувати ролі або видаляти учасників. Учасники можуть переглядати активність команди у своїх workspace-ах.
Приватність і безпека
- Пароль GitHub — SnakeFlow його не бачить. Вхід лишається між вами, редактором і GitHub.
- Доступ GitHub для синхронізації — під час push/pull розширення може використати ваш сеанс GitHub, щоб сервіс перевірив, що вам дозволено працювати з цим репозиторієм. Ця перевірка тимчасова; довгострокові токени GitHub не зберігаються на серверах синхронізації в рамках цього сценарію.
- Що зберігається — копія ваших
devManager.*для кожного репозиторію, який ви синхронізуєте, плюс ідентифікатори, щоб зіставити акаунт (наприклад публічний логін GitHub). - На вашому ПК — невеликий сеанс лише для SnakeFlow Cloud зберігається в Secret Storage розширення (не в
settings.json). - У мережі — з’єднання через HTTPS.
- Рекомендація — не вставляйте API-ключі, паролі до БД чи інші секрети в
devManager.*, якщо ці файли можуть ділитися або синхронізуватися.
Якщо використовуєте власний URL синхронізації, захищайте цей сервер як будь-який внутрішній інструмент (доступ, моніторинг, оновлення облікових даних).