Bitrise — các khái niệm chính, Workflows và tích hợp liên tục

Bitrise là gì?

Bitrise là nền tảng CI/CD ra mắt năm 2016 và hoàn toàn tập trung vào phát triển di động. Không giống như các giải pháp phổ quát như GitHub Actions và GitLab CI, Bitrise được thiết kế ban đầu để tự động hóa việc xây dựng ứng dụng iOS và Android. Nền tảng hoạt động trên đám mây và cung cấp các runner được lưu trữ riêng với macOS và Linux. Bitrise hỗ trợ tất cả các ngăn xếp di động phổ biến: Swift, Kotlin, Flutter, React Native, Cordova và Xamarin.

Lợi thế chính của Bitrise là các mẫu Step được cấu hình sẵn cho các tác vụ phát triển di động điển hình: xây dựng Xcode, Gradle assemble, Fastlane, Firebase Distribution, TestFlight, Google Play. Việc thiết lập pipeline chỉ mất vài phút thông qua trình chỉnh sửa trực quan và cấu hình YAML được tạo tự động trong tệp bitrise.yml. Đối với người dùng có kinh nghiệm, trình chỉnh sửa YAML với tính năng tự động hoàn thành có sẵn.

Kiến trúc Bitrise: Workflows và Steps

Kiến trúc Bitrise được xây dựng trên hai khái niệm chính: Workflow và Step. Workflow là một chuỗi Steps xác định pipeline. Mỗi dự án có thể có nhiều Workflow: primary (xây dựng chính), deploy (xuất bản), test (chỉ kiểm thử). Workflow được kích hoạt bởi các sự kiện: push, PR, tag hoặc theo lịch trình. Workflow cũng có thể được khởi chạy thủ công từ giao diện web, hữu ích cho các bản dựng đột xuất.

Step là một mô-đun nguyên tử thực hiện một tác vụ duy nhất. Các Steps có thể được kéo trong trình chỉnh sửa trực quan, thay đổi thứ tự và cấu hình của chúng. Bitrise cung cấp Steps cho Xcode Archive & Export, Gradle Runner, CocoaPods Install, Firebase Distribution và thông báo Slack. Cộng đồng cũng tạo Steps — chúng có sẵn thông qua Step Library. Mỗi Step có các tham số đầu vào bắt buộc và tùy chọn, cũng như các biến đầu ra có thể được sử dụng bởi các Steps tiếp theo.

Bitrise hỗ trợ khái niệm Pipeline — kết hợp nhiều Workflow thành một pipeline duy nhất. Một Pipeline có thể bao gồm các bản dựng chính cho tất cả các nền tảng và các workflow riêng biệt cho triển khai và kiểm thử. Điều này cho phép tạo ra các quy trình CI/CD phức tạp nơi một bản dựng kích hoạt bản dựng khác. Bitrise Stacks xác định phần mềm được cài đặt sẵn trên runner: Xcode, Android SDK, Flutter, Node.js và các công cụ khác.

Các Steps phổ biến cho dự án di động

• Xcode Archive & Export — xây dựng và xuất IPA với quản lý hồ sơ cấp phép
• Gradle Runner — chạy tác vụ Gradle với đối số và bộ nhớ đệm
• Flutter Build — xây dựng ứng dụng Flutter cho iOS và Android
• Firebase App Distribution — xuất bản bản dựng cho người kiểm thử
• Certificate and Profile Installer — cài đặt tự động chứng chỉ ký mã

Tích hợp Bitrise với kho lưu trữ Git

Bitrise tích hợp với GitHub, GitLab, Bitbucket và Azure DevOps. Khi kết nối kho lưu trữ, Bitrise tự động phát hiện loại dự án (iOS, Android, Flutter) và đề xuất mẫu Workflow. Đối với kho lưu trữ riêng tư, Bitrise yêu cầu quyền truy cập qua OAuth hoặc khóa SSH. Nhiều kho lưu trữ có thể được kết nối với một ứng dụng duy nhất.

Sau khi kết nối, Bitrise tạo một webhook trong kho lưu trữ để tự động bắt đầu các bản dựng khi push và PR. Mỗi bản dựng nhận được một số duy nhất, nhật ký và các tạo phẩm. Giao diện cho phép duyệt lịch sử bản dựng, so sánh các thay đổi và khởi động lại các bản dựng thất bại. Bitrise cũng hỗ trợ các bản dựng theo lịch trình cho các bản dựng hàng đêm thường xuyên và tích hợp với Jira để theo dõi commit.

Code Signing và xuất bản lên App Store và Google Play

Ký mã cho iOS là một trong những tác vụ CI/CD phức tạp nhất và Bitrise giải quyết nó một cách đơn giản nhất có thể. Nền tảng lưu trữ chứng chỉ và hồ sơ cấp phép ở dạng mã hóa, tự động cài đặt chúng vào keychain thích hợp trước khi xây dựng và xuất IPA đã ký. Step Certificate and Profile Installer tải xuống các tệp từ bộ lưu trữ Bitrise và cấu hình Xcode. Các loại chứng chỉ Development, AdHoc, AppStore và Enterprise được hỗ trợ.

Để xuất bản lên App Store Connect, Bitrise cung cấp Steps để tải IPA lên qua Xcode Archive & Export. Xuất bản lên Google Play sử dụng Gradle Runner với chữ ký qua Keystore, sau đó APK/AAB được tải lên Google Play Console qua Google Play Deploy Step. Đối với Firebase App Distribution, chỉ cần chỉ định Firebase Token và nhóm người kiểm thử. Bitrise tự động cập nhật số phiên bản và số bản dựng trước mỗi lần xuất bản.

Thiết lập code signing trong Bitrise

Các chứng chỉ được tải lên trong phần Code Signing của giao diện web: P12 với khóa riêng tư, hồ sơ cấp phép (.mobileprovision), Keystore (.jks/.keystore) cho Android. Bitrise tự động cài đặt chứng chỉ iOS vào keychain mỗi lần chạy Workflow và xuất ứng dụng đã ký. Đối với Android, chỉ cần tải lên tệp Keystore — Bitrise chuyển nó đến Gradle thông qua các biến môi trường trong quá trình xây dựng.

Ví dụ cấu hình Bitrise cho Flutter

Hãy xem xét một Workflow cho ứng dụng Flutter để xây dựng và xuất bản các bản dựng cho iOS và Android. Bitrise tự động phát hiện dự án Flutter và đề xuất các Steps phù hợp. Workflow bao gồm cài đặt Flutter, bộ nhớ đệm pub-cache, xây dựng, kiểm thử và triển khai. Đối với các bản dựng iOS, cần thêm chứng chỉ ký mã mà Bitrise tải tự động.

Khi xây dựng ứng dụng Flutter, Bitrise hỗ trợ cấu hình riêng biệt cho từng nền tảng. Các bản dựng Android chạy trên runner Linux với Flutter SDK, iOS trên runner macOS. Workflow có thể bao gồm các Steps có điều kiện: build_android và build_ios, chỉ chạy trên các nền tảng tương ứng. Đối với các dự án React Native, Bitrise cung cấp bộ Steps tương tự với npm/nvm và Metro bundler.

format_version: 13
default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git

trigger_map:
- push_branch: main
  workflow: primary

workflows:
  primary:
    steps:
    - activate-ssh-key@4:
        run_if: true
    - git-clone@8: {}
    - flutter-installer@0:
        inputs:
        - version: 3.24.0
    - flutter-build@0:
        inputs:
        - platform: both
        - ios_output_type: archive
    - deploy-to-bitrise-io@2: {}

Step tùy chỉnh cho triển khai

Sau khi xây dựng, có thể thêm Step Firebase App Distribution cho iOS và Android. Step chấp nhận firebase_token, app_id và testers_group. Bitrise thay thế các giá trị từ Secrets — lưu trữ token an toàn đảm bảo chúng không xuất hiện trong nhật ký.

- firebase-app-distribution@1:
    inputs:
    - firebase_token: $FIREBASE_TOKEN
    - app_id: $FIREBASE_IOS_APP_ID
    - testers_group: qa-team
    - release_notes: |
        Build $BITRISE_BUILD_NUMBER

Secrets và quản lý môi trường

Quản lý dữ liệu bảo mật đúng cách là nền tảng của an ninh cho các quy trình CI/CD. Bitrise Secrets được mã hóa và không thể đọc được sau khi lưu. Khi tạo ứng dụng mới, Bitrise đề xuất nhập secrets từ dự án khác hoặc đặt thủ công. Đối với các nhóm lớn, tính năng Environment Groups có sẵn — quản lý tập trung các biến và secrets cho một nhóm ứng dụng.

Bitrise cung cấp kho lưu trữ Secrets tích hợp cho dữ liệu bảo mật: khóa API, token Firebase, mật khẩu Keystore, Apple ID. Secrets được định nghĩa dưới dạng cặp khóa-giá trị trong giao diện web và được che dấu trong nhật ký bản dựng. Chúng có sẵn ở cấp độ ứng dụng và cấp độ Workflow. Secrets không thể đọc được sau khi lưu — chúng chỉ có thể bị ghi đè.

Các Biến Môi trường (không có cờ Secret) được sử dụng cho cấu hình: phiên bản Xcode, đường dẫn dự án, lược đồ xây dựng. Các biến môi trường Bitrise (BITRISE_BUILD_NUMBER, BITRISE_APP_TITLE) cung cấp thông tin siêu dữ liệu về bản dựng. Secrets được mã hóa khi lưu trữ và chỉ được giải mã trên runner trong quá trình thực thi Workflow. Để quản lý biến theo nhóm, Bitrise hỗ trợ Environment Groups — các tập hợp biến có thể áp dụng cho nhiều ứng dụng cùng lúc.

Việc quản lý chứng chỉ iOS thông qua Bitrise đáng được chú ý đặc biệt. Nền tảng tự động cài đặt P12 và hồ sơ cấp phép vào keychain hệ thống trước khi xây dựng. Đối với Android, tệp Keystore được sử dụng, tải lên trong phần Code Signing. Mỗi tệp chứng chỉ được lưu trữ mã hóa và chỉ được giải mã trong quá trình xây dựng.

Ví dụ sử dụng Secrets

- google-play-deploy@3:
    inputs:
    - package_name: com.example.app
    - service_account_json_key: $SERVICE_ACCOUNT_KEY
    - app_file: $BITRISE_APK_PATH

Stacks và môi trường Bitrise

Bitrise cung cấp nhiều stack khác nhau cho việc xây dựng — các hình ảnh được cài đặt sẵn với các công cụ và SDK. Các stack có sẵn bao gồm Xcode (phiên bản 14, 15, 16 với iOS SDK 17, 18), Android (với các phiên bản SDK và NDK khác nhau), Flutter, React Native và Kotlin Multiplatform. Mỗi stack có mô tả về các công cụ và phiên bản được cài đặt sẵn.

Việc chọn stack ảnh hưởng đến thời gian xây dựng và khả năng tương thích với dự án. Bitrise thường xuyên cập nhật các stack, thêm các phiên bản công cụ mới. Có thể cố định một phiên bản stack cụ thể trong bitrise.yml để tránh các thay đổi bất ngờ khi nền tảng được cập nhật. Đối với các phụ thuộc tùy chỉnh, Script Step được sử dụng để cài đặt các gói cần thiết trước khi xây dựng chính. Bitrise cũng hỗ trợ hình ảnh Docker cho các stack Linux, cho phép môi trường tùy chỉnh cho các bản dựng Android.