콘텐츠로 이동

서버

인프라에 대한 더 많은 제어가 필요한 조직을 위해 Tuist 서버의 자체 호스팅 버전을 제공합니다. 이 버전을 사용하면 자체 인프라에서 Tuist를 호스팅할 수 있어 데이터가 안전하고 비공개로 유지됩니다.

라이선스 필요

Tuist를 자체 호스팅하려면 법적으로 유효한 유료 라이선스가 필요합니다. Tuist의 온프레미스 버전은 Enterprise 플랜의 조직에서만 사용할 수 있습니다. 이 버전에 관심이 있으시면 [email protected]로 문의해 주세요.

레거시 캐시 서비스

이전 자체 호스팅 캐시 노드 기술은 새 설치에서는 더 이상 사용되지 않습니다. 현재 자체 호스팅 캐시 인프라를 위해서는 자체 호스팅 캐시 가이드를 사용하세요.

기존 배포는 GitHub의 마크다운 뷰어에서 레거시 소스 문서를 여전히 참조할 수 있습니다: 캐시 노드 및 캐시 아키텍처.

릴리스 주기#

Tuist 서버와 Kura 캐시 서버는 세 가지 GHCR 이미지 채널을 통해 배포됩니다: canary(main에 대한 모든 커밋), release candidate(매주 월요일 생성, 일주일 동안 테스트), 그리고 stable(다음 주 월요일 승격). stable 릴리스만 :latest를 이동시키며 기본적으로 해결됩니다. canary와 release candidate는 태그를 고정하여 선택적으로 사용하는 GitHub 프리릴리스입니다. 서버와 Kura는 Tuist CLI의 릴리스 일정과 발맞춰 동일한 주간 릴리스 트레인을 따릅니다.

예측 가능한 버전 관리와 호환성을 보장하기 위해 시맨틱 버전 관리를 따릅니다. 주요 버전 구성 요소는 자체 호스팅 사용자와 조정이 필요한 Tuist 서버의 파괴적 변경 사항을 표시하는 데 사용됩니다. 이를 사용할 것으로 기대하지 않아도 되며, 만약 필요하다면 원활한 전환을 위해 여러분과 협력할 것입니다.

각 채널이 어떻게 생성되는지, 배포에서 하나를 고정하는 방법, 그리고 스테이징 환경이 다가오는 릴리스를 테스트하는 동안 프로덕션을 안정적인 라인에 유지하는 권장 전략에 대해서는 릴리스 채널 페이지를 참조하세요.

브라우저 세션 업그레이드#

인증된 페이지 요청이나 LiveView 상호 작용 없이 7일이 지나면 브라우저 세션이 만료되며, 인증 후 최대 30일을 넘지 않습니다. '로그인 상태 유지'는 동일한 서버 측 세션을 복원하지만 어느 기한도 연장할 수 없습니다. 활동은 분당 한 번 체크포인트되므로 유휴 세션은 최대 59초 일찍 만료될 수 있습니다. WebSocket 하트비트, 자동 재연결 및 백그라운드 업데이트는 활동을 갱신하지 않습니다. 이러한 기한은 머신 자격 증명이나 API 토큰 수명에 영향을 주지 않습니다.

업그레이드된 애플리케이션 프로세스를 시작하기 전에 추가적인 users_tokens 마이그레이션을 실행하세요. 기존 행은 백필되지 않습니다. 생성 시간은 비활성 기간과 절대 만료 시간을 제한하며, SSO가 적용된 조직에 액세스하기 전에 새로 인증해야 합니다. 콜백의 제공자, 발급자 또는 검증된 Workspace, 그리고カスタム SSO 연결은 서버 측에 저장되어 조직의 현재 설정과 비교됩니다. 연결된 계정은 세션 인증 증명이 아닙니다.

정책이 적용된 것으로 간주하기 전에 모든 웹 복제본을 업그레이드하세요. 이전 바이너리는 여전히 이전의 60일 세션을 허용하며 새로운 LiveView 경계를 적용하지 않습니다. 혼합 버전은 스키마 호환성이 있지만 정책 측면에서는 동일하지 않습니다. 사용자가 다시 로그인해야 할 것으로 예상하세요. 이전 바이너리로 롤백하면 이러한 제어가 약화됩니다. 스키마 롤백이 필요한 경우, 새 필드를 읽는 모든 바이너리를 중지한 후 해당 필드를 삭제하세요. 재인증을 피하기 위해 기존 세션을 연장하거나 출처를 추론하지 마세요.

인증기 앱 MFA#

서버에는 네이티브 인증기 앱(TOTP) 기반 2단계 인증이 포함되어 있습니다. 대시보드에는 아직 이에 대한 링크가 없으며, 이후 릴리스에서 설정 진입점이 추가될 예정입니다. 활성화 플래그, 호스팅 서비스 종속성 또는 ID 공급자 자격 증명이 필요하지 않습니다. PostgreSQL, 아래 마이그레이션, TOTP 인증기, 그리고 모든 서빙 복제본이 공유하는 안정적인 암호화 키(TUIST_SECRET_KEY_ENCRYPTION, 대체로 TUIST_SECRET_KEY_BASE)만 필요합니다. 서버와 인증기의 시계를 동기화 상태로 유지하세요. MFA 검증과 5분당 5개의 실패 코드라는 공유 예산은 Redis가 아닌 PostgreSQL 행 잠금을 사용합니다.

설치하려면 최근 5분 이내에 로그인하고, TOTP 인증기 앱에 설정 키를 입력한 후, 앱에서 생성된 코드를 확인해야 합니다. 일회용 복구 코드 10개가 한 번 표시되므로 안전하게 보관하세요. 팩터 비활성화에도 최근 로그인과 사용하지 않은 인증기 또는 복구 코드가 필요합니다. 팩터 변경 시 다른 브라우저 세션이 취소됩니다. 비밀번호 재설정은 MFA를 제거하지 않으며, 이 구현은 손실된 팩터에 대해 이메일 전용 또는 관리자 우회 방법을 제공하지 않습니다.

등록되면 페더레이션 로그인을 포함한 모든 새로운 브라우저 로그인은 세션을 받거나 브라우저 기반 CLI/장치 인증을 완료하기 전에 네이티브 2차 팩터가 필요합니다. 직접 비밀번호 및 Apple API 로그인은 등록된 사용자를 거부하고 브라우저 로그인을 사용하도록 안내합니다. 등록된 사용자의 새로운 이메일 에이전트 클레임은 MFA가 검증된 브라우저 세션이 필요하며, 메일박스 전용 레거시 클레임은 거부됩니다. 기존 API 토큰, 머신 자격 증명, 워크로드 ID 및 그들의 갱신 규칙은 변경되지 않습니다. 이는 조직 전체의 MFA 의무 사항이나 ID 공급자의 자체 MFA 정책 검증이 아닌, 사용자별 선택적 지원입니다. 조직 SSO는 네이티브 팩터 외에도 올바르게 구성된 제공자/발급자가 여전히 필요합니다.

등록, 로그인, 복구 코드 사용 또는 MFA 비활성화를 위해 이메일은 필요하지 않습니다. 팩터 변경 알림은 최선을 다해 제공되며, 전달 실패는 완료된 변경을 취소하지 않습니다.

새로운 바이너리를 배포하기 전에 별도의 추가 user_mfa/users_tokens.mfa_verified_at 마이그레이션을 실행하세요. TOTP 비밀은 기존 Vault 암호화 키를 사용하므로 해당 키와 백업을 보존하세요. MFA 등록을 허용하기 전에 인증 서비스를 제공하는 모든 레플리카의 업그레이드를 완료하세요. 이전 바이너리는 네이티브 MFA를 우회할 수 있으므로 등록 후에는 정책 호환 롤백 대상이 아닙니다. MFA 스키마를 삭제하면 등록 및 복구 상태가 손실되므로 먼저 읽기 작업을 중지하고 암호화된 백업을 보관하세요. 혼합 버전 스키마 호환성은 MFA 또는 브라우저 세션 제어가 적용된다는 증거가 아닙니다.

OAuth 업그레이드 및 롤백 경계#

OAuth 엔티티 캐시 제거는 기존 설치 환경에서 단계적 업그레이드가 필요합니다. OAuth 캐시 무효화를 중단하는 버전을 배포하기 전에, #14040의 권한 있는 읽기 호환성 릴리스를 모든 OAuth 리더와 라이터에 먼저 배포하세요. 이 호환성 단계는 1.355 릴리스 라인에서 처음 등장합니다: ghcr.io/tuist/tuist:1.355.0-rc.1에 포함되어 있으며, 프로덕션 배포는 승격 후 안정적인 1.355.x 릴리스를 사용해야 합니다. 1.354 이하 버전의 설치는 제거 기능이 포함된 이후 릴리스로 업그레이드하기 전에 이 단계를 완료해야 합니다. 1.355 라인은 호환성 용도로만 유지하고 무효화 제거 기능을 백포트하지 마세요.

원래 호환성 커밋은 ghcr.io/tuist/tuist:sha-c8e54471a425로도 제공됩니다. 다른 이미지는 오래된 소비자가 남아 있는 동안 권한 있는 읽기를 유지하고 레거시 무효화를 보존하는 경우에만 호환성 단계로 적합합니다. 트래픽을 처리하기 전에 해당 단계의 일반 데이터베이스 마이그레이션(리프레시 토큰 조회 인덱스 포함)을 실행하세요.

각 환경의 모든 웹 레플리카, 백그라운드 워커, 스케줄된 작업 및 별도로 고정된 프로세서 이미지를 확인하세요. 무효화를 제거하기 전에 호환성 롤아웃이 완료될 때까지 기다리고 캐시를 읽는 바이너리가 남아 있지 않은지 검증하세요. 자동 업그레이드 중에 플로팅 이미지 태그가 이 단계를 건너뛰지 않도록 하세요. 오래된 소비자가 없는 신규 설치에는 중간 배포가 필요하지 않습니다.

권한 있는 읽기 롤백 대상을 유지

무효화가 제거된 후 일반적인 롤링 롤백은 #14040 또는 다른 권한 있는 읽기 버전을 대상으로 해야 합니다. 모든 무비효화 프로세스가 중지된 후에도 보존된 OAuth 캐시 항목은 최신이 아닐 수 있으며, 재시작된 캐시 읽기 레플리카는 피어로부터 이를 가져올 수 있습니다.

추가 롤백하려면 모든 무비효화 OAuth 소비자를 중지하고 드레이닝한 후, 캐시 읽기 소비자를 시작하기 전에 보존된 모든 Boruta 캐시 참여자를 지우거나 교체해야 합니다. 보존된 참여자의 재참여를 방지하세요. 인그레스만 드레이닝하거나 웹 레플리카만 재시작하는 것은 충분하지 않으며, 캐시를 지우거나 데이터베이스 마이그레이션을 자동으로 롤백하지 말고 Tuist 지원 담당자와 조율하여 복구를 진행하세요.

다중 레플리카 클러스터링#

지원되는 다중 레플리카 웹 배포는 인증 권한이 아닌 크로스 레플리카 Phoenix PubSub 및 Oban PG 알림을 위해 Erlang 클러스터링이 필요합니다. server.cluster.enabled가 false인 경우 차트는 오토스케일러(하나 이상의 레플리카로 확장 가능)를 포함한 다중 레플리카를 거부합니다. 이전에 허용되었던 비클러스터 배포는 가드를 우회하지 말고 이 업그레이드를 계획해야 합니다. 멤버십을 변경하기 전에 무효화 제거를 포함한 OAuth 업그레이드 시퀀스를 완료하세요.

비밀 관리자를 사용하여 릴리스 네임스페이스에 개인 쿠키 Secret을 생성한 다음 이름과 키를 구성하세요:

yaml
server:
replicaCount: 2
cluster:
enabled: true
distributionPort: 9100
cookieExistingSecret: tuist-server-cluster
cookieExistingSecretKey: release-cookie

쿠키는 높은 엔트로피를 가져야 하며 참여하는 모든 웹 레플리카에서 공유되어야 합니다. 퍼블리시된 이미지에 내장된 쿠키를 절대 사용하지 마세요. 분배 쿠키를 소유하면 해당 노드에서 원격 실행이 가능합니다. 분산 릴리스 시작은 이제 누락된 개인 RELEASE_COOKIE 또는 잘못된 포트를 거부하며, DNS 검색 없이 명시적으로 구성된 RELEASE_DISTRIBUTION=name 또는 sname도 포함됩니다. 비차트 배포도 TUIST_CLUSTER_DNS_SERVICE, TUIST_CLUSTER_APP_NAME 및 팟 IP/노드 이름을 일관되게 구성해야 합니다. 검색은 현재 IPv4 A 기록을 사용합니다.

일반적인 서버 연결 helm upgrade에서는 cookieExistingSecret를 비워 두면 쿠키 Secret이 생성되고 이후 업그레이드에서 현재 값이 재사용됩니다. 오프라인 helm template, Argo CD 및 라이브 Secret 조회가 없는 기타 GitOps 렌더러는 생성된 값을 보존할 수 없으므로 별도로 관리되는 안정적인 Secret으로 지원되는 cookieExistingSecret를 사용해야 합니다. 라이브 클러스터를 암시적으로 회전시키기 위해 쿠키 키를 변경하지 마세요. 쿠키 회전에는 모든 참여자의 조정된 마이그레이션/재시작이 필요하며, Secret만 업데이트한다고 기존 프로세스가 업데이트되지 않습니다.

이미지에 베이크된 쿠키에서 첫 번째 롤아웃을 수행하면 모든 웹 레플리카가 개인 Secret을 사용할 때까지 별도의 구/신 멤버십 섬이 형성됩니다. 실시간 업데이트를 위한 마이그레이션 창을 계획하세요. 후속 롤링 배포는 혼합 버전 클러스터를 형성하므로 실제 구/신 버전 간에 PubSub, Oban 알림 및 피어 교체를 검증하세요. 이러한 알림은 내구성 있는 전달 보장이 아닙니다. 호환 가능한 버전을 롤백할 때는 권한 있는 읽기 롤백 이미지를 유지하고 동일한 개인 쿠키를 보존하세요.

EPMD(TCP 4369) 및 구성된 분배 포트는 신뢰할 수 있는 서버 피어 간에만 허용하며, 테넌트 워크로드나 공용 네트워크에서는 절대 허용하지 마세요. 환경에서 실제 인그레스/이그레스 격리를 검증하세요. NetworkPolicy를 렌더링한다고 해서 시행이나 백엔드 도달 가능성이 입증되는 것은 아닙니다. 연속 부하 하의 2개 레플리카 카나리아는 승격 전에 가입, 롤링 교체 및 장애/복구를 통과해야 합니다. DNS는 피어를 검색하는 데 사용되며, 일시적인 실패 또는 부분적인 응답으로 인해 건강한 노드를 연결 해제하는 데 사용되지 않습니다. 실제 노드 손실 및 OTP 파티션 방지가 여전히 적용됩니다. libcluster는 연결을 닫지 않고 유지 콜백에 대해 성공적인 "연결 해제" 작업을 로깅할 수 있으므로 해당 로그 라인뿐만 아니라 노드 업/다운 이벤트 또는 Node.list()에서 실제 멤버십을 확립하세요.

지속적 배포#

프로덕션 환경을 안정적인 마이너 버전 라인(예: ghcr.io/tuist/tuist:1.351)에 고정하여 일상적인 업그레이드에서는 백포팅된 수정 사항만 배포하도록 권장합니다. 안정적인 라인은 릴리스 후보 채널에서 일주일간 소크 테스트를 거친 후 매주 월요일 UTC 06:00에 승격됩니다. 카나리 또는 현재 릴리스 후보 태그를 사용하는 스테이징 환경은 사용자에게 도달하기 전에 회귀 문제를 포착합니다. 권장되는 고정 전략은 릴리스 채널을 참조하세요.

매니페스트를 수정하지 않고도 새로운 기능이 안정화될 때 즉시 적용하려면 :latest 태그를 고정하세요. 이 태그는 매주 월요일 아침에 업데이트되므로 이에 맞춰 배포 창을 계획하세요. 다음은 해당 주기로 최신 안정 이미지를 확인하고 배포하는 GitHub Actions 워크플로우 예시입니다:

yaml
name: Update Tuist Server
on:
schedule:
- cron: '0 8 * * 1' # Mondays 08:00 UTC, after the weekly stable promote
workflow_dispatch: # Allow manual runs
jobs:
update:
runs-on: ubuntu-latest
steps:
- name: Check and deploy latest version
run: |
# Your deployment commands here
# Example: docker pull ghcr.io/tuist/tuist:latest
# Deploy to your infrastructure

네트워크 신뢰 액세스#

셀프 호스팅 설치에서는 신뢰할 수 있는 네트워크에 있는 개발자가 로그인 없이 인사이트를 제출하거나 캐시를 사용하거나 둘 다 수행할 수 있습니다. 대시보드 및 관리 기능에는 여전히 인증이 필요합니다.

필요한 기능만 활성화하세요:

서버 환경 변수 로그인 없이 허용
TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS=true 빌드 및 테스트 인사이트 제출
TUIST_NETWORK_TRUSTED_CACHE_ACCESS=true 캐시된 빌드 출력 읽기 및 쓰기

두 설정 모두 기본적으로 비활성화되어 있으며 독립적이고, 개인 프로젝트를 포함한 모든 계정과 프로젝트에 인스턴스 전체로 적용됩니다. 호스팅된 Tuist에서는 사용할 수 없으며 셀프 호스팅 라이선스를 대체하지 않습니다.

이전 TUIST_NETWORK_TRUSTED_REPORT_PUBLISHING 이름은 TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS가 설정되지 않았을 때 호환성 폴백으로 남아 있습니다.

Warning

이 설정은 강제된 사내 네트워크 또는 VPN 경계 뒤에서만 활성화하세요. 활성화된 엔드포인트에 접근할 수 있는 사람은 누구나 보고서를 제출하거나, 캐시 액세스가 활성화된 경우 캐시된 출력을 읽고 덮어쓸 수 있습니다. 이는 위조된 텔레메트리, 캐시 오염 및 용량 고갈을 허용합니다. 보고 응답은 개인 프로젝트 핸들 및 빌드 시스템을 노출할 수도 있습니다. Tuist는 VPN 멤버십을 검증하거나 전달된 IP 헤더를 멤버십 증명으로 신뢰하지 않습니다.

인스턴스 구성#

  1. 방화벽 또는 전용 인그레스를 사용하여 Tuist 서버, 모든 Kura HTTP/gRPC 리스너 및 모든 Bazel BES 인그레스를 신뢰할 수 있는 네트워크로 제한하세요.
  2. 클라이언트를 업그레이드하기 전에 모든 서버 및 Kura 레플리카를 업그레이드하세요. KURA_AUTH_TUIST_URL 및 제어 플레인 자격 증명을 사용하여 Kura 인증을 활성화된 상태로 유지하세요. 이를 비활성화하면 이러한 제한을 우회하게 됩니다. 셀프 호스팅 캐시 가이드를 사용하여 캐시 엔드포인트를 구성하세요.
  3. 위의 원하는 변수를 관련 Tuist 서버 레플리카마다 설정한 후 재시작하거나 재배포하세요. 정확한 값 true만이 설정을 활성화합니다. 대시보드 토글이나 별도의 Kura 플래그는 없습니다.

클라이언트 구성#

호환되는 각 클라이언트에 최종 셀프 호스팅 서버 URL 및 프로젝트를 구성하세요. 클라이언트는 자격 증명이 없을 때 어떤 기능이 활성화되었는지 자동으로 검색하므로 클라이언트 옵트인이 필요하지 않습니다. 검색은 리디렉션을 따르지 않습니다. 기존 자격 증명은 계속 사용되며, 유효하지 않거나 새로 고침에 실패한 자격 증명은 익명 폴백 대신 오류를 발생시킵니다. 복구하려면 다시 로그인하거나 명시적으로 로그아웃하세요.

인사이트 액세스를 활성화하기 전에, 손상되거나 거부된 자격 증명을 보존하고 읽을 수 없는 자격 증명 디렉터리를 거부하며 서명되지 않은 보고서에서 Git 출처를 생략하는 버전으로 자격 증명을 공유하는 모든 도구를 업그레이드하세요. 이전 도구는 자격 증명을 삭제하고 의도치 않게 익명 폴백을 허용할 수 있으며 서버만 업그레이드해서는 이를 해결할 수 없습니다. 서버에 검색 지원이 없거나 이전 버전으로 롤백된 경우 클라이언트는 인증해야 합니다. 이전 TUIST_NETWORK_TRUSTED_PUBLISHING 클라이언트 설정은 더 이상 적용되지 않습니다.

  • 인사이트: 완료된 Xcode, Gradle, Elixir/Mix 및 Bazel 보고서만 제출하세요. 아카이브, 첨부 파일, 커버리지, 샤드 계획 또는 기존 보고서 액세스는 포함되지 않습니다. 액터 클레임은 검증되지 않으며 서명되지 않은 텔레메트리는 신뢰할 수 있는 테스트 증거 또는 자동화를 구동하지 않습니다. 클라이언트 설정 및 개인정보 보호 세부 정보는 Xcode, Gradle 및 Elixir 가이드를 참조하세요.
  • 캐시: CLI 컴파일/모듈 캐싱, Bazel 캐싱 및 Gradle 작업 캐싱을 지원합니다. 캐시 제거 및 원격 자산 다운로드에는 여전히 자격 증명이 필요합니다. 지원을 받지 않는 클라이언트는 계속 인증해야 합니다.
  • Bazel: 보고에는 명시적인 TUIST_BAZEL_BES_BACKEND 및 호환되는 Kura가 필요합니다. 캐시 및 보고 옵션은 독립적으로 활성화됩니다. 자격 증명이나 두 설정 중 하나를 변경한 후 tuist bazel setup를 다시 실행하세요. 컴파일 캐시 구성 변경 시에는 tuist cache config를 다시 실행하세요.

보고서 요청은 프로젝트당 8MB, 분당 60개 요청, 일일 10,000개 요청으로 제한됩니다. 여러 레플리카를 사용한 배포 전체 할당량을 위해 공유 Valkey를 구성하세요. 그렇지 않으면 제한은 프로세스별로 적용됩니다. 구성된 공유 할당량 백엔드를 사용할 수 없는 경우 서명되지 않은 보고서는 거부됩니다. 인그레스 연결, 본문 및 속도 제한도 추가하세요.

네트워크 신뢰 액세스 비활성화#

관련 변수를 false로 설정한 후 모든 관련 서버 레플리카를 재시작하세요. 오래된 레플리카는 교체될 때까지 자격 증명 없는 요청을 계속 수락할 수 있습니다. 캐시 액세스는 마지막 레플리카가 전환된 후 60초 이내에 새 요청에 대해 중단되며 진행 중인 전송은 취소되지 않습니다. 즉시 철회가 필요한 경우 먼저 인그레스에서 트래픽을 차단하세요. 기존 보고서는 일반적인 가시성 및 보존 기간을 유지하며 인증된 클라이언트는 계속 작동합니다.

런타임 요구 사항#

이 섹션에서는 인프라에서 Tuist 서버를 호스팅하기 위한 요구 사항을 설명합니다.

호환성 매트릭스#

Tuist 서버는 테스트되었으며 다음 최소 버전과 호환됩니다:

구성 요소 최소 버전 참고
PostgreSQL 15
ClickHouse 25 분석에 필요

Docker 가상화 이미지 실행#

서버는 GitHub의 컨테이너 레지스트리를 통해 Docker 이미지로 배포됩니다.

실행하려면 인프라가 Docker 이미지 실행을 지원해야 합니다. 대부분의 인프라 제공업체는 프로덕션 환경에서 소프트웨어를 배포하고 실행하기 위한 표준 컨테이너가 되었기 때문에 이를 지원합니다.

Postgres 데이터베이스#

Docker 이미지를 실행하는 것 외에도 관계형 데이터를 저장하려면 Postgres 데이터베이스가 필요합니다. 대부분의 인프라 제공업체는 서비스 offerings에 Postgres 데이터베이스를 포함합니다(예: AWS 및 Google Cloud).

마이그레이션

Docker 이미지의 진입점은 서비스를 시작하기 전에 대기 중인 스키마 마이그레이션을 자동으로 실행합니다.

ClickHouse 데이터베이스#

Tuist는 대량의 분석 데이터를 저장하고 쿼리하기 위해 ClickHouse를 사용합니다. 빌드 인사이트와 같은 기능에는 ClickHouse가 필수입니다. ClickHouse를 자체 호스팅할지, 아니면 호스팅된 서비스를 사용할지 선택할 수 있습니다.

마이그레이션

Docker 이미지의 진입점은 서비스를 시작하기 전에 대기 중인 ClickHouse 스키마 마이그레이션을 자동으로 실행합니다.

번들된 Docker Compose 및 Helm 임베디드 ClickHouse 구성은 이미지의 trace 기본값에서 information로 ClickHouse 텍스트 로그 수준을 낮추며, 이는 system.text_log 볼륨의 대부분을 차지합니다. 둘 다 기본적으로 무제한인 ClickHouse의 자체 system.* 운영 로그 테이블도 제한할 수 있지만, 이는 기본적으로 비활성화되어 있습니다(아래 참조). 외부 ClickHouse 배포는 이러한 운영 로그를 ClickHouse 서비스에서 직접 구성해야 합니다.

ClickHouse 복제 토폴로지#

Tuist 뒤의 다중 레플리카 ClickHouse는 ClickHouse Cloud에서만 지원됩니다. 자체 관리형 ClickHouse는 단일 레플리카입니다.

인제스트 마이그레이션은 일반 MergeTree 엔진을 생성합니다. Cloud에서는 투명하게 SharedMergeTree가 되므로 writes는 공유 객체 스토리지에 저장되며 모든 레플리카 수가 작동합니다. 자체 관리형 ClickHouse에서는 MergeTree가 하나의 레플리카에서만 로컬 디스크에 기록됩니다. 다중 레플리카 설정은 연결 사용자의 database_replicated_allow_only_replicated_engine 설정에 따라 인제스트를 레플리카 간에 조용히 분할하거나 UNKNOWN_STORAGE: Only tables with a Replicated engine or tables which do not store data on disk are allowed in a Replicated database.로 CREATE를 거부합니다.

자체 관리형 ClickHouse에서 하나의 샤드와 하나의 레플리카를 실행하고 ClickHouse 데이터 디렉터리를 정기적으로 백업하세요. 노드가 손실될 경우 대체할 두 번째 레플리카가 없습니다.

운영 로그 보존 기간 제한#

보존 기간은 system.text_log, system.query_log, system.query_thread_log, system.query_views_log, system.trace_log, system.metric_log, system.asynchronous_metric_log 및 system.part_log에 적용할 수 있습니다.

이미 데이터가 있는 인스턴스에서 이를 활성화하는 것은 한 번만 수행되는 단방향 단계이므로, 어떤 번들도 이를 대신 수행하지 않습니다. 어떠한 보존 기간 윈도우라도 해당 테이블 정의가 구성과 일치하지 않게 되므로, ClickHouse는 각 테이블의 이름을 변경하고 새 테이블을 시작합니다. 이는 대체된 로그 테이블에서 설명된 대로입니다. 남겨진 세대는 지금까지 누적된 모든 것을 보유하며 자체 보존 기간이 없으므로, 동일한 단계에서 이를 회수하지 않으면 디스크에 영구적으로 남게 되고 새 윈도우는 그 이후에 작성된 행만 제한합니다. 둘을 함께 활성화하세요:

yaml
clickhouse:
embedded:
systemLogs:
ttlDays: 14
supersededTables: delete

단일 helm upgrade는 자체 완결적입니다. ttlDays를 빈 값에서 설정된 값으로 변경하면 드롭인 마운트가 추가되고 ClickHouse 포드가 롤링되기 때문입니다. 포드는 재시작되고 테이블을 대체하며, 업그레이드 후 Job이 이를 삭제합니다. Job이 실행되기 전에 포드가 롤링되도록 helm upgrade --wait로 배포하세요. 그렇지 않으면 세대가 Job이 확인한 후에 나타나고, 다음 helm upgrade가 이를 대신 회수합니다.

Docker Compose를 사용하는 경우, docker-compose.yml의 clickhouse 서비스에서 clickhouse-log-ttl.xml 볼륨의 주석을 해제하고 .env에서 두 변수를 설정하세요:

bash
CLICKHOUSE_SYSTEM_LOG_TTL_DAYS=14
CLICKHOUSE_SUPERSEDED_LOG_TABLES=delete

공간이 회수되면 supersededTables/CLICKHOUSE_SUPERSEDED_LOG_TABLES를 다시 ignore로 설정하여 나중에 ClickHouse 업그레이드 시 역사가 자동으로 삭제되지 않도록 할 수 있습니다.

대체된 로그 테이블#

ClickHouse는 시작 시 각 시스템 로그 테이블이 여전히 구성과 일치하는지 확인합니다. 일치하지 않는 경우 기존 테이블의 이름을 system.<name>_0, 그다음 _1, _2 등으로 변경하고 새 테이블을 시작합니다. 이는 보존 기간 윈도우를 변경할 때나 시스템 로그 스키마를 변경하는 ClickHouse 업그레이드 시 발생합니다.

테이블 이름 변경은 데이터를 복사하지 않으므로 추가 디스크 공간을 소비하지 않습니다. 대체된 테이블에 대한 후속 처리는 원래 테이블에서 상속된 보존 정책에 따라 달라집니다. 처음 보존을 활성화할 때 대체되는 테이블에는 보존 정책이 없으므로 지금까지 누적된 모든 역사를 무기한 보관합니다. 나중에 윈도우를 변경하면 이미 TTL을 가진 테이블이 대체되므로, 이들은 자동으로 만료되어 빈 테이블만 남깁니다. ClickHouse는 테이블 자체를 삭제하지 않으므로 장기 운영 인스턴스에서는 어느 쪽이든 테이블이 누적됩니다.

대체된 테이블은 기본적으로 유지되므로 업그레이드 시 운영 역사가 자동으로 삭제되지 않습니다. 대신 이를 삭제하려면 정책을 delete로 설정하세요. 이는 docker compose up 및 각 helm upgrade 시 발생합니다:

bash
CLICKHOUSE_SUPERSEDED_LOG_TABLES=delete

Helm 차트에서는 동일한 정책을 값으로 구성하세요:

yaml
clickhouse:
embedded:
systemLogs:
supersededTables: delete

대체된 테이블을 삭제하면 디스크 공간이 회수됩니다. 활성 테이블이나 대체된 이후 작성된 행에는 영향을 주지 않습니다.

정책을 변경하지 않고 한 번만 공간을 회수하려면 테이블을 직접 삭제하세요:

sql
SELECT name FROM system.tables WHERE database = 'system' AND match(name, '_log_[0-9]+$');
DROP TABLE IF EXISTS system.text_log_0 SYNC;

system 데이터베이스는 Atomic 엔진을 사용하며, 이는 일반 DROP TABLE를 database_atomic_delay_before_drop_table_sec(기본값 8분)만큼 지연시킵니다. SYNC는 데이터를 즉시 제거하므로, 디스크가 가득 찼을 때 이를 삭제하는 경우에 적합합니다.

스토리지#

파일(예: 프레임워크 및 라이브러리 바이너리)을 저장할 솔루션도 필요합니다. Tuist 서버는 서버 소유 아티팩트를 위해 S3 호환 스토리지와 Azure Blob Storage를 지원합니다.

최적화된 캐싱

주요 목표가 캐시 지연 시간을 줄이는 것이라면 전체 서버를 자체 호스팅할 필요가 없을 수 있습니다. CI 또는 개발자 네트워크 근처에 자체 호스팅 Kura 노드를 배포하고 이를 호스팅된 Tuist 서버나 자체 호스팅 서버에 연결할 수 있습니다.

자체 호스팅 캐시 가이드를 참조하세요.

자체 호스팅 Kura 노드#

자체 호스팅 Tuist 서버와 함께 자체 호스팅 Kura 노드를 사용하려면:

  1. Tuist 서버에서 KURA_CONTROL_PLANE_CLIENT_ID 및 KURA_CONTROL_PLANE_CLIENT_SECRET를 구성하세요. 클라이언트 ID는 UUID여야 합니다. 자체 호스팅 캐시 가이드의 명령을 사용하여 UUID와 랜덤 시크릿을 생성하고 배포 시크릿에 저장하세요.
  2. 동일한 컨트롤 플레인 자격 증명을 사용하여 자체 호스팅 캐시 가이드에 따라 Kura 노드를 배포하세요.
  3. 각 Kura 노드를 KURA_REGISTRATION_URL 및 KURA_ADVERTISED_HTTP_URL로 구성하세요. 등록 하트비트는 서버가 CLI에 광고할 수 있는 준비된 클라이언트 facing Kura 엔드포인트를 알려줍니다.

구성#

서비스 구성은 런타임에 환경 변수를 통해 이루어집니다. 이러한 변수는 민감한 정보를 포함하므로 암호화하여 안전한 비밀번호 관리 솔루션에 저장하는 것이 좋습니다. Tuist는 이러한 변수를 최상의 주의로 처리하며 로그에 절대 표시되지 않도록 합니다.

시작 시 검사

필요한 변수는 시작 시 검증됩니다. 누락된 변수가 있으면 시작이 실패하며, 오류 메시지에 누락된 변수가 상세히 표시됩니다.

라이선스 구성#

온프레미스 사용자는 라이선스를 발급받으며, 이를 환경 변수로 노출해야 합니다. 라이선스는 배포를 검증하고 서비스가 계약 조건 내에서 실행되고 있는지 확인하는 데 사용됩니다.

환경 변수 설명 필수 기본값 예시
TUIST_LICENSE 서비스 수준 계약서 서명 후 제공되는 라이선스입니다. 표준 라이선스 키 또는 서버가 외부 서비스에 연결할 수 없는 격리된 환경에서 사용되는 base64 인코딩 인증서를 모두 지원합니다. 예 ******
만료일

라이선스에는 만료일이 있습니다. 라이선스가 30일 이내에 만료되면 서버와 상호작용하는 Tuist 명령을 사용할 때 경고가 표시됩니다. 라이선스를 갱신하려면 [email protected]로 문의하세요.

기본 환경 구성#

환경 변수 설명 필수 기본값 예시
TUIST_APP_URL 인터넷에서 인스턴스에 접근하기 위한 기본 URL 예 https://tuist.dev
TUIST_SECRET_KEY_BASE 정보(예: 쿠키의 세션)를 암호화하는 데 사용하는 키 예 c5786d9f869239cbddeca645575349a570ffebb332b64400c37256e1c9cb7ec831345d03dc0188edd129d09580d8cbf3ceaf17768e2048c037d9c31da5dcacfa
TUIST_SECRET_KEY_PASSWORD 해시된 비밀번호를 생성하기 위한 페퍼 값 아니오 $TUIST_SECRET_KEY_BASE
TUIST_SECRET_KEY_TOKENS 랜덤 토큰을 생성하기 위한 시크릿 키 아니오 $TUIST_SECRET_KEY_BASE
TUIST_SECRET_KEY_ENCRYPTION 민감한 데이터의 AES-GCM 암호화를 위한 32바이트 키 아니오 $TUIST_SECRET_KEY_BASE
TUIST_USE_IPV6 1일 때 앱이 IPv6 주소를 사용하도록 구성합니다 아니오 0 1
TUIST_LOG_LEVEL 앱에서 사용할 로그 레벨 아니오 info 로그 레벨
TUIST_GITHUB_APP_NAME GitHub 앱의 슬러그(https://github.com/apps/<slug>에서 가져옴). 앱 설치에 필요합니다. GitHub 참조 아니오 my-app
TUIST_GITHUB_APP_PRIVATE_KEY_BASE64 자동 PR 댓글 게시와 같은 추가 기능을 활성화하기 위해 GitHub 앱에 사용되는 base64 인코딩된 프라이빗 키 아니오 LS0tLS1CRUdJTiBSU0EgUFJJVkFUR...
TUIST_GITHUB_APP_PRIVATE_KEY 자동 PR 댓글 게시와 같은 추가 기능을 활성화하기 위해 GitHub 앱에 사용되는 프라이빗 키입니다. 특수 문자 문제를 피하기 위해 base64 인코딩 버전을 사용하는 것을 권장합니다 아니오 -----BEGIN RSA...
TUIST_OPERATOR_EMAIL_DOMAIN 이메일 주소가 @<this-domain>로 끝나며 해당 주소를 소유하고 있음을 증명한 사용자는 운영 URL(/ops/*)에 접근할 수 있습니다. 설정되지 않으면 누구도 접근할 수 없습니다. 운영 참조 아니오 example.com
TUIST_SERVER_VERSION_IDENTIFIER 서버 인스턴스(예: 버전 번호 또는 브랜치 이름)를 식별하기 위해 대시보드 네비게이션 바에 배지로 표시되는 라벨 아니오 개발 환경의 Git 브랜치 v1.2.3
TUIST_WEB 웹 서버 엔드포인트 활성화 아니오 1 1 또는 0
TUIST_NETWORK_TRUSTED_INSIGHTS_ACCESS 로그인 없이 빌드 및 테스트 인사이트를 제출할 수 있도록 허용합니다. 설정 및 보안 요구 사항은 네트워크 신뢰 액세스를 참조하세요. 아니오 false true
TUIST_NETWORK_TRUSTED_CACHE_ACCESS 로그인 없이 캐시 읽기 및 쓰기를 허용합니다. 설정 및 보안 요구 사항은 네트워크 신뢰 액세스를 참조하세요. 아니오 false true
TUIST_OTEL_EXPORTER_OTLP_ENDPOINT 추적을 전송할 OpenTelemetry Collector의 gRPC 엔드포인트 아니오 http://localhost:4317
TUIST_LOKI_URL 로그를 푸시할 Loki 호환 엔드포인트의 기본 URL(예: Grafana Alloy 또는 Loki) 아니오 http://localhost:3100
HTTPS를 통해 앱 제공

세션 쿠키는 Secure로 플래그가 지정되어 있으므로 일반 http:// 통신 시 브라우저에서 삭제되어 사용자가 로그인할 수 없습니다. 서버 앞단에서 TLS를 종단 처리하고(내부 CA의 인증서를 사용한 리버스 프록시만으로 충분함), 내부 또는 VPN 전용 배포라도 TUIST_APP_URL를 https:// URL로 설정하세요.

데이터베이스 구성#

다음 환경 변수는 데이터베이스 연결을 구성하는 데 사용됩니다:

환경 변수 설명 필수 기본값 예시
DATABASE_URL Postgres 데이터베이스에 접근하기 위한 URL입니다. URL에는 인증 정보가 포함되어야 합니다. 예 postgres://username:[email protected]/production
TUIST_DATABASE_SCHEMA Tuist 애플리케이션 테이블에서 사용하는 PostgreSQL 스키마입니다. 데이터베이스 정책에서 public 스키마 사용을 허용하지 않는 경우 이 값을 설정하세요. 스키마 이름은 따옴표 없는 PostgreSQL 식별자여야 합니다. 아니오 public tuist
TUIST_MIGRATION_DATABASE_URL Tuist.Release.migrate에서만 사용하는 선택적 Postgres URL입니다. DATABASE_URL가 더 제한된 런타임 역할을 가리킬 때 소유자 역할 URL로 설정하세요. 아니오 DATABASE_URL postgres://owner:[email protected]/production
TUIST_DATABASE_RUNTIME_ROLE 마이그레이션 완료 후 애플리케이션 테이블 권한을 부여해야 하는 런타임 Postgres 역할입니다. 웹 서버가 스키마 소유자로 연결해서는 안 될 때 TUIST_MIGRATION_DATABASE_URL와 함께 사용하세요. 아니오 tuist_web
TUIST_CLICKHOUSE_URL ClickHouse 데이터베이스에 접근하기 위한 URL입니다. URL에는 인증 정보가 포함되어야 합니다. 아니오 http://username:[email protected]/production
TUIST_USE_SSL_FOR_DATABASE true일 경우 데이터베이스 연결에 SSL을 사용합니다. TUIST_DATABASE_SSL_VERIFY가 활성화되지 않으면 서버 인증서는 검증되지 않습니다. 아니오 1 1
TUIST_DATABASE_SSL_VERIFY true일 경우 데이터베이스 서버 인증서는 신뢰할 수 있는 CA 체인에 속해야 하며 DATABASE_URL 호스트와 일치해야 합니다. TUIST_USE_SSL_FOR_DATABASE가 필요합니다. 활성화를 권장합니다. 아니오 0 1
TUIST_DATABASE_SSL_CA_CERT_FILE 데이터베이스 서버를 검증하는 데 사용되는 CA 인증서가 포함된 PEM 파일의 경로입니다. 설정하지 않으면 운영 체제의 신뢰 저장소가 사용됩니다. 아니오 /etc/tuist/rds-global-bundle.pem
TUIST_DATABASE_POOL_SIZE 연결 풀에서 열어둘 연결 수 아니오 10 10
TUIST_DATABASE_QUEUE_TARGET 풀에서 체크아웃된 모든 연결이 대기열 간격보다 오래 걸렸는지 확인하는 간격(밀리초) (자세히 보기) 아니오 300 300
TUIST_DATABASE_QUEUE_INTERVAL 새 연결 삭제를 시작할지 결정하기 위해 풀에서 사용하는 대기열의 임계 시간(밀리초) (자세히 보기) 아니오 1000 1000
TUIST_CLICKHOUSE_FLUSH_INTERVAL_MS ClickHouse 버퍼 플러시 사이의 시간 간격(밀리초) 아니오 5000 5000
TUIST_CLICKHOUSE_MAX_BUFFER_SIZE 강제 플러시가 발생하기 전의 최대 ClickHouse 버퍼 크기(바이트) 아니오 1000000 1000000
TUIST_CLICKHOUSE_BUFFER_POOL_SIZE 실행할 ClickHouse 버퍼 프로세스 수 아니오 5 5

기본적으로 Tuist는 데이터베이스 연결을 암호화하지만 서버 인증서는 검증하지 않으므로 네트워크 경로상의 공격자가 데이터베이스를 사칭할 수 있습니다. 이를 검증하려면 TUIST_DATABASE_SSL_VERIFY=1를 설정하세요. Amazon RDS와 Google Cloud SQL처럼 공급자가 자체 CA로 인증서에 서명하는 경우, 해당 CA 번들을 다운로드하여 컨테이너에 마운트하고 TUIST_DATABASE_SSL_CA_CERT_FILE가 이를 가리키도록 설정하세요. DATABASE_URL의 호스트는 인증서의 이름 또는 IP 주소와 일치해야 합니다. 검증을 활성화하면 이러한 검사를 통과하지 못한 인증서는 모든 데이터베이스 연결을 실패하게 하므로, 활성화 후 서버 로그에서 Bad Certificate 또는 Unknown CA 오류를 확인하세요.

TUIST_DATABASE_SCHEMA가 public가 아닐 때, 릴리스 마이그레이션은 Ecto 마이그레이션 체인을 실행하기 전에 스키마가 존재하지 않으면 생성합니다. 마이그레이션 역할이 스키마를 생성할 수 없는 경우, 스키마를 미리 생성하고 마이그레이션 역할을 해당 소유자로 설정하세요.

Tuist는 세션 search_path를 설정하여 연결을 사용자 정의 스키마로 지정합니다. 일부 풀링되거나 프록시된 Postgres 설정(예: PgBouncer 또는 시작 매개변수를 제한하는 관리형 데이터베이스)은 이를 적용하지 않으며 세션은 public로 fallback되어 마이그레이션 중 permission denied for schema public 오류가 발생합니다. 이러한 설정을 통해 연결할 때는 프록시와 무관하게 모든 세션이 해당 스키마에서 시작되도록 역할 자체에 스키마를 고정하세요:

sql
CREATE SCHEMA IF NOT EXISTS tuist AUTHORIZATION <migration_role>;
ALTER ROLE <migration_role> IN DATABASE <database> SET search_path = tuist;
-- If the web server connects as a separate runtime role (TUIST_DATABASE_RUNTIME_ROLE):
ALTER ROLE <runtime_role> IN DATABASE <database> SET search_path = tuist;

인증 환경 구성#

우리는 신원 공급자(IdP)를 통한 인증을 지원합니다. 이를 사용하려면 선택한 공급자에 필요한 모든 환경 변수가 서버 환경에 있는지 확인하세요. 누락된 변수가 있으면 Tuist는 해당 공급자를 건너뜁니다.

이메일 및 비밀번호#

이메일 및 비밀번호 로그인과 자체 서비스 등록은 기본 제공되며 기본적으로 활성화되어 있습니다. 신원 공급자를 필수로 요구하려는 인스턴스(예: SSO 강제 시)에서는 이를 완전히 비활성화할 수 있습니다. 이렇게 하면 로그인 경험에서 이메일/비밀번호 폼, 가입 링크 및 비밀번호 재설정 흐름이 제거되고 CLI가 사용하는 이메일/비밀번호 엔드포인트(tuist auth)를 포함한 모든 일치하는 서버 측 엔드포인트가 닫힙니다.

환경 변수 설명 필수 기본값 예시
TUIST_EMAIL_AUTH_ENABLED 이메일과 비밀번호를 사용하여 로그인하고 등록할 수 있는지 여부입니다. 로그인 페이지에서 이메일/비밀번호 폼, 가입 링크 및 비밀번호 재설정 흐름을 제거하고 일치하는 서버 측 엔드포인트를 닫으려면 0로 설정하세요. 아니오 1 0

구성된 신원 공급자 비활성화#

기본적으로 공급자는 구성될 때마다 로그인 옵션으로 표시됩니다. 로그인 및 가입 페이지에서 제거하면서도 공급자를 구성된 상태(자격 증명이 설정된 상태)로 유지하려면 일치하는 레버를 0로 설정하세요. GitHub, Google 및 Apple의 경우 이는 로그인 콜백도 닫으므로 해당 방법은 종단 간 사용할 수 없게 됩니다.

환경 변수 설명 필수 기본값 예시
TUIST_GITHUB_AUTH_ENABLED GitHub를 사용하여 로그인할 수 있는지 여부(앱이 로그인과 자격 증명을 공유하는 이유는 GitHub 섹션 참조) 아니오 1 0
TUIST_GOOGLE_AUTH_ENABLED Google을 사용하여 로그인할 수 있는지 여부 아니오 1 0
TUIST_OKTA_AUTH_ENABLED 구성된 Okta 공급자가 로그인 옵션으로 표시되는지 여부 아니오 1 0
TUIST_APPLE_AUTH_ENABLED Apple을 사용하여 로그인할 수 있는지 여부 아니오 1 0

GitHub#

GitHub App을 사용한 인증을 권장하지만 OAuth App도 사용할 수 있습니다. GitHub에서 지정한 모든 필수 환경 변수를 서버 환경에 포함하세요. 변수가 없으면 Tuist는 GitHub 인증을 무시합니다. GitHub 앱을 올바르게 설정하려면:

  • GitHub 앱의 일반 설정에서:
    • Client ID을 복사하여 TUIST_GITHUB_APP_CLIENT_ID로 설정하세요
    • 새 client secret을 생성하고 복사하여 TUIST_GITHUB_APP_CLIENT_SECRET로 설정하세요
    • Callback URL을 http://YOUR_APP_URL/users/auth/github/callback로 설정하세요. YOUR_APP_URL는 서버의 IP 주소일 수도 있습니다.
  • 다음 권한이 필요합니다:
    • 저장소:
      • 풀 리퀘스트: 읽기 및 쓰기
    • 계정:
      • 이메일 주소: 읽기 전용

Permissions and events의 Account permissions 섹션에서 Email addresses 권한을 Read-only로 설정하세요.

그런 다음 Tuist 서버가 실행되는 환경에서 다음 환경 변수를 노출해야 합니다:

환경 변수 설명 필수 기본값 예시
TUIST_GITHUB_APP_CLIENT_ID GitHub 애플리케이션의 클라이언트 ID 예 Iv1.a629723000043722
TUIST_GITHUB_APP_CLIENT_SECRET 애플리케이션의 클라이언트 시크릿 예 232f972951033b89799b0fd24566a04d83f44ccc
TUIST_GITHUB_AUTH_ENABLED GitHub를 사용하여 로그인할 수 있는지 여부입니다. 플랫폼 통합(PR 댓글 등)용으로 구성한 GitHub App은 로그인과 클라이언트 자격 증명을 공유하므로 그렇지 않으면 로그인 옵션으로 표시됩니다. 앱은 유지하면서 로그인 페이지에서 GitHub를 제거하려면 0로 설정하세요 아니오 1 0

Google#

OAuth 2를 사용하여 Google 인증을 설정할 수 있습니다. 이를 위해 OAuth 클라이언트 ID 유형의 새 자격 증명을 만들어야 합니다. 자격 증명을 만들 때 애플리케이션 유형으로 "웹 애플리케이션"을 선택하고 이름을 Tuist로 지정하며 리디렉션 URI를 {base_url}/users/auth/google/callback로 설정하세요. 여기서 base_url는 호스팅된 서비스가 실행 중인 URL입니다. 앱을 만든 후 클라이언트 ID와 시크릿을 복사하여 각각 GOOGLE_CLIENT_ID 및 GOOGLE_CLIENT_SECRET 환경 변수로 설정하세요.

동의 화면 범위

동의 화면을 만들어야 할 수 있습니다. 그렇게 할 때는 userinfo.email 및 openid 범위를 추가하고 앱을 내부용으로 표시하세요.

Okta#

OAuth 2.0 프로토콜을 통해 Okta 인증을 활성화할 수 있습니다. Okta에서 앱을 만들어야 하며, 이 지침을 따르세요.

Okta 애플리케이션 설정 중에 클라이언트 ID와 시크릿을 얻으면 다음 환경 변수를 설정해야 합니다:

환경 변수 설명 필수 기본값 예시
TUIST_OKTA_1_CLIENT_ID Okta 인증에 사용할 클라이언트 ID입니다. 숫자는 조직 ID여야 합니다 예
TUIST_OKTA_1_CLIENT_SECRET Okta 인증에 사용할 클라이언트 시크릿 예

숫자 1는 조직 ID로 대체해야 합니다. 일반적으로 1이지만 데이터베이스에서 확인하세요.

스토리지 환경 구성#

Tuist는 API를 통해 업로드된 아티팩트를 저장할 스토리지가 필요합니다. Tuist가 효과적으로 작동하려면 지원되는 스토리지 솔루션 중 하나를 구성하는 것이 필수입니다.

서버 아티팩트 백엔드를 선택하려면 TUIST_OBJECT_STORAGE_PROVIDER를 설정하세요:

환경 변수 설명 필수 기본값 예시
TUIST_OBJECT_STORAGE_PROVIDER 서버 아티팩트 스토리지 백엔드입니다. S3 호환 스토리지에는 s3, Azure Blob Storage에는 azure_blob를 사용하세요 아니오 s3 azure_blob

S3 호환 스토리지#

아티팩트를 저장하기 위해 모든 S3 호환 스토리지 제공업체를 사용할 수 있습니다. 스토리지 제공업체와의 통합을 인증하고 구성하려면 다음 환경 변수가 필요합니다:

환경 변수 설명 필수 기본값 예시
TUIST_S3_ACCESS_KEY_ID 또는 AWS_ACCESS_KEY_ID 스토리지 제공업체 인증에 사용할 액세스 키 ID 예 AKIAIOSFOD
TUIST_S3_SECRET_ACCESS_KEY 또는 AWS_SECRET_ACCESS_KEY 스토리지 제공업체 인증에 사용할 시크릿 액세스 키 예 wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
TUIST_S3_REGION 또는 AWS_REGION 버킷이 위치한 리전 아니오 auto us-west-2
TUIST_S3_ENDPOINT 또는 AWS_ENDPOINT 스토리지 제공업체의 엔드포인트 예 https://s3.us-west-2.amazonaws.com
TUIST_S3_BUCKET_NAME 아티팩트가 저장될 버킷의 이름 예 tuist-artifacts
TUIST_S3_CA_CERT_PEM S3 HTTPS 연결을 검증하기 위한 PEM 인코딩 CA 인증서입니다. 자체 서명 인증서나 내부 인증 기관을 사용하는 에어갭 환경에서 유용합니다. 아니오 시스템 CA 번들 -----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----
TUIST_S3_CONNECT_TIMEOUT 스토리지 제공업체와의 연결을 설정하는 타임아웃(밀리초 단위) 아니오 3000 3000
TUIST_S3_RECEIVE_TIMEOUT 스토리지 제공업체로부터 데이터를 수신하는 타임아웃(밀리초 단위) 아니오 5000 5000
TUIST_S3_POOL_TIMEOUT 스토리지 제공업체에 대한 연결 풀의 타임아웃(밀리초 단위). 타임아웃을 사용하지 않으려면 infinity를 사용하세요 아니오 5000 5000
TUIST_S3_POOL_MAX_IDLE_TIME 풀 내 연결의 최대 유휴 시간(밀리초 단위). 연결을 무기한 유지하려면 infinity를 사용하세요 아니오 infinity 60000
TUIST_S3_POOL_SIZE 풀당 최대 연결 수 아니오 500 500
TUIST_S3_POOL_COUNT 사용할 연결 풀의 수 아니오 시스템 스케줄러 수 4
TUIST_S3_PROTOCOL 스토리지 제공업체에 연결할 때 사용할 프로토콜(http1 또는 http2) 아니오 http1 http1
TUIST_S3_VIRTUAL_HOST URL을 버킷 이름을 서브도메인(가상 호스트)으로 구성할지 여부 아니오 false 1
환경 변수를 통한 AWS 웹 신원 인증

스토리지 제공업체가 AWS이고 웹 신원 토큰을 사용하여 인증하려면 환경 변수 TUIST_S3_AUTHENTICATION_METHOD를 aws_web_identity_token_from_env_vars로 설정하면 Tuist는 기존 AWS 환경 변수를 사용하여 해당 방법을 사용합니다.

Google Cloud Storage#

Google Cloud Storage의 경우 이 문서를 따라 AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY 쌍을 얻으세요. AWS_ENDPOINT는 https://storage.googleapis.com로 설정해야 합니다. 다른 환경 변수는 다른 S3 호환 스토리지와 동일합니다.

Azure Blob Storage#

Azure Blob Storage의 경우 TUIST_OBJECT_STORAGE_PROVIDER=azure_blob를 설정하고 Azure 스토리지 계정 자격 증명을 구성하세요:

환경 변수 설명 필수 기본값 예시
TUIST_AZURE_STORAGE_ACCOUNT_NAME Azure 스토리지 계정 이름 예 tuiststorage
TUIST_AZURE_STORAGE_ACCOUNT_KEY Azure Blob REST 요청 및 SAS URL 서명에 사용되는 스토리지 계정 액세스 키 예 ******
TUIST_AZURE_BLOB_CONTAINER_NAME 서버 아티팩트가 저장되는 컨테이너 예 tuist-artifacts
TUIST_AZURE_BLOB_ENDPOINT Blob 서비스 엔드포인트. https://<account>.blob.core.windows.net를 사용하려면 생략하세요 아니오 계정 이름에서 파생됨 https://tuiststorage.blob.core.windows.net
TUIST_AZURE_BLOB_SERVICE_VERSION 서명된 요청 및 SAS URL에 사용되는 Azure Blob REST API 버전 아니오 2020-12-06 2020-12-06

Helm 차트를 사용할 때는 server.storage.provider=azure_blob를 설정하고 server.azureBlob.*를 채우세요. 차트의 최상위 objectStorage 설정은 선택적 캐시 및 레지스트리 미러 워크로드가 여전히 S3 호환 스토리지를 기대하므로 S3 호환 상태로 유지됩니다. 해당 워크로드가 비활성화되고 서버가 Azure Blob을 사용하는 경우 objectStorage.mode=external를 설정하고 외부 오브젝트 스토리지 엔드포인트 및 자격 증명을 비워 두어 내장 MinIO 서비스 배포를 피하세요.

아티팩트 보존#

아티팩트 정리는 자체 호스팅 인스턴스에서 기본적으로 비활성화되어 있습니다. 지원되는 각 아티팩트 유형에는 고유한 환경 변수가 있습니다. 해당 아티팩트 유형의 정리를 활성화하려면 변수를 양의 정수 일수로 설정하세요. 변수를 설정하지 않거나 비워 두면 해당 아티팩트 유형에 대해서만 정리가 비활성화됩니다.

bash
TUIST_CACHE_ARTIFACT_RETENTION_DAYS=30
TUIST_APP_PREVIEW_RETENTION_DAYS=30
TUIST_BUILD_ARCHIVE_RETENTION_DAYS=60
TUIST_RUN_ARTIFACT_RETENTION_DAYS=30
TUIST_TEST_ATTACHMENT_RETENTION_DAYS=30
TUIST_SHARD_BUNDLE_RETENTION_DAYS=14

Helm 차트를 사용할 경우 동일한 기간을 맵으로 구성하세요:

yaml
server:
artifactRetentionDays:
cacheArtifacts: 30
appPreviews: 30
buildArchives: 60
runArtifacts: 30
testAttachments: 30
shardBundles: 14

여섯 개의 키는 모두 선택 사항입니다. 이 예시는 독립적인 보존 기간을 가진 모든 지원 아티팩트 유형을 활성화합니다. 특정 아티팩트 유형의 정리를 비활성화된 상태로 유지하려면 키를 생략하거나 값을 비워 두세요. 자체 호스팅 보존 기간에는 30일 최대 제한이 없습니다. 양의 정수가 아닌 값으로 구성하면 서버 시작 시 실패합니다.

보존 변수를 변경한 후 서버를 재시작하세요. 대기 중인 모든 자체 호스팅 정리 배치는 파일을 삭제하기 전에 현재 구성을 확인하므로, 변수를 해제하거나 비우거나 기간을 늘리면 재시작 후에도 대기 중인 작업으로부터 파일이 보호됩니다.

환경 변수 오브젝트 스토리지에서 제거된 아티팩트 파일
TUIST_CACHE_ARTIFACT_RETENTION_DAYS Xcode 캐시, 레거시 콘텐츠 주소 지정 스토리지 캐시, 모듈 캐시 및 Gradle 캐시 파일
TUIST_APP_PREVIEW_RETENTION_DAYS 앱 미리보기 빌드 및 아이콘
TUIST_BUILD_ARCHIVE_RETENTION_DAYS 현재 및 레거시 빌드 아카이브
TUIST_RUN_ARTIFACT_RETENTION_DAYS 결과 번들, 호출 기록 및 세션 아카이브를 포함하여 만료된 실행의 아티팩트 접두사 아래에 저장된 모든 오브젝트
TUIST_TEST_ATTACHMENT_RETENTION_DAYS 테스트 실행 첨부 파일
TUIST_SHARD_BUNDLE_RETENTION_DAYS 테스트 샤드 번들

예약된 정리는 아티팩트 블롭만 제거합니다. 해당하는 PostgreSQL 및 ClickHouse 행은 보존되므로 다운로드가 만료된 후에도 대시보드에서 빌드, 테스트, 실행, 미리보기 및 샤드 메타데이터를 계속 볼 수 있습니다. 이 구성은 ClickHouse 테이블 보존 규칙을 변경하지 않습니다.

이메일 구성#

Tuist는 사용자 인증 및 트랜잭션 알림(예: 비밀번호 재설정, 계정 알림)을 위해 이메일 기능이 필요합니다. 현재 이메일 제공업체로는 Mailgun만 지원됩니다.

환경 변수 설명 필수 기본값 예시
TUIST_MAILGUN_API_KEY Mailgun 인증용 API 키 예* key-1234567890abcdef
TUIST_MAILING_DOMAIN 이메일이 발송될 도메인 예* mg.tuist.io
TUIST_MAILING_FROM_ADDRESS "보낸 사람" 필드에 표시될 이메일 주소 예* [email protected]
TUIST_MAILING_REPLY_TO_ADDRESS 사용자 답장을 위한 선택적 회신 주소 아니오 [email protected]
TUIST_SKIP_EMAIL_CONFIRMATION 새 사용자 등록 시 이메일 확인을 건너뜁니다. 활성화되면 사용자는 자동으로 확인되며 등록 직후 즉시 로그인할 수 있습니다. 아니오 이메일이 구성되지 않은 경우 true, 이메일이 구성된 경우 false true, false, 1, 0

* 이메일 구성 변수는 이메일을 보내려는 경우에만 필요합니다. 구성되지 않으면 이메일 확인이 자동으로 건너뜹니다.

SMTP 지원

일반 SMTP 지원은 현재 사용할 수 없습니다. 온프레미스 배포에 SMTP 지원이 필요한 경우 요구 사항을 논의하기 위해 [email protected]로 문의하세요.

에어갭드 배포

인터넷 액세스나 이메일 제공업체 구성이 없는 온프레미스 설치의 경우 이메일 확인은 기본적으로 자동으로 건너뜹니다. 사용자는 등록 직후 즉시 로그인할 수 있습니다. 이메일이 구성되어 있지만 확인을 건너뛰려면 TUIST_SKIP_EMAIL_CONFIRMATION=true를 설정하세요. 이메일이 구성되었을 때 이메일 확인을 요구하려면 TUIST_SKIP_EMAIL_CONFIRMATION=false를 설정하세요.

이메일 할당량 및 비밀번호 재설정 링크

이메일이 구성된 경우 초대 이메일(생성, 대량 또는 재전송)은 수신자마다 5분마다 하나로 제한되며, 조직 및 초대자당 시간당 50개씩 보충되는 50개의 버스트로 제한됩니다. 초대를 취소해도 할당량이 복구되지 않으며, 초대 API는 소진된 할당량에 대해 429 및 Retry-After로 응답합니다. 여러 복제본을 사용하는 경우 배포 전체 할당량을 위해 공유 Valkey를 구성하세요. 구성되었지만 사용할 수 없는 경우 초대 이메일은 거부됩니다. 비밀번호 재설정 링크는 15분 후에 만료됩니다.

Git 플랫폼 구성#

Tuist는 풀 리퀘스트에 댓글을 자동으로 게시하는 것과 같은 추가 기능을 제공하기 위해 Git 플랫폼과 통합할 수 있습니다.

GitHub#

셀프 호스팅 Tuist 서버는 https://tuist.dev에서 실행되는 GitHub 앱을 설치할 수 없습니다. GitHub 앱은 등록된 서버에 바인딩되므로, 배포에는 github.com에 자체 앱이 필요합니다.

앱 등록

GitHub 조직이 소유한 GitHub 앱을 생성하세요. OAuth 앱을 생성하지 않았다면 인증용으로 만든 앱을 재사용할 수 있습니다. 다음 설정으로 구성하고, YOUR_APP_URL를 TUIST_APP_URL 값으로 바꾸세요:

설정 값
콜백 URL YOUR_APP_URL/users/auth/github/callback 및 YOUR_APP_URL/integrations/github/authorize
설정 URL YOUR_APP_URL/integrations/github/setup
업데이트 시 리디렉션 활성화됨
웹훅 URL YOUR_APP_URL/webhooks/github
웹훅 비밀 키 임의의 문자열입니다. 이를 TUIST_GITHUB_APP_WEBHOOK_SECRET로 설정합니다.

다음 저장소 권한을 부여하세요:

권한 액세스
콘텐츠 읽기 전용
메타데이터 읽기 전용
이슈 읽기 및 쓰기
풀 리퀘스트 읽기 및 쓰기
체크 읽기 및 쓰기

멤버: 읽기 전용 조직 권한도 부여하세요. github.com 설정 중 Tuist는 조직 설치를 연결하는 사람이 해당 저장소 중 하나에 액세스할 수 있는 사용자가 아닌 활성 GitHub 조직 소유자인지 확인합니다.

앱을 Check run, Pull request, Issue comment 이벤트에 구독하세요.

GitHub가 설치자를 설정 URL로 보내도록 설치 중 사용자 승인 요청(OAuth) 을 비활성화된 상태로 유지하세요. Tuist는 추가 /integrations/github/authorize 콜백을 사용하여 설치 소유권을 확인하는 별도의 승인 단계를 시작합니다. GitHub에서 설치가 시작되면 설치자는 Tuist 조직을 선택합니다. Tuist에서 시작된 설치는 해당 조직을 유지합니다.

서버 구성

다음 환경 변수를 설정한 후 서버를 다시 시작하세요:

환경 변수 설명 필수 기본값 예시
TUIST_GITHUB_APP_NAME 앱의 슬러그로, 공개 페이지 URL https://github.com/apps/<slug>의 마지막 경로 구성 요소입니다. 예 my-company-tuist
TUIST_GITHUB_APP_ID 설치 소유권을 확인하는 데 사용되는 숫자 앱 ID 예 123456
TUIST_GITHUB_APP_CLIENT_ID GitHub 애플리케이션의 클라이언트 ID 예 Iv1.a629723000043722
TUIST_GITHUB_APP_CLIENT_SECRET 애플리케이션의 클라이언트 시크릿 예 232f972951033b89799b0fd24566a04d83f44ccc
TUIST_GITHUB_APP_PRIVATE_KEY_BASE64 GitHub 애플리케이션의 Base64로 인코딩된 개인 키. 플랫폼이 줄 바꿈을 처리하는 방식에 민감한 TUIST_GITHUB_APP_PRIVATE_KEY보다 선호됩니다. 예 LS0tLS1CRUdJTiBSU0EgUFJJVkFUR...
TUIST_GITHUB_APP_WEBHOOK_SECRET GitHub 애플리케이션에 구성된 웹훅 시크릿 아니요 a4c1e0f2b8d6...
필수 앱 자격 증명을 모두 구성하세요

조직의 통합 페이지에 있는 GitHub 앱 설치 버튼은 TUIST_GITHUB_APP_NAME, TUIST_GITHUB_APP_CLIENT_ID, TUIST_GITHUB_APP_CLIENT_SECRET 및 개인 키가 모두 설정될 때까지 비활성화 상태로 유지됩니다. 설치 소유권을 확인하려면 숫자 형식의 TUIST_GITHUB_APP_ID도 필요합니다. 설치 URL에는 앱 슬러그가 포함되므로, 특히 TUIST_GITHUB_APP_NAME가 누락되면 GitHub에서 404 오류를 반환하는 링크가 생성됩니다.

서버가 다시 시작된 후, 조직 관리자는 GitHub 통합 가이드에 따라 앱을 설치하고 저장소를 프로젝트에 연결합니다.

OIDC 인증은 이에 의존합니다

OIDC 인증은 CI 토큰의 저장소 클레임을 프로젝트에 연결된 저장소와 비교하여 해결하며, 연결은 설치된 GitHub 앱을 통해서만 생성할 수 있습니다. CI 워크플로우가 OIDC로 인증하기 전에 위의 설정을 완료하세요.

Tuist 서버는 서명 키를 가져오기 위해 CI 제공자의 OIDC 발급자에 대한 아웃바운드 액세스도 필요합니다:

CI 제공자 호스트
GitHub Actions token.actions.githubusercontent.com
CircleCI oidc.circleci.com
Bitrise token.builds.bitrise.io
GitHub Enterprise Server

위의 환경 변수는 Tuist의 github.com 앱만 구성합니다. 대신 Tuist를 GitHub Enterprise Server(GHES) 인스턴스와 통합하려면, 조직 관리자가 통합 페이지의 엔터프라이즈 서버 탭으로 전환하고 GHES 기본 URL을 입력합니다. 그러면 Tuist는 GHES 인스턴스에 새로운 Tuist 앱을 등록하기 위해 GitHub의 앱 매니페스트 흐름을 안내합니다. 새 앱의 자격 증명은 설치별로 암호화되어 저장되며, 추가적인 TUIST_GITHUB_APP_* 환경 변수는 필요하지 않습니다.

Origin#

셀프 호스팅 Tuist 서버는 배포의 URL과 서명 키로 구성된 자체 Origin 앱이 필요합니다. 설치와 자격 증명이 독립적으로 유지되도록 각 Tuist 환경마다 별도의 앱을 등록하세요.

앱 등록
  1. Ed25519를 지원하는 OpenSSL을 사용하여 Ed25519 서명 키 쌍을 생성하세요:

    bash
    umask 077
    openssl genpkey -algorithm ED25519 -out origin-app-private.pem
    openssl pkey -in origin-app-private.pem -pubout -out origin-app-public.pem
  2. Origin 앱 설정에서 앱을 생성하세요. origin-app-public.pem의 내용을 공개 서명 키로 등록하세요. origin-app-private.pem는 비밀로 유지하세요. 이를 Cursor에 업로드하지 않고 Tuist 서버에 제공합니다.

  3. 다음 설정을 구성하고, YOUR_APP_URL를 Tuist 배포의 HTTPS 기본 URL로 바꾸세요:

    설정 값
    홈페이지 URL YOUR_APP_URL
    리디렉션 URI YOUR_APP_URL/integrations/origin/setup
    웹훅 URL YOUR_APP_URL/webhooks/origin
  4. app_로 시작하는 등록된 앱 ID를 복사하세요.

Tuist는 설치 중에 다음 권한을 요청합니다:

범위 사용 목적
repository:pull_requests:read 풀 리퀘스트와 현재 헤드 커밋을 찾습니다.
repository:pull_requests:reviews:write 보고서 댓글을 읽고, 게시하고, 업데이트합니다. Origin에는 해당하는 리뷰 읽기 권한이 포함되어 있습니다.
repository:metadata:read 저장소를 발견하고 기본 브랜치를 읽습니다. Origin에 의해 자동으로 부여됩니다.

선택적 저장소 웹훅 이벤트는 선택하지 않은 상태로 두세요. 설치 수명 주기 알림으로 충분하며, 소스 코드 액세스, 병합 권한 및 체크 실행 권한은 필요하지 않습니다.

서버 구성

다음 환경 변수를 설정한 후 서버를 재시작하세요:

환경 변수 설명 필수 여부 기본값 예시
TUIST_ORIGIN_APP_ID Origin 앱 설정에서 복사한 앱 ID입니다. 예 app_...
TUIST_ORIGIN_APP_PRIVATE_KEY origin-app-private.pem의 전체 내용으로, BEGIN PRIVATE KEY 및 END PRIVATE KEY 줄과 모든 줄 바꿈을 포함합니다. 예 -----BEGIN PRIVATE KEY-----...

비공개 키를 배포의 비밀 관리자에 저장하세요. 멀티라인 PEM 형식을 유지해야 하며, 이 설정은 base64로 인코딩된 대체 값을 허용하지 않습니다. 키를 소스 제어에 커밋하거나 로그에 노출해서는 안 됩니다. 두 변수는 모두 동일한 등록된 앱에 속해야 합니다.

Tuist 서버는 api.cursor.com에 대한 아웃바운드 HTTPS 액세스가 필요합니다. Cursor는 웹훅 URL로 요청을 전달할 수 있어야 하며, 관리자는 브라우저에서 리디렉션 URI로 돌아갈 수 있어야 합니다. 등록된 두 URL 모두 배포의 HTTPS 기본 URL과 일치해야 합니다.

앱 설치

서버가 재시작되면 관리자가 설정 → 통합을 열고 Origin 아래의 연결을 선택하여 앱이 적절한 Origin 계정 및 저장소에 액세스하는 것을 승인합니다. 이 과정에서 Tuist 조직은 유지됩니다. 대신 Origin에서 직접 initiated된 설치는 관리자에게 로그인하고 연결할 Tuist 조직을 선택하도록 요청합니다. 그런 다음 새 프로젝트 연결 추가를 선택하여 Tuist 프로젝트를 네이티브 저장소에 연결합니다.

프로젝트 연결 및 결과 업로드 요구 사항에 대해서는 Origin 통합 가이드를 따르세요. 앱을 설치해도 빌드 또는 테스트 워크플로우가 시작되지 않으며, 해당 워크플로우는 계속해서 Tuist 서버에 결과를 보고합니다.

Entire#

셀프 호스팅 Tuist 서버는 배포의 URL과 서명 키로 구성된 자체 Entire 플러그인이 필요합니다. Entire 플러그인은 파트너 등록이 필요하므로 시작하기 전에 Entire에 문의하세요. 설치와 자격 증명이 독립적으로 유지되도록 각 Tuist 환경마다 별도의 플러그인 또는 최소한 별도의 서명 키를 등록하세요.

플러그인 등록
  1. Ed25519를 지원하는 OpenSSL을 사용하여 Ed25519 서명 키 쌍을 생성하세요:

    bash
    umask 077
    openssl genpkey -algorithm ED25519 -out entire-plugin-private.pem
    openssl pkey -in entire-plugin-private.pem -pubout -out entire-plugin-public.pem
  2. Entire의 플러그인 등록 가이드에 따라 플러그인을 등록하세요. entire-plugin-public.pem의 내용이나 이를 게시하는 JWKS URL을 플러그인의 서명 키로 공유하세요. entire-plugin-private.pem는 비밀로 유지하세요. 이를 Entire가 아닌 Tuist 서버에 제공합니다.

  3. 다음 URL을 구성하고, YOUR_APP_URL를 Tuist 배포의 HTTPS 기본 URL로 바꾸세요:

    설정 값
    설치 후 URL YOUR_APP_URL/integrations/entire/callback
    웹훅 URL YOUR_APP_URL/webhooks/entire
  4. Entire가 확인한 플러그인 슬러그와 제공하는 웹훅 서명 키 URL을 기록하세요.

다음 권한을 요청하세요:

권한 사용 목적
contents:read Trail 이벤트를 수신하고 헤드 커밋이 있는 오픈 및 드래프트 Trail을 찾습니다.
checks:write Tuist 게이트를 게시합니다.
findings:write 실패한 테스트 및 불안정한 테스트 결과를 게시하고 해결합니다.
discussions:write 요약 댓글을 게시하고 업데이트합니다. 이를 부여하지 않은 설치라도 게이트와 결과를 계속 수신합니다.

저장소 쓰기 액세스는 필요하지 않습니다. 기존 등록에 권한을 추가하는 경우, Entire에 업데이트를 요청하고 설치가 새 권한을 부여하는지 확인하세요. Entire의 Checks, Findings 및 Trail comments 계약을 참조하세요.

서버 구성

다음 환경 변수를 설정한 후 서버를 재시작하세요:

환경 변수 설명 필수 기본값 예시
TUIST_ENTIRE_PLUGIN_SLUG Entire가 확인한 플러그인 슬러그입니다. 예 tuist
TUIST_ENTIRE_PLUGIN_PRIVATE_KEY BEGIN PRIVATE KEY 및 END PRIVATE KEY 줄과 모든 줄 바꿈을 포함한 entire-plugin-private.pem의 전체 내용입니다. 예 -----BEGIN PRIVATE KEY-----...
TUIST_ENTIRE_DELIVERY_JWKS_URL 등록 시 Entire에서 제공하는 웹훅 서명 키 URL입니다. 예
TUIST_ENTIRE_PLUGIN_KEY_ID JWKS를 통해 서명 키를 등록할 때의 키 ID입니다. 아니오
TUIST_ENTIRE_CORE_URL 설치 요청에 사용되는 Entire Core URL입니다. 아니오 https://eu.auth.entire.io

비공개 키를 배포 환경의 시크릿 매니저에 저장하고 멀티라인 PEM 형식을 유지하세요. 키를 소스 제어에 커밋하거나 로그에 노출하지 마세요. Tuist Helm 차트를 사용하는 경우, 대신 PEM을 1Password 볼트에 ENTIRE_PLUGIN/private_key로 저장하고 server.config.managedSecrets와 함께 server.config.entirePluginKey.enabled를 활성화할 수 있습니다. 항목 및 필드 이름은 server.config.entirePluginKey.item와 .field를 통해 구성할 수 있습니다. 이 매핑은 슬러그나 웹훅 서명 키 URL을 설정하지 않습니다.

Tuist 서버는 entire.io 또는 entire.com 도메인 하위에 있는 Entire Core와 저장소를 서비스하는 지역별 Entire API 호스트로의 아웃바운드 HTTPS 액세스가 필요합니다. Tuist는 설치 영수증과 웹훅 서명을 검증하고, 단기적인 저장소 범위 토큰을 발급하며, 보고서 링크에 토큰을 포함하지 않습니다.

통합 활성화

애플리케이션을 배포하기 전에 서버 마이그레이션을 적용한 후, entire_trails 기능 플래그를 전역적으로 활성화하여 모든 계정 또는 선택된 계정에 통합 기능을 제공하세요. 플래그를 활성화해도 Entire에서 플러그인을 설치할 수 있는 사용자가 변경되지는 않습니다. 플러그인이 소유한 Entire 프로젝트 외부에서 이를 제공하려면 Entire 담당자에게 허용을 요청하세요. 이 통합은 Tuist의 CI 실행 구성과 독립적입니다.

애플리케이션을 롤백하는 경우, 나중에 업그레이드할 때 진행 중인 게시물을 복구할 수 있도록 entire_trail_reports 테이블을 유지하세요.

관리자는 Entire 통합 가이드에 따라 플러그인을 설치하고 저장소를 프로젝트에 연결합니다. 플러그인을 설치해도 빌드 또는 테스트 워크플로우가 시작되지는 않으며, 이러한 워크플로우는 계속해서 Tuist 서버에 결과를 보고합니다.

로컬에서 테스트하기#

인프라에 배포하기 전에 로컬 머신에서 Tuist 서버를 테스트하는 데 필요한 모든 종속성을 포함하는 포괄적인 Docker Compose 구성을 제공합니다:

  • PostgreSQL 15
  • 분석용 ClickHouse 26.5
  • 조정을 위한 ClickHouse Keeper
  • S3 호환 스토리지를 위한 MinIO
  • 로컬 셀프 호스팅 캐시 테스트를 위한 Kura
  • 데이터베이스 관리를 위한 pgweb
라이선스 필요

Tuist 서버(로컬 개발 인스턴스 포함)를 실행하려면 유효한 TUIST_LICENSE 환경 변수가 법적으로 필요합니다. 라이선스가 필요하면 [email protected]로 문의하세요.

빠른 시작:

  1. 구성 파일 다운로드:

    bash
    curl -O https://tuist.dev/server/self-host/docker-compose.yml
    curl -O https://tuist.dev/server/self-host/clickhouse-config.xml
    curl -O https://tuist.dev/server/self-host/clickhouse-log-level.xml
    curl -O https://tuist.dev/server/self-host/clickhouse-log-ttl.xml
    curl -O https://tuist.dev/server/self-host/clickhouse-keeper-config.xml
    curl -O https://tuist.dev/server/self-host/.env.example
  2. 환경 변수 구성:

    bash
    cp .env.example .env
    # Edit .env and add your TUIST_LICENSE, TUIST_SECRET_KEY_BASE, and authentication credentials

    번들된 ClickHouse 서비스는 다음 선택적 운영 로그 제어를 허용합니다:

    환경 변수 설명 기본값 예시
    CLICKHOUSE_SYSTEM_LOG_TTL_DAYS text_log, query_log, trace_log, metric_log 및 part_log와 같은 ClickHouse system.* 로그 테이블의 보존 기간(일) 14 7
    CLICKHOUSE_TEXT_LOG_LEVEL ClickHouse 서버 로거 및 system.text_log 수준 information warning
    CLICKHOUSE_SUPERSEDED_LOG_TABLES ClickHouse가 시스템 로그 테이블을 대체할 때 남겨두는 <name>_N 테이블을 처리하는 방법입니다. ignore는 유지하고, delete는 삭제합니다. ignore delete
  3. 모든 서비스 시작:

    bash
    docker compose up -d
    # or with podman:
    podman compose up -d

    Apple Silicon에서는 Docker Desktop이 Tuist 및 종속성 이미지의 linux/arm64 변형을 자동으로 가져옵니다. 디버깅을 위해 amd64 에뮬레이션을 강제하려면 DOCKER_DEFAULT_PLATFORM=linux/amd64를 사용하여 Compose를 실행하세요.

    번들된 compose 파일은 영구 데이터를 위해 이름이 지정된 Docker 볼륨을 사용합니다. 이를 호스트 바인드 마운트로 대체하는 경우, 먼저 호스트 디렉터리를 생성하고 컨테이너 사용자가 쓸 수 있도록 권한을 설정하세요. 특히 ClickHouse 및 ClickHouse Keeper 데이터 디렉터리에 주의하세요.

  4. 서버에 접속: http://localhost:8080

서비스 엔드포인트:

일반 명령어:

서비스 상태 확인:

bash
docker compose ps
# or: podman compose ps

로그 보기:

bash
docker compose logs -f tuist

서비스 중지:

bash
docker compose down

모두 초기화(모든 데이터 삭제):

bash
docker compose down -v

구성 파일:

Helm을 사용한 Kubernetes#

Tuist는 Kubernetes에 배포하기 위한 공식 Helm 차트를 제공합니다. 이 차트는 Tuist 서버와 캐시 서비스를 패키징하며, 필요에 따라 외부 제공자로 교체할 수 있는 내장 인프라 종속성을 포함합니다.

차트 설치#

bash
helm install tuist oci://ghcr.io/tuist/charts/tuist \
--set server.license.key="YOUR_LICENSE_KEY"

특정 차트 버전을 고정하려면:

bash
helm install tuist oci://ghcr.io/tuist/charts/tuist \
--set server.license.key="YOUR_LICENSE_KEY" \
--version 0.1.0

라이선스#

server.license.key 값은 표준 라이선스 키와 격리된 설치를 위한 Base64로 인코딩된 라이선스 인증서를 모두 허용하며, 서버가 자동으로 어떤 것인지 감지합니다.

--set를 사용하여 라이선스를 전달하면 빠르게 설치할 수 있습니다. 값을 버전 관리 시스템에 보관하는 경우, 라이선스를 Helm 외부에서 관리하는 Kubernetes Secret(예: Vault, Sealed Secrets 또는 SOPS 사용)에 저장하고 차트가 이를 참조하도록 설정하세요:

yaml
# values.yaml
server:
license:
existingSecret: tuist-license
existingSecretKeys:
key: TUIST_LICENSE
certificateBase64: ""

existingSecretKeys.key 아래의 항목은 라이선스 값(라이선스 키 또는 격리된 설치를 위한 Base64로 인코딩된 라이선스 인증서)을 보유하는 Secret의 필드 이름을 지정합니다. existingSecretKeys 아래의 각 항목은 차트의 자체 키 이름으로 기본 설정되므로, 위 certificateBase64와 같이 Secret에 포함되지 않은 항목은 빈 문자열로 설정하세요. 그렇지 않으면 팟이 존재하지 않는 키를 참조하여 시작하지 못합니다. 차트를 설치하거나 업그레이드하기 전에 릴리스 네임스페이스에 Secret을 생성하세요.

라이선스는 하나의 소스(server.license.key 또는 server.license.existingSecret)만을 통해 구성해야 합니다. 아무것도 설정되지 않거나 소스가 결합되면 차트 렌더링이 실패합니다. server.extraEnv를 통해 전달된 라이선스는 소스로 인정되지 않으므로 대신 existingSecret를 사용하세요.

인프라 종속성#

차트는 postgresql, clickhouse 및 objectStorage 세 가지 인프라 종속성을 관리합니다. 각각은 기본적으로 내장 모드로 설정되어 차트가 클러스터 내부에 배포합니다. 대신 자체 외부 인스턴스를 사용하려면 종속성의 mode를 external로 설정하고 values.yaml에 연결 세부 정보를 입력하세요. 예를 들어, 외부 PostgreSQL 데이터베이스를 사용하려면:

yaml
# values.yaml
postgresql:
mode: external
external:
host: your-db-host
port: 5432
database: tuist
username: tuist
password: your-password

PostgreSQL 자격 증명을 Helm 외부에서 관리하는 경우, 차트가 기존 Kubernetes Secret을 참조하도록 설정하세요:

yaml
# values.yaml
postgresql:
mode: external
external:
port: 5432
database: tuist
existingSecret: tuist-postgresql
existingSecretKeys:
host: host
username: username
password: password

차트는 Secret에서 호스트, 사용자 이름 및 비밀번호를 읽고 Kubernetes 환경 변수 치환을 통해 DATABASE_URL를 구성하므로 비밀번호가 Helm 매니페스트에 렌더링되지 않습니다. Secret의 비밀번호 값은 데이터베이스 URL에 삽입되므로 URL 안전 형식이어야 합니다.

동일한 패턴이 clickhouse 및 objectStorage에도 적용됩니다. 차트의 values.yaml에서 각 섹션 아래의 external 블록을 참조하여 구성 가능한 전체 필드 목록을 확인하세요.

공유 스케줄링 및 라벨#

차트는 global 아래에 소수의 공유 팟 설정을 노출하므로, 운영자는 모든 워크로드에 대해 동일한 값을 반복하지 않고도 배포를 클러스터에 맞게 조정할 수 있습니다:

yaml
global:
podLabels:
environment: production
imagePullSecrets:
- name: ghcr-pull-secret
nodeSelector:
nodepool: apps
tolerations:
- key: dedicated
operator: Equal
value: apps
effect: NoSchedule

다음과 같은 경우에 이 설정을 사용하세요:

  • 모든 팟에 클러스터별 라벨 추가
  • 프라이빗 레지스트리에서 미러링된 이미지 풀
  • 전용 노드 풀 타겟팅
  • Tuist 워크로드용으로 예약된 테인트(tainted) 노드에 팟 배치 허용

워크로드 아이덴티티 및 서비스 계정#

차트는 애플리케이션 워크로드별로 서비스 계정의 범위를 지정하여 필요한 곳에만 아이덴티티를 부여할 수 있도록 합니다:

  • server.serviceAccount는 Tuist 서버 배포 및 마이그레이션 작업에 적용됩니다.
  • cache.serviceAccount는 캐시 배포에 적용됩니다.

예를 들어, EKS에서 캐시가 외부 S3 버킷을 사용하는 경우, 내장 데이터베이스에 동일한 IAM 역할을 첨부하지 않고도 캐시 워크로드에 대해 IRSA를 활성화할 수 있습니다:

yaml
cache:
serviceAccount:
create: true
annotations:
eks.amazonaws.com/role-arn: arn:aws:iam::123456789012:role/tuist-cache

호환성 재정의#

차트는 스토리지 및 메쉬별 조정을 옵트인으로 유지하여 기본값이 포터블하게 작동하도록 합니다:

yaml
cache:
podSecurityContext:
fsGroup: 990
clickhouse:
embedded:
service:
nativePort: 9100
systemLogs:
ttlDays: 7
supersededTables: delete
level: warning

클러스터에서 필요할 때만 이러한 재정의 값을 사용하세요:

  • cache.podSecurityContext는 기본적으로 비어 있습니다. 스토리지 클래스 또는 CSI 드라이버가 마운트된 볼륨에서 공유 그룹 소유권을 필요로 하는 경우 fsGroup를 설정하세요.
  • clickhouse.embedded.service.nativePort는 ClickHouse의 표준 9000 네이티브 서비스 포트를 기본값으로 사용하며, 서비스 메쉬나 플랫폼 예약이 해당 포트와 충돌할 때 변경할 수 있습니다.
  • clickhouse.embedded.systemLogs.ttlDays는 기본적으로 비어 있어, system.text_log, system.query_log, system.trace_log, system.metric_log 및 system.part_log와 같은 내장 내부 로그 테이블에 대한 ClickHouse의 무제한 보존 정책을 그대로 유지합니다. 이를 설정하면 해당 테이블을 한 번 덮어쓰므로, supersededTables: delete과 함께 채택하십시오 — 자세한 내용은 운영 로그 보존 제한을 참조하세요.
  • clickhouse.embedded.systemLogs.level는 내장 ClickHouse 서버 로거 및 system.text_log에 대해 기본적으로 information로 설정됩니다. ttlDays와 달리 이는 테이블 정의의 일부가 아니므로 변경해도 테이블을 덮어쓰지 않습니다.
  • clickhouse.embedded.systemLogs.supersededTables는 기본적으로 ignore로 설정되며, 시스템 로그 테이블을 대체할 때 ClickHouse가 남기는 <name>_N 테이블의 처리 방식을 결정합니다. 각 helm upgrade 시점에 이 테이블들을 삭제하려면 값을 delete로 설정하세요.
  • ttlDays 및 level에 대한 편집은 다음 ClickHouse 팟 재시작 시 반영됩니다. 둘 다 subPath 마운트이며, ConfigMap이 변경될 때 차트가 StatefulSet을 롤링하지 않기 때문입니다.

관측 가능성#

차트에는 선택적 관측 가능성 스택(OpenTelemetry Collector, Prometheus, Grafana, Loki 및 Tempo)이 포함되어 있습니다. 이는 기본적으로 비활성화되어 있습니다. values.yaml에서 이를 활성화하려면:

yaml
# values.yaml
observability:
enabled: true

활성화되면 Grafana에서 로그, 트레이스 및 메트릭 드릴다운이 미리 구성된 상태로 제공됩니다. 외부 관측 가능성을 사용하려면 이를 비활성화한 채로 두고 server.extraEnv를 통해 엔드포인트를 구성하세요:

yaml
# values.yaml
server:
extraEnv:
- name: TUIST_OTEL_EXPORTER_OTLP_ENDPOINT
value: "http://your-otel-collector:4317"
- name: TUIST_LOKI_URL
value: "http://your-loki:3100"

값 참조#

구성 가능한 값의 전체 목록은 차트의 values.yaml를 참조하세요.

배포#

공식 Tuist Docker 이미지는 다음 위치에서 사용할 수 있습니다:

yaml
ghcr.io/tuist/tuist

공개된 이미지에는 .xcactivitylog 아카이브용 내장 Linux 빌드 처리 기능이 포함되어 있으므로, 자체 호스팅 배포는 추가 서비스를 실행하지 않고도 빌드를 처리할 수 있습니다. ProcessBuildWorker Oban 작업은 각 서버 팟에서 인프로세스로 실행됩니다. 빌드 처리를 전용 레플리카 세트로 오프로드하려는 경우(예: 웹 티어와 독립적으로 파싱 처리량을 확장하기 위해), Helm 차트에서 processor.enabled: true를 설정하세요. 차트는 동일한 이미지를 큐 전용 컨슈머(TUIST_PROCESSOR_MODE=true)로 배포합니다. 전체 구성 옵션은 values.yaml를 참조하세요.

Note

.xcresult 파싱은 Xcode의 xcresulttool에 의존하므로 macOS에서만 실행할 수 있습니다. CLI는 자체 호스팅 배포를 위해 이를 투명하게 처리합니다. tuist test는 tuist.dev가 아닌 서버에 대해 기본적으로 로컬 처리 모드로 동작하며, 개발자 머신(Xcode가 이미 설치되어 있음)에서 xcresult를 파싱하고 구조화된 결과를 업로드합니다. 테스트 결과는 추가 인프라 없이 수집됩니다.

Docker 이미지 풀#

다음 명령어를 실행하여 이미지를 가져올 수 있습니다:

bash
docker pull ghcr.io/tuist/tuist:latest

이미지는 linux/amd64 및 linux/arm64 모두를 위해 공개되므로, Docker는 호스트의 네이티브 Linux 아키텍처를 자동으로 선택합니다.

또는 특정 버전을 풀하세요:

bash
docker pull ghcr.io/tuist/tuist:0.1.0

Docker 이미지 배포#

Docker 이미지의 배포 프로세스는 선택한 클라우드 제공업체와 조직의 지속적 배포(CD) 접근 방식에 따라 달라집니다. Kubernetes와 같은 대부분의 클라우드 솔루션 및 도구는 Docker 이미지를 기본 단위로 사용하므로, 이 섹션의 예시는 기존 설정과 잘 맞을 것입니다.

Warning

배포 파이프라인에서 서버가 실행 중인지 검증해야 하는 경우, /ready로 GET HTTP 요청을 보내고 응답에서 200 상태 코드를 확인하세요.

Fly#

Fly에 앱을 배포하려면 fly.toml 구성 파일이 필요합니다. 지속적 배포(CD) 파이프라인 내에서 동적으로 생성하는 것을 고려하세요. 아래는 참고용 예시입니다:

toml
app = "tuist"
primary_region = "fra"
kill_signal = "SIGINT"
kill_timeout = "5s"
[experimental]
auto_rollback = true
[env]
# Your environment configuration goes here
# Or exposed through Fly secrets
[processes]
app = "/usr/local/bin/hivemind /app/Procfile"
[[services]]
protocol = "tcp"
internal_port = 8080
auto_stop_machines = false
auto_start_machines = false
processes = ["app"]
http_options = { h2_backend = true }
[[services.ports]]
port = 80
handlers = ["http"]
force_https = true
[[services.ports]]
port = 443
handlers = ["tls", "http"]
[services.concurrency]
type = "connections"
hard_limit = 100
soft_limit = 80
[[services.http_checks]]
interval = 10000
grace_period = "10s"
method = "get"
path = "/ready"
protocol = "http"
timeout = 2000
tls_skip_verify = false
[services.http_checks.headers]
[[statics]]
guest_path = "/app/public"
url_prefix = "/"

그런 다음 fly launch --local-only --no-deploy를 실행하여 앱을 시작할 수 있습니다. 이후 배포에서는 fly launch --local-only 대신 fly deploy --local-only를 실행해야 합니다. Fly.io는 프라이빗 Docker 이미지 풀을 허용하지 않으므로 --local-only 플래그를 사용해야 합니다.

Prometheus 메트릭#

Tuist는 자체 호스팅 인스턴스를 모니터링할 수 있도록 /metrics에서 Prometheus 메트릭을 노출합니다. 이러한 메트릭에는 다음이 포함됩니다:

Finch HTTP 클라이언트 메트릭#

Tuist는 HTTP 클라이언트로 Finch를 사용하며, HTTP 요청에 대한 상세 메트릭을 노출합니다:

요청 메트릭#

  • tuist_prom_ex_finch_request_count_total - Finch 요청 총 횟수 (카운터)
    • 라벨: finch_name, method, scheme, host, port, status
  • tuist_prom_ex_finch_request_duration_milliseconds - HTTP 요청 지속 시간 (히스토그램)
    • 라벨: finch_name, method, scheme, host, port, status
    • 버킷: 10ms, 50ms, 100ms, 250ms, 500ms, 1s, 2.5s, 5s, 10s
  • tuist_prom_ex_finch_request_exception_count_total - Finch 요청 예외 총 횟수 (카운터)
    • 라벨: finch_name, method, scheme, host, port, kind, reason

연결 풀 대기열 메트릭#

  • tuist_prom_ex_finch_queue_duration_milliseconds - 연결 풀 대기열에서 대기한 시간 (히스토그램)
    • 라벨: finch_name, scheme, host, port, pool
    • 버킷: 1ms, 5ms, 10ms, 25ms, 50ms, 100ms, 250ms, 500ms, 1s
  • tuist_prom_ex_finch_queue_idle_time_milliseconds - 사용되기 전 연결이 유휴 상태였던 시간 (히스토그램)
    • 라벨: finch_name, scheme, host, port, pool
    • 버킷: 10ms, 50ms, 100ms, 250ms, 500ms, 1s, 5s, 10s
  • tuist_prom_ex_finch_queue_exception_count_total - Finch 대기열 예외 총 횟수 (카운터)
    • 라벨: finch_name, scheme, host, port, kind, reason

연결 메트릭#

  • tuist_prom_ex_finch_connect_duration_milliseconds - 연결을 설정하는 데 소요된 시간 (히스토그램)
    • 라벨: finch_name, scheme, host, port, error
    • 버킷: 10ms, 50ms, 100ms, 250ms, 500ms, 1s, 2.5s, 5s
  • tuist_prom_ex_finch_connect_count_total - 연결 시도 총 횟수 (카운터)
    • 라벨: finch_name, scheme, host, port

전송 메트릭#

  • tuist_prom_ex_finch_send_duration_milliseconds - 요청을 전송하는 데 소요된 시간 (히스토그램)
    • 라벨: finch_name, method, scheme, host, port, error
    • 버킷: 1ms, 5ms, 10ms, 25ms, 50ms, 100ms, 250ms, 500ms, 1s
  • tuist_prom_ex_finch_send_idle_time_milliseconds - 전송 전 연결이 유휴 상태였던 시간 (히스토그램)
    • 라벨: finch_name, method, scheme, host, port, error
    • 버킷: 1ms, 5ms, 10ms, 25ms, 50ms, 100ms, 250ms, 500ms

모든 히스토그램 메트릭은 상세 분석을 위해 _bucket, _sum 및 _count 변형을 제공합니다.

기타 메트릭#

Finch 메트릭 외에도 Tuist는 다음에 대한 메트릭을 노출합니다:

  • BEAM 가상 머신 성능
  • 맞춤 비즈니스 로직 메트릭 (저장소, 계정, 프로젝트 등)
  • 데이터베이스 성능 (Tuist 호스팅 인프라 사용 시)

운영#

Tuist는 인스턴스를 관리하는 데 사용할 수 있는 유틸리티 세트를 /ops/ 아래에 제공합니다.

인증

이메일 도메인이 TUIST_OPERATOR_EMAIL_DOMAIN와 일치하는 사용자만 /ops/ 엔드포인트에 접근할 수 있습니다. 변수가 설정되지 않으면 아무도 접근할 수 없습니다. 사용자가 제어하는 메일박스가 있는 도메인으로 설정하세요.

사용자는 또한 자신의 이메일 주소에 대한 통제권을 증명해야 합니다: 확인 또는 비밀번호 재설정 이메일을 따라가거나, Google, GitHub 또는 Apple로 로그인하거나, 일회성 코드를 입력하거나 에이전트 로그인의 검증된 이메일을 제시함으로써 가능합니다. 메일 제공자 없이 기본값으로 자동 확인된 계정은 그렇게 할 때까지 자격이 없습니다. 계정 생성 후 주소가 TUIST_OPERATOR_EMAIL_DOMAIN에 있는 동안에만 증명이 기록되므로, 변수를 설정하거나 변경한 후에는 해당 도메인에서 주소를 증명하지 않은 운영자가 다시 증명해야 합니다. 이러한 제공자 중 하나로 로그인하거나 에이전트 로그인을 통해 생성된 계정은 생성 시점부터 증명을 가지고 있습니다. 메일 제공자 없이 비밀번호로 등록된 계정은 이러한 제공자 중 하나를 연결할 수 없으므로, Google, GitHub 또는 Apple로 로그인하여 운영자 계정을 생성하거나 메일 제공자를 구성하세요.

이 검사가 존재하기 전에 생성된 계정은 아직 그 증명을 기록하지 않았으므로, 기존 운영자는 비밀번호를 재설정하거나 이러한 제공자 중 하나로 한 번 로그인하면 접근 권한을 다시 얻습니다.

해당 증명이 없는 운영자 도메인의 계정이 처음으로 그런 방식으로 주소를 증명하면, Tuist는 해당 계정의 비밀번호, 패스키 및 조직 단일 사인온 제공자에 대한 링크를 제거하고 브라우저와 CLI에서 로그아웃시킵니다. 이는 주소를 등록한 사람이 실제 소유자가 아닐 수 있기 때문입니다. 그러한 계정의 비밀번호 재설정도 새 비밀번호를 설정하는 것을 제외하고는 동일한 작업을 수행합니다. 계정에 설정된 인증기 앱은 유지됩니다; 만약 소유자의 것이 아니라면 대신 제거하세요. 운영자 도메인 외부의 확인된 계정은 자격 증명을 유지합니다. 소유자는 제공자를 통해 계속 로그인하거나 재설정을 통해 새 비밀번호를 설정합니다.

SCIM 프로비저닝이 생성하거나 이름을 변경한 계정은 소유자가 증명을 제공할 때까지 증명이 없습니다.

  • 오류 (/ops/errors): 애플리케이션에서 발생한 예상치 못한 오류를 볼 수 있습니다. 이는 디버깅과 문제 원인 파악에 유용하며, 문제가 발생하면 이 정보를 공유해 달라고 요청할 수 있습니다.
  • 대시보드 (/ops/dashboard): 애플리케이션의 성능과 상태(예: 메모리 사용량, 실행 중인 프로세스, 요청 수)에 대한 통찰력을 제공하는 대시보드를 볼 수 있습니다. 이 대시보드는 사용 중인 하드웨어가 부하를 처리하기에 충분한지 이해하는 데 매우 유용할 수 있습니다.