서버

소스: github.com/tuist/tuist/tree/main/server

용도#

서버는 인증, 계정 및 프로젝트, 캐시 저장소, 인사이트, 미리보기, 레지스트리, 통합(GitHub, Slack, SSO)과 같은 Tuist의 서버 측 기능을 제공합니다. Postgres와 ClickHouse를 사용하는 Phoenix/Elixir 애플리케이션입니다.

기여 방법#

서버에 기여하려면 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

내부 개발자는 fnox를 통해 1Password에서 개발 시크릿을 로드합니다. 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