콘텐츠로 이동

Buildkite

초대 전용

Tuist Runners는 현재 초대 전용입니다. 계정 접근 권한을 요청하려면 문의하거나 커뮤니티 Slack에서 메시지를 보내주세요.

Tuist는 Buildkite 클러스터의 자체 호스팅 큐를 모니터링하고, 발견한 작업을 플릿에서 실행합니다. 파이프라인은 Buildkite에서 계속 실행되며, 컴퓨팅 리소스만 변경됩니다. 플릿에서 작업을 실행하려면 세 가지 변경이 필요합니다: 클러스터를 연결하고, Tuist 프로필 이름을 따서 큐를 명명하며, 단계에서 해당 큐를 대상으로 지정하세요.

  1. 클러스터를 연결하세요. Buildkite에서 클러스터를 열고 Agent Tokens으로 이동하여 토큰을 생성하세요. 토큰은 bkct_로 시작합니다. Tuist 대시보드에서 Settings → Integrations으로 이동하고, Buildkite 카드에서 Connect를 선택한 후 조직 슬러그와 토큰을 입력하세요. 토큰은 암호화되어 저장되며 다시 표시되지 않습니다. 나중에 조직을 변경하거나 토큰을 교체하려면 카드의 필드를 편집하고 Save changes를 선택하세요. Tuist는 1분 이내에 클러스터 모니터링을 시작합니다.

  2. Tuist 프로필 이름을 따서 큐를 명명하세요. 모든 활성화된 계정은 즉시 사용 가능한 두 개의 프로필, linux 및 macos과 함께 시작되며, 큐 키가 프로필 라벨과 일치할 때 작업이 수집됩니다. 클러스터에서 tuist-linux 및 tuist-macos 키를 사용하여 자체 호스팅 큐를 생성한 다음, 단계에서 하나를 대상으로 지정하세요:

    yaml
    # .buildkite/pipeline.yml
    steps:
    - label: "Test"
    command: tuist test
    agents:
    queue: tuist-macos # or tuist-linux
  3. 푸시하고 모니터링하세요. 작업이 큐에 추가되고 러너에 의해 할당되며, Tuist 대시보드의 Runners 섹션으로 스트리밍됩니다. 여기서 로그, 단계 및 머신 지표를 확인할 수 있습니다. 러너는 해당 작업에만 범위가 제한된 자격 증명을 사용하여 작업 내부에서 로그를 전송하므로 Buildkite API 토큰이 필요하지 않습니다.

일시 중지 및 연결 해제#

Buildkite 큐의 디스패치를 일시 중지하면 Tuist가 해당 큐에서 새 작업을 가져오지 않습니다. 이미 실행 중인 작업에는 영향을 미치지 않습니다.

Settings → Integrations 아래의 Buildkite 카드에서 클러스터 연결을 해제하면 Tuist가 해당 클러스터 모니터링을 완전히 중단합니다.

캐시 볼륨#

캐시 볼륨을 사용하여 작업 간에 Xcode, 모듈 및 Gradle 캐시와 기타 디렉터리를 유지하세요. 체크아웃 후와 이를 사용하는 명령어 전에 추가하세요.