Сервер

Исходный код: github.com/tuist/tuist/tree/main/server

Для чего он нужен#

Сервер обеспечивает работу серверных функций Tuist, таких как аутентификация, управление аккаунтами и проектами, хранение кэша, аналитика, превью, реестр и интеграции (GitHub, Slack и SSO). Это приложение на Phoenix/Elixir с использованием Postgres и ClickHouse.

Как внести вклад#

Для внесения вклада в сервер необходимо подписать CLA (server/CLA.md).

Локальная настройка#

bash

cd server
mise install

# Dependencies
brew services start postgresql@16
mise run clickhouse:start

# Install dependencies + set up the database
mise run install

# Run the server
mise run dev

Откройте http://localhost:8080 в браузере. В режиме разработки страница входа содержит кнопку Войти как тестовый пользователь, которая выполняет вход с помощью заранее созданного аккаунта ([email protected] / tuistrocks).

Note

Разработчики из основной команды загружают секреты для разработки из 1Password через fnox — mise run dev оборачивает сервер в fnox exec (см. server/fnox.toml). Внешним контрибьюторам доступ к 1Password не требуется; сервер работает локально без него. Интеграции OAuth, Stripe и другие сторонние сервисы будут отключены, но основная функциональность работает.

Локальное тестирование Helm#

Вы можете развернуть полный стек на своей машине с помощью kind и включенных задач mise. При этом локально собираются образы Docker, создается кластер kind, устанавливается чарт и автоматически настраивается переадресация портов для всех сервисов:

bash

# Deploy everything (builds images from source)
mise run helm:up --license "YOUR_LICENSE_KEY"

# Include the observability stack (Grafana, Prometheus, Loki, Tempo)
mise run helm:up --license "YOUR_LICENSE_KEY" --observability

# Check status
mise run helm:status

# Tear down
mise run helm:down

Требования:docker, kind, helm и kubectl.

Тесты и форматирование#

Тесты: mix test
Форматирование: mise run format