Repo Android của bạn hiếm khi hỏng vì chọn sai nền tảng Git. Nó hỏng vì pipeline mất hai mươi phút mỗi lần push, vì keystore.jks nằm trong lịch sử commit, hoặc vì main không được bảo vệ nên ai cũng merge được lúc nửa đêm.
GitHub, GitLab và Bitbucket năm 2026 đều host Git tốt như nhau. Khác biệt thật nằm ở CI/CD, cách quản lý secret, mức tự chủ hạ tầng và công cụ đội bạn đang dùng mỗi ngày.
Mục lục
Cập nhật 2026: ba nền tảng, không có người thắng tuyệt đối
- GitHub Actions vẫn là mặc định của phần lớn dự án Android mã nguồn mở và startup, nhờ marketplace action phong phú và Gradle caching trưởng thành.
- GitLab CI giữ lợi thế ở pipeline nhất quán, self-host và bộ DevOps trong một sản phẩm.
- Bitbucket Pipelines thắng khi đội đã sống trong Jira và Confluence, không thắng bằng tính năng.
- Điểm chung: cả ba đều tính tiền cho phút CI và dung lượng vượt hạn mức; không gói miễn phí nào đủ cho app nhiều build variant chạy test mỗi pull request.
Git host không thay đổi Git
Remote repository chỉ là bản sao có địa chỉ mạng của lịch sử Git. git push gửi object và cập nhật ref, git clone kéo toàn bộ object về máy. Cả ba nền tảng dùng chung mô hình commit, branch, tag, merge, reflog.
Thứ bạn chọn không phải “Git nào” mà là lớp dịch vụ quanh Git: pull/merge request, phân quyền, CI, registry, audit log. Lớp này là proprietary và không đi cùng repo, nên mã nguồn luôn chuyển được còn issue, review comment và pipeline thì không — vendor lock-in thật nằm ở CI.
Ba mô hình hosting
SaaS công khai (github.com, gitlab.com, bitbucket.org) là mặc định: không quản lý server, cập nhật tự động, runner dùng chung; đổi lại bạn phụ thuộc mạng và chính sách nhà cung cấp.
Self-managed gồm GitHub Enterprise Server, GitLab self-managed và Bitbucket Data Center: bạn kiểm soát dữ liệu và phiên bản, nhưng trả bằng người vận hành — backup, nâng cấp, TLS, runner. Với đội không có ai làm hạ tầng, chi phí ẩn này thường lớn hơn tiền license.
Gói miễn phí và gói trả phí: đọc cấu trúc, đừng đọc con số
Giá đổi theo năm và khu vực; cấu trúc thì ổn định, xoay quanh bốn trục: số người dùng, dung lượng lưu trữ, phút CI, tính năng quản trị.
| Nền tảng | Gói miễn phí cho bạn gì | Gói trả phí mở khoá gì |
|---|---|---|
| GitHub | Repo private và cộng tác viên không giới hạn, Actions có hạn mức phút mỗi tháng cho repo private (repo public thường miễn phí CI), Packages có hạn mức dung lượng | Thêm phút và dung lượng, review bắt buộc, ruleset nâng cao, SSO, audit log, runner lớn hơn |
| GitLab | Repo private, runner dùng chung có hạn mức phút, Package Registry có hạn mức; Community Edition self-managed miễn phí | Approval rule nâng cao, epics, quét bảo mật, SSO/SCIM, thêm phút CI |
| Bitbucket | Repo private nhưng số thành viên workspace bị giới hạn — mức chặt nhất trong ba; Pipelines và LFS có hạn mức | Thêm người dùng và phút, default reviewer, merge check, SSO qua Atlassian Guard |
Với Android, thứ đáo hạn trước thường là phút CI, không phải số người dùng.
CI/CD cho Android: ba kiểu pipeline, một bài toán Gradle
Mọi pipeline Android đều làm cùng việc: checkout, JDK 17, Android SDK, khôi phục cache Gradle, chạy lint, test, assemble, upload artifact; khác nhau ở cú pháp và quyền kiểm soát runner.
| Nền tảng | File cấu hình | Điểm mạnh với build Android |
|---|---|---|
| GitHub | .github/workflows/*.yml |
Action sẵn cho Gradle/JDK, matrix variant dễ đọc, self-hosted runner nếu có máy |
| GitLab | .gitlab-ci.yml |
Cache key theo file, DAG qua needs, biến theo environment, runner tự dựng |
| Bitbucket | bitbucket-pipelines.yml |
Cú pháp gọn, cache khai báo một lần, trạng thái pipeline hiện trong pull request gắn Jira |
GitHub Actions: phổ biến nhất cho Android
# File: .github/workflows/android.yml
name: Android CI
on: [pull_request, push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
- uses: actions/setup-java@v6
with:
distribution: temurin
java-version: '17'
- uses: gradle/actions/setup-gradle@v6
- run: ./gradlew lint testDebugUnitTest assembleDebug --build-cache
- uses: actions/upload-artifact@v7
if: failure()
with:
name: reports
path: app/build/reports/
gradle/actions/setup-gradle lo phần quan trọng nhất: cache ~/.gradle/caches và wrapper. Không có nó, mỗi job tải lại toàn bộ dependency và AGP, và job 4 phút thành 12 phút.
GitLab CI và Bitbucket Pipelines
# File: .gitlab-ci.yml
image: eclipse-temurin:17-jdk
cache:
key:
files: [gradle/wrapper/gradle-wrapper.properties, gradle/libs.versions.toml]
paths: [.gradle/caches, .gradle/wrapper]
build:
script:
- ./gradlew assembleDebug --build-cache
# File: bitbucket-pipelines.yml
image: eclipse-temurin:17
definitions:
caches:
gradle: ~/.gradle/caches
pipelines:
pull-requests:
'**':
- step:
caches: [gradle]
script:
- ./gradlew lint testDebugUnitTest assembleDebug
Image GitLab ở trên cần Android SDK, hoặc cài command-line tools trong before_script — chỗ tốn thời gian nhất khi mới dựng pipeline; cache key theo libs.versions.toml giúp bump dependency làm mới cache đúng lúc. Cú pháp Pipelines ngắn hơn hai nền tảng kia nhưng ít khả năng tái sử dụng giữa các repo: không có composite action hay include mạnh như GitLab.
Vì sao cache Gradle là chuyện tiền
Phút CI bị tính khi job chạy, không khi job hữu ích. Pipeline không cache tải lại Kotlin compiler, AGP và toàn bộ AndroidX mỗi lần; pipeline có cache chỉ tải phần thay đổi. Bật thêm --build-cache để chia sẻ output task, và configuration cache nếu plugin trong dự án đã tương thích — Gradle 9.9 hỗ trợ tốt hơn hẳn vài bản trước. Với self-hosted runner, chi phí đổi từ tiền sang thời gian máy: một máy 16 GB RAM giữ cache nóng suốt ngày nhanh hơn runner cloud cache lạnh.
Code review và protected branches
Cả ba đều có pull/merge request với comment theo dòng, approval và trạng thái check. Khác biệt ở chi tiết: GitHub dùng rulesets áp cùng bộ luật cho nhiều repo, có bypass list và required check — mô hình mới thay dần branch protection cổ điển; GitLab dùng protected branch kèm approval rule, approval nâng cao ở gói trả phí; Bitbucket dùng branch permission kèm merge check và default reviewer trả phí.
Tối thiểu trên main: chặn force-push, chặn merge khi CI đỏ, một approval, bắt buộc cập nhật nhánh trước khi merge. Với Android, thêm CODEOWNERS cho libs.versions.toml, manifest và thư mục migration của Room — ba nơi đổi một dòng là ảnh hưởng toàn app.
Package registry: nơi AAR nội bộ sống
Khi tách module dùng chung thành AAR, bạn cần Maven registry. GitHub Packages và GitLab Package Registry đều cung cấp registry first-party, xác thực bằng token của CI. Với Bitbucket, artifact nội bộ thường nằm ở Artifactory, Nexus hoặc Maven Central — tính điều đó vào kiến trúc từ đầu. Credential registry phải nằm trong secret của CI, không trong gradle.properties, và version phải là số cụ thể thay vì SNAPSHOT cho build phát hành.
Secrets: keystore, service account và biến môi trường
GitHub có secret ở cấp repo, organization và environment; environment có thể yêu cầu reviewer trước khi job release chạy. GitLab có biến masked và protected, chỉ hiển thị trên protected branch; Bitbucket có secured variable ở cấp workspace hoặc repo. Quy tắc bất biến: keystore không bao giờ vào Git — encode base64, đưa vào secret, giải mã trong job rồi xoá.
echo "$KEYSTORE_BASE64" | base64 -d > "$RUNNER_TEMP/release.keystore"
./gradlew bundleRelease \
-Pandroid.injected.signing.store.file="$RUNNER_TEMP/release.keystore" \
-Pandroid.injected.signing.store.password="$KEYSTORE_PASSWORD"
rm -f "$RUNNER_TEMP/release.keystore"
Service account JSON của Google Play cũng là secret cùng hạng. Nếu sắp tự động hoá bước phát hành, xem lại quy trình tạo và ký APK/AAB trước.
Tích hợp: Android Studio, Jira, Slack
GitHub được Android Studio hỗ trợ ở mức tài khoản và tạo pull request trong IDE; GitLab và Bitbucket thường đi qua plugin JetBrains Marketplace hoặc CLI — hãy kiểm tra plugin trước khi cam kết. Với Jira, Bitbucket là lựa chọn tự nhiên: tên branch chứa key issue, panel Jira hiện trong pull request; GitHub và GitLab cần app tích hợp. Slack thì cả ba đều có app chính thức cho push, review request và deploy — chi tiết cấu hình, không phải tiêu chí chọn nền tảng.
SSO và quản trị người dùng
SAML SSO và SCIM gần như là tính năng trả phí ở cả ba: GitHub Enterprise, GitLab gói cao, Atlassian Guard. Nếu công ty có hàng trăm tài khoản và cần thu hồi quyền tức thời khi nhân sự rời đi, hãy tính khoản này từ đầu; với đội nhỏ, quản lý thành viên thủ công vẫn ổn và đừng mua tier chỉ vì SSO. GitLab CE self-host hỗ trợ LDAP/Active Directory nhưng SAML và SCIM nằm ở gói trả phí — lý do các tổ chức on-prem thường tiến lên EE dù khởi đầu bằng CE.
Self-hosting: GitLab CE là mặc định hợp lý
Khi dữ liệu không được rời hạ tầng nội bộ, phương án nhanh nhất thường là GitLab CE: repo, CI, registry trong một gói cài đặt, có đường nâng cấp lên EE mà không đổi quy trình. GitHub Enterprise Server mạnh tương đương cloud nhưng gắn với license và appliance; Bitbucket Data Center giữ lợi thế Jira nhưng là bài toán vận hành nặng nhất. Chi phí thật của self-host nằm ở runner và dung lượng, không ở license — đừng self-host nếu không có người chịu trách nhiệm backup và nâng cấp định kỳ.
Bảng quyết định
| Bối cảnh của bạn | Nên chọn | Vì sao |
|---|---|---|
| Cá nhân, portfolio, mã nguồn mở | GitHub | Cộng đồng lớn nhất, action có sẵn, người review ở cùng nơi |
| Startup 5–20 người, app thương mại | GitHub hoặc GitLab | GitHub nếu ưu tiên hệ sinh thái; GitLab nếu muốn CI và registry trong một sản phẩm |
| Đội đã dùng Jira và Confluence | Bitbucket | Luồng issue, branch, PR liền mạch, ít phải dạy lại công cụ |
| Doanh nghiệp cần SSO, audit, nhiều team | GitHub Enterprise hoặc GitLab EE | Quản trị tập trung, policy cấp tổ chức, hỗ trợ có hợp đồng |
| Yêu cầu on-prem hoặc air-gapped | GitLab CE/EE hoặc Bitbucket Data Center | Dữ liệu nội bộ, CI và registry cùng máy, kiểm soát phiên bản |
| Monorepo Android cộng backend, pipeline dài | GitLab | DAG, cache theo file và runner tự dựng giúp kiểm soát thời gian build |
Khi nào nên migrate, khi nào không
Di chuyển mã nguồn dễ hơn bạn tưởng, vì Git không quan tâm host:
git clone --mirror git@github.com:evotek/my-app.git
cd my-app.git
git remote set-url origin git@gitlab.com:evotek/my-app.git
git push --mirror
--mirror mang theo mọi branch, tag và ref ẩn. Thứ không đi cùng: issue, pull request, comment review, runner, secret, webhook và lịch sử CI. Với đội nhỏ, đó là một đến hai tuần; với tổ chức có compliance, là vài tháng.
Nên migrate khi bạn thật sự bị chặn: phút CI vượt kiểm soát, cần self-host vì khách hàng yêu cầu, hoặc tổ chức hợp nhất về một công cụ. Đừng migrate vì nền tảng kia có tính năng bạn sẽ không dùng — chi phí chuyển đổi luôn lớn hơn lợi ích danh nghĩa đó.
Bốn lỗi hay gặp
1. Commit secret rồi chỉ xoá ở commit mới nhất
Xoá file trong commit mới không xoá nó khỏi lịch sử; ai clone cũng lấy được. Keystore lộ nghĩa là ai đó có thể ký bản cập nhật giả: rotate khoá, viết lại lịch sử bằng git filter-repo, rồi thông báo toàn đội re-clone.
2. CI đắt vì Gradle không được cache
Triệu chứng: mỗi pull request chạy 15–20 phút, hạn mức phút cạn giữa tháng. Nguyên nhân gần như luôn là cache sai đường dẫn hoặc cache key đổi mỗi lần chạy; kiểm tra log xem Gradle có in FROM-CACHE không.
3. Vendor lock-in qua cú pháp CI proprietary
Pipeline 400 dòng nhúng logic build, ký, upload vào YAML riêng của nền tảng sẽ làm việc chuyển đổi tốn gấp ba lần. Giữ logic trong Gradle và scripts/; YAML chỉ nên gọi ./gradlew và vài lệnh mỏng. Khi đó đổi nền tảng là việc vài ngày, không phải một quý.
4. Không bật branch protection
Repo không có luật thì main sẽ bị force-push đúng tuần trước release. Bật protected branch và required check ngay ngày đầu, trước khi có người thứ hai trong repo.
2027: những gì đang dịch chuyển
Review bằng AI trong pull request đã thành mặc định ở gói trả phí, nhưng vai trò của nó là lọc lỗi cơ học, không thay người quyết định kiến trúc. Đáng theo dõi là OIDC thay dần secret dài hạn khi CI cần quyền vào cloud, và runner ARM64 self-hosted rẻ hơn về thời gian build so với runner x86 dùng chung.
Checklist trước khi chốt nền tảng
- Đã bật protected branch cho
main, chặn force-push và merge khi CI đỏ. - Đã có pipeline cache Gradle và đo thời gian build thực tế, không cảm tính.
- Keystore và service account JSON nằm trong secret store, không trong repo.
- Đã kiểm tra gói miễn phí đủ cho số pull request mỗi tháng, cộng biên dự phòng.
- Đã xác định ai vận hành runner, backup nếu self-host, và đã thử migrate một repo nhỏ bằng
--mirror.
Nếu bạn mới bắt đầu, đọc lại bài Git và quản lý phiên bản để nắm vòng lặp hằng ngày, và bài Gradle để hiểu vì sao cache quyết định hóa đơn CI. Toàn bộ thứ tự học nằm trong lộ trình Android tổng quan. Nền tảng nào cũng đủ tốt cho một app Android năm 2026; thứ quyết định chất lượng repo là branch protection, secret đúng chỗ và pipeline biết cache — ba việc bạn làm được trên cả GitHub, GitLab và Bitbucket.



