継続的インテグレーション（CI）

レジストリは、追加の認証設定なしで CI 上でそのまま動作します。デフォルトでは、認証されていないリクエストは IP アドレスごとに 1分あたり1,000リクエスト にレート制限されます。

1分あたり20,000リクエスト のより高いレート制限が必要な場合は、tuist registry login を実行して認証できます。これには TUIST_TOKEN 環境変数の設定が必要です。プロジェクトトークンは、ドキュメントこちらの手順に従って作成できます。

Note

以下のキーチェーン設定は、tuist registry login を使用してより高いレート制限を取得する場合にのみ必要です。ほとんどの場合、デフォルトの認証なしのレート制限で十分であり、この設定は完全に省略できます。

さらに、事前にロック解除された新しいキーチェーンを作成するのは、パッケージの Xcode インテグレーションを使用する場合にのみ必要です。

tuist registry login は資格情報をキーチェーンに保存するため、CI 環境でキーチェーンにアクセスできるようにする必要があります。一部の CI プロバイダーや Fastlane のような自動化ツールは、すでに一時キーチェーンを作成するか、作成するための組み込み方法を提供している点に注意してください。ただし、以下のコードを使用してカスタムステップを作成し、キーチェーンを作成することもできます。

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 を指定するのが最善の方法です。これは、Config.swift ファイルに以下を追加することで実現できます。

swift

import ProjectDescription

let config = Config(
    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 }}