Tích hợp Git
Thiết lập tích hợp Git cho triển khai tự động với TOSE CLI.
Tổng quan
TOSE CLI tích hợp với Git repository để cho phép:
- Tự động phát hiện - Tự động phát hiện Git remote và nhánh
- Triển khai liên tục - Triển khai khi Git push
- Nhiều nhà cung cấp - Hỗ trợ GitHub, GitLab, Bitbucket
- Chọn nhánh - Triển khai từ bất kỳ nhánh nào
Nhà cung cấp Git được hỗ trợ
- GitHub - github.com
- GitLab - gitlab.com và self-hosted
- Bitbucket - bitbucket.org
- Generic Git - Bất kỳ Git server nào
Tự động phát hiện Git
Cách hoạt động
Khi chạy tose up, TOSE CLI tự động:
- Kiểm tra thư mục
.git - Đọc
git remote get-url origin - Liệt kê các nhánh có sẵn
- Gợi ý nhánh hiện tại
Ví dụ
bash
$ tose up
✓ Phát hiện Git repository: https://github.com/username/my-app
✓ Nhánh hiện tại: main
? Xác nhận URL Git repository: (Y/n)Định dạng URL
Định dạng HTTPS
bash
https://github.com/username/repo.git
https://gitlab.com/username/repo.git
https://bitbucket.org/username/repo.gitĐịnh dạng SSH
bash
git@github.com:username/repo.git
git@gitlab.com:username/repo.git
git@bitbucket.org:username/repo.gitGitHub Shorthand
bash
username/repoTự động mở rộng thành: https://github.com/username/repo.git
Chọn nhánh
Chọn tương tác
bash
? Chọn nhánh:
❯ main
develop
staging
feature/new-apiCấu hình Git thủ công
Nếu tự động phát hiện thất bại:
bash
$ tose up
? Nhập URL Git repository: https://github.com/username/my-app
? Chọn nhánh: mainLiên kết Repository
Git repository được tự động liên kết khi bạn:
- Cung cấp URL Git trong
tose up - Xác nhận cấu hình
- Triển khai
bash
✓ Git repository đã liên kết
✓ Triển khai đã kích hoạtThiết lập triển khai liên tục
Bước 1: Liên kết Repository trong Dashboard
- Đăng nhập vào TOSE Dashboard
- Điều hướng đến Settings > Git Integration
- Nhấp Connect Repository
- Ủy quyền TOSE truy cập nhà cung cấp Git
- Chọn repository
Kết nối Git bằng API key
API key cần cả projects:write lẫn deployments:execute để Git tự động triển khai. Nếu thiếu deployments:execute, việc kết nối Git vẫn thành công nhưng không có lần triển khai đầu nào được xếp hàng và auto_deploy vẫn tắt. Bật auto_deploy, hoặc đổi nhánh của kết nối đang tự động triển khai, trả 403 insufficient_scope kèm required_scope: deployments:execute. Xem Scope và tự động triển khai.
Bước 2: Push để triển khai
bash
git add .
git commit -m "Cập nhật ứng dụng"
git push origin main
# Triển khai tự động kích hoạtBước 3: Giám sát triển khai
bash
tose logs --followLàm việc với nhánh
Triển khai nhánh khác
bash
tose up
# Nhập URL repository
# Chọn nhánh khác (vd: staging)Triển khai Feature Branch
bash
git checkout -b feature/new-feature
git push origin feature/new-feature
tose up
# Chọn nhánh: feature/new-featureNhiều môi trường
Development Environment
bash
# Triển khai từ nhánh develop
tose up
# Dự án: my-app-dev
# Nhánh: developProduction Environment
bash
# Triển khai từ nhánh main
tose up
# Dự án: my-app-prod
# Nhánh: mainBest Practices
1. Sử dụng nhánh cho môi trường
main → Production
staging → Staging
develop → Development2. Commit trước khi triển khai
bash
git status
git add .
git commit -m "Sẵn sàng triển khai"
git push
tose up3. Tag các release
bash
git tag -a v1.0.0 -m "Release 1.0.0"
git push origin v1.0.0Khắc phục sự cố
Git Repository không được phát hiện
bash
# Kiểm tra Git đã khởi tạo
git status
# Kiểm tra remote tồn tại
git remote -v
# Nếu không có remote, thêm một
git remote add origin https://github.com/username/repo.gitRepository không thể truy cập
Nếu TOSE không thể truy cập repository:
- Public Repository - Đảm bảo URL đúng
- Private Repository - Liên kết repository trong dashboard trước
- Self-Hosted - Xác minh TOSE có quyền truy cập mạng
Nhánh không tìm thấy
bash
# Fetch nhánh mới nhất
git fetch origin
# Push nhánh nếu chỉ có local
git push origin my-branch