콘텐츠로 이동

지속적 통합(CI)

레지스트리는 추가 인증 설정 없이 CI에서 즉시 작동합니다. 기본적으로 인증되지 않은 요청은 IP 주소당 분당 1,000회 요청으로 속도 제한이 적용됩니다.

분당 20,000회 요청의 더 높은 속도 제한이 필요한 경우, tuist registry login를 실행하여 인증할 수 있습니다. 이때 TUIST_TOKEN 환경 변수가 설정되어 있어야 합니다. 인증 가이드를 따라 계정 토큰을 생성할 수 있습니다.

Note

아래의 키체인 설정은 tuist registry login를 사용하여 더 높은 속도 제한을 얻으려는 경우에만 필요합니다. 대부분의 경우 기본 인증 없는 속도 제한으로 충분하므로 이 단계를 완전히 건너뛸 수 있습니다.

또한, 새로 잠금 해제된 키체인을 생성하는 것은 패키지의 Xcode 통합을 사용할 때만 필요합니다.

tuist registry login는 자격 증명을 키체인에 저장하므로 CI 환경에서 키체인에 접근할 수 있는지 확인해야 합니다. Fastlane과 같은 일부 CI 제공업체나 자동화 도구는 이미 임시 키체인을 생성하거나 생성 방법을 내장되어 제공합니다. 그러나 다음 코드를 사용하여自定义 단계를 만들어 직접 생성할 수도 있습니다:

bash
TMP_DIRECTORY=$(mktemp -d)
KEYCHAIN_PATH=$TMP_DIRECTORY/keychain.keychain
KEYCHAIN_PASSWORD=$(uuidgen)
security create-keychain -p $KEYCHAIN_PASSWORD $KEYCHAIN_PATH
security set-keychain-settings -lut 21600 $KEYCHAIN_PATH
security default-keychain -s $KEYCHAIN_PATH
security unlock-keychain -p $KEYCHAIN_PASSWORD $KEYCHAIN_PATH

tuist registry login를 실행하기 전 에 기본 키체인이 생성되고 잠금 해제되었는지 확인하세요.

환경 간 증분 해결#

저희 레지스트리를 사용하면 깨끗한/콜드 해결이 약간 더 빠르며, CI 빌드 전체에서 해결된 의존성을 지속하면 더욱 큰 개선 효과를 경험할 수 있습니다. 레지스트리 덕분에 저장하고 복원해야 하는 디렉터리 크기가 레지스트리 없이 사용할 때보다 훨씬 작아져 시간이 크게 절약됩니다. 기본 Xcode 패키지 통합을 사용할 때 의존성을 캐시하는 가장 좋은 방법은 xcodebuild를 통해 의존성을 해결할 때自定义 clonedSourcePackagesDirPath를 지정하는 것입니다. 이는 Tuist.swift 파일에 다음을 추가하여 수행할 수 있습니다:

swift
import ProjectDescription
let tuist = Tuist(
project: .tuist(
generationOptions: .options(
additionalPackageResolutionArguments: ["-clonedSourcePackagesDirPath", ".build"]
)
)
)

또한 Package.resolved의 경로를 찾아야 합니다. ls **/Package.resolved를 실행하여 경로를 확인할 수 있습니다. 경로는 App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved와 유사해야 합니다.

Swift 패키지 및 XcodeProj 기반 통합의 경우, 프로젝트 루트 또는 Tuist 디렉터리에 위치한 기본 .build 디렉터리를 사용할 수 있습니다. 파이프라인을 설정할 때 경로가 올바른지 확인하세요.

다음은 기본 Xcode 패키지 통합을 사용할 때 의존성을 해결하고 캐시하기 위한 GitHub Actions 워크플로우 예제입니다:

yaml
- name: Restore cache
id: cache-restore
uses: actions/cache/restore@v4
with:
path: .build
key: ${{ runner.os }}-${{ hashFiles('App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved') }}
- name: Resolve dependencies
if: steps.cache-restore.outputs.cache-hit != 'true'
run: xcodebuild -resolvePackageDependencies -clonedSourcePackagesDirPath .build
- name: Save cache
id: cache-save
uses: actions/cache/save@v4
with:
path: .build
key: ${{ steps.cache-restore.outputs.cache-primary-key }}