iOS CI/CD için macOS sunucu nasıl seçilir ve kurulur?

iOS ve macOS uygulamaları için sürekli entegrasyon gerçek bir Mac gerektirir: Xcode yalnızca macOS'ta çalışır ve macOS yalnızca Apple donanımında çalışır. Veri merkezindeki uzak bir Mac ayrıca kararlı bir bağlantı, webhook'lar ve izin listeleri için sabit bir IP adresi ve kimsenin gece kapatmadığı bir bilgisayar sağlar. Bu rehber sürümleri, boyutlandırmayı, çalıştırıcıyı ve kod imzalamayı ele alır.

Kısa cevap

App Store derlemeleri için Apple'ın şu anda istediği Xcode'u çalıştıran bir macOS sürümüne sahip Apple silicon bir Mac seçin. İki Xcode sürümü ve simülatörleri için yeterli bellek ve disk verin, UI testleri için oturum açılmış bir masaüstü tutun ve imzalama gizli bilgilerini deponuzun dışında saklayın.

1. adım: macOS ve Xcode'u Apple'ın gereksinimlerine uydurun

1. Bugünkü yükleme kuralını kontrol edin. 28 Nisan 2026'dan beri App Store yüklemeleri Xcode 26 veya sonrasıyla derlenmelidir.
2. Bir sonraki son tarihi planlayın. Apple, 27 SDK'larının Nisan 2027'den itibaren zorunlu olacağını duyurdu. O zaman ihtiyacınız olacak Xcode'u not edin.
3. Xcode'un ihtiyaç duyduğu macOS'u Apple'ın Xcode sistem gereksinimleri sayfasında bulun. Örneğin Xcode 27, macOS Tahoe 26.6 veya sonrasını ve Apple silicon bir Mac'i gerektirir.
4. Bunu sunan bir plan seçin. Sipariş formumuz her macOS planı için macOS sürümlerini listeler; Apple Silicon macOS VPS planları talep üzerine hazırlanır.

Apple silicon mı, Intel mi?

macOS Tahoe 26, Intel tabanlı Mac'ler için son macOS sürümüdür; macOS 27 ve güncel Xcode sürümleri Apple silicon gerektirir. Intel Mac'ler eski macOS sürümlerini veya x86_64 derlemelerini test etmek için hâlâ işe yarar, ama yeni bir App Store derleme sunucusu Apple silicon olmalıdır. Apple silicon'da derlemeler doğal olarak çalışır ve Xcode arm64 simülatör çalışma zamanlarını indirir; bu da disk alanından tasarruf sağlar. Apple Virtualization çatısı macOS konukları için iç içe sanallaştırma sunmadığından Apple Silicon macOS VPS içinde başka sanal makine çalıştıramazsınız; bunun için bir macOS VDS seçin.

2. adım: Sunucuyu boyutlandırın

Bunlar genel kurallardır: büyük projeler ve paralel işler daha fazlasını ister. Kendi derlemelerinizi ölçün.

3. adım: Mac'i hazırlayın

macOS sunucuda ilk adımlar rehberindeki gibi bağlanın, ardından:

sudo xcode-select -s /Applications/Xcode-26.app
xcodebuild -version
sudo xcodebuild -runFirstLaunch
sudo pmset -a sleep 0

Doğrulama: xcodebuild -version beklenen sürümü yazdırır ve pmset -g sleep 0 gösterir.

UI testleri için çalıştırıcının oturum açılmış bir masaüstü oturumuna ihtiyacı vardır: oturumun yeniden başlatmadan sonra geri gelmesi için Sistem Ayarları › Kullanıcılar ve Gruplar altında Otomatik olarak giriş yap ayarını açın (FileVault açıkken kullanılamaz).

4. adım: CI çalıştırıcısını kurun

• Xcode Cloud, Apple'ın barındırdığı CI'dır ve sunucu gerektirmez.
• GitHub Actions, GitLab Runner ve Jenkins kendi barındırdığınız macOS çalıştırıcılarını destekler; resmî kurulum rehberlerini izleyin ve çalıştırıcıyı deponuza veya grubunuza kaydedin.
• fastlane bunların hepsinde derleme, test, imzalama ve yükleme adımlarını otomatikleştirir.

UI testlerinin ve anahtar zinciri erişiminin çalışması için çalıştırıcıyı yalnızca arka plan servisi olarak değil, oturum açılmış oturumda bir kullanıcı ajanı olarak çalıştırın.

5. adım: Uzak bir Mac'te kod imzalama

1. Bir App Store Connect API anahtarı kullanın. App Store Connect'te bir ekip anahtarı oluşturun ve CI gizli bilgilerinizde saklayın. Apple özel anahtarı yalnızca bir kez indirmenize izin verir.
2. Sertifikaları deponun dışında tutun. Sertifikaları ve profilleri şifreli saklayın, örneğin fastlane match ile, ya da CI gizli bilgilerinden içe aktarın.
3. Her iş için geçici bir anahtar zinciri kullanın; başta oluşturun, sonda silin:

security create-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
security set-keychain-settings -lut 21600 build.keychain
security unlock-keychain -p "$KEYCHAIN_PASSWORD" build.keychain
security import signing.p12 -k build.keychain -P "$P12_PASSWORD" -T /usr/bin/codesign
security list-keychains -d user -s build.keychain login.keychain
security set-key-partition-list -S apple-tool:,apple: -s -k "$KEYCHAIN_PASSWORD" build.keychain

İşin sonunda:

security delete-keychain build.keychain

4. Xcode'un otomatik imzalamasına izin verin. xcodebuild, oturum açılmış bir Apple hesabı olmayan bir makinede API anahtarını kullanabilir:

xcodebuild -scheme MyApp -configuration Release -archivePath build/MyApp.xcarchive archive -allowProvisioningUpdates -authenticationKeyPath "$ASC_KEY_PATH" -authenticationKeyID "$ASC_KEY_ID" -authenticationKeyIssuerID "$ASC_ISSUER_ID"

5. Döndürün ve iptal edin. Sızmış olabilecek anahtarları iptal edin ve imzalamaya kimlerin erişimi olduğunu düzenli olarak gözden geçirin.

Diski sağlıklı tutun

Artık ihtiyacınız olmayan Xcode sürümlerini kaldırın, kullanılamayan simülatörleri xcrun simctl delete unavailable ile silin ve eski DerivedData'yı düzenli temizleyin. Apple'ın bir sonraki son tarihinden önce bir sonraki Xcode için yer planlayın.

Sorun giderme

errSecInternalComponent veya takılan imzalama istemleri. Anahtar zinciri kilitli ya da bölüm listesi eksik. Kilidi açın ve yukarıdaki gibi set-key-partition-list çalıştırın.

UI testleri yalnızca CI'da başarısız oluyor. Çalıştırıcının grafik oturumu yok. Onu oturum açılmış kullanıcı oturumunda çalıştırın ve otomatik oturum açmayı açık tutun.

"No space left on device". Simülatörleri, DerivedData'yı ve arşivleri temizleyin; bkz. macOS VPS ve VDS.

Sonraki adımlar

• Her macOS serisinin sundukları: macOS VPS ve VDS.
• Mac'e SSH erişimini güvenli hale getirin: SSH anahtarları.