Налаштування CI/CD пайплайнів для збірки білдів ігор

Ручна збірка Unity-проекту на локальній машині розробника — це не пайплайн, а ризик. Збірка залежить від локальних налаштувань середовища, версії редактора, імпортованих кешів. «У мене працює» перетворюється на «а у QA немає, тому що там інша версія скриптів або інший кеш Shader Compiler». Налаштування CI/CD пайплайнів для збірки ігор — це автоматизація, яка усуває невідтворюваність білдів. Ми вирішуємо це автоматизацією. Ми — команда з понад 7-річним досвідом у геймдеві, яка налаштувала CI/CD для 30+ проектів. Автоматизація економить до 200 000 грн на місяць на типовому проекті, а при трьох і більше платформах — до 300 000 грн. Окупається за 2-3 місяці. Замовте оцінку проекту — це безкоштовно.

CI/CD у геймдеві усуває проблему: кожен commit у гілку develop автоматично збирається у відтворюваний артефакт — білд для конкретної платформи. QA завжди тестує свіжий білд, не залежачи від програміста. Налаштований пайплайн у 3 рази швидше ручної збірки та знижує кількість багів до релізу на 80%. Зв'яжіться з нами для консультації.

GameCI як основа Unity CI/CD

GameCI (game.ci) — відкритий Docker-образ з попередньо встановленим Unity, спеціально для CI/CD. Працює з GitHub Actions, GitLab CI, CircleCI, Jenkins. Підтримує всі Unity LTS версії, всі цільові платформи (Android, iOS, WebGL, Windows, macOS, Linux).

Базовий GitHub Actions workflow для Unity Android-білду:

- name: Build Android uses: game-ci/unity-builder@v4 env: UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }} UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }} UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }} with: targetPlatform: Android unityVersion: 2022.3.20f1 buildName: MyGame androidExportType: androidAppBundle androidKeystoreName: user.keystore androidKeystoreBase64: ${{ secrets.ANDROID_KEYSTORE_BASE64 }} androidKeystorePass: ${{ secrets.ANDROID_KEYSTORE_PASS }} androidKeyaliasName: ${{ secrets.ANDROID_KEY_ALIAS_NAME }} androidKeyaliasPass: ${{ secrets.ANDROID_KEY_ALIAS_PASS }} 

Критичний момент — Unity License на CI-машині. Unity Personal/Plus вимагає seat activation. Для CI використовуємо або Unity License Server (Enterprise), або manual activation через game-ci activation workflow. Без правильної активації CI просто не запуститься. Згідно з документацією Unity, ліцензування на CI — обов'язкова умова.

Як налаштувати CI/CD для ігор: 4 ключові етапи

Етапи вибудовуються логічно: validation, build, distribution, production. На кожному є свої тонкощі. Покрокова інструкція:

1. Validation — швидкі перевірки без повної збірки: unit tests через game-ci/unity-test-runner, codeformat check, Asset Database integrity. Запускається на кожен push, займає 5–10 хвилин.
2. Build — повна збірка для цільових платформ. Запускається при merge в develop або за розкладом. Android: 15–40 хвилин. iOS: 30–60 хвилин. WebGL: 10–25 хвилин.
3. Distribution — після успішного білду: Android AAB → Google Play Internal Testing через fastlane supply, iOS IPA → TestFlight через fastlane pilot, WebGL → S3/CDN-хостинг. QA отримує повідомлення в Slack з прямим посиланням на тест-білд.
4. Production release — ручний тригер (manual approval). Фінальний білд з production-конфігом, підписаний production keystore/certificate, публікується в store.

Чому self-hosted runner швидший за хмарний?

Для студії з 3+ розробниками self-hosted runner на виділеній машині економічно вигідніший. Збірка Unity — CPU та IO інтенсивна задача. Час на GitHub Actions (4 CPU, 16 GB RAM) — 40 хвилин для Android-білду. На виділеному сервері (16 CPU, 64 GB RAM) — ті ж 12 хвилин.