Kết nối GitHub hoặc GitLab
Phillip, Bandum và lượt kiểm thử tay đều làm việc với issue và PR dưới tên bạn, nên cần quyền vào tài khoản GitHub hoặc GitLab của bạn. Trang này đi qua ba việc: đăng nhập Tara, cho Phillip kết nối với repo, và tự tạo token khi không dùng được cách bấm Authorize. Làm hết mất khoảng 5 phút. Việc vào một tổ chức PhillipCLI là bước riêng, nằm ở Tạo hoặc vào một tổ chức.
Đăng nhập Tara
Ai có tài khoản GitHub cũng đăng nhập được Tara. Tara không kiểm tra bạn thuộc tổ chức GitHub nào, và tổ chức PhillipCLI của bạn tách biệt với tổ chức GitHub. Mở Tara, bấm Continue with GitHub, rồi bấm Authorize. Sau đó bạn tạo hoặc vào một tổ chức PhillipCLI.
Hiện còn hai nguồn đăng nhập khác. Nếu tổ chức của bạn dùng GitLab hoặc OpenID Connect, Owner hoặc Admin cài được SSO riêng của tổ chức ngay trên Portal (SSO của tổ chức), và nút đăng nhập tương ứng hiện trên trang đăng nhập Tara. Lần đầu, GitLab hỏi bạn có cho Tara đọc hồ sơ không, bạn bấm Authorize Tara.
Đăng nhập cách khác, và kết nối GitHub của công ty
Bạn cũng đăng nhập được bằng Google hoặc link email, và tự vào tổ chức bằng email công việc đã xác minh. Xem Các cách đăng nhập. Owner hoặc Admin cài được GitHub App của PhillipCLI lên tổ chức GitHub của công ty, để thành viên tự vào và Bandum, Ryoma đọc issue, PR mà không cần token cá nhân: Kết nối GitHub (GitHub App).
Kết nối GitLab của công ty
Owner hoặc Admin nối được một group GitLab (gitlab.com hoặc tự dựng) bằng OAuth hoặc Group Access Token. Thành viên sau đó tự vào tổ chức, và Bandum, Ryoma đọc issue, merge request mà không cần token cá nhân: Kết nối GitLab.
Cho Phillip kết nối
Trong thư mục repo dự án, bạn chạy:
ph connectPhillip nhận máy chủ từ origin của repo, rồi tìm cách kết nối theo thứ tự sau.
- Token có sẵn trên máy, từ
gh,glabhay git credential. Phillip luôn hỏi trước khi dùng. - Nếu người vận hành đã đăng ký ứng dụng cho Phillip, trình duyệt mở màn hình Authorize. Bạn bấm đồng ý là xong.
- Với GitHub, nếu máy không mở được trình duyệt (ví dụ máy chủ từ xa), Phillip in một mã 8 ký tự. Bạn mở
github.com/login/devicetrên máy khác, nhập mã rồi bấm Continue. - Không có cách nào ở trên thì Phillip hỏi bạn dán token. Cách tạo token ở mục dưới.
Phillip cất token trong kho bí mật của máy, không ghi vào repo. Kiểm tra bằng ph kit check kit-scm-github --live hoặc ph kit check kit-scm-gitlab --live.
Tự tạo token
Bạn chỉ cần tạo token khi Phillip hỏi dán, hoặc khi kiểm thử tay trên web Bandum hiện hộp Connect (kết nối). Token phải là của chính bạn, vì commit, bình luận và lượt duyệt đứng tên bạn.
| Nền tảng | Loại token | Quyền cần |
|---|---|---|
| GitHub | Fine-grained (nên dùng) | Contents, Issues, Pull requests đều Read and write, chỉ trên repo dự án |
| GitHub | Classic | Scope repo |
| GitLab | Personal access token | Scope api, và bạn là Developer trở lên trong project |
GitHub: fine-grained token
- Vào ảnh đại diện › Settings › Developer settings › Personal access tokens › Fine-grained tokens › Generate new token.
- Đặt Token name dễ nhận ra, ví dụ
phillip-laptop, và chọn Expiration. - Ở Resource owner, chọn tổ chức GitHub sở hữu repo, không chọn tài khoản cá nhân. Ở Repository access, chọn Only select repositories rồi chọn repo dự án.
- Ở Permissions, bấm Add permissions, thêm Contents, Issues, Pull requests, rồi đổi cả ba sang Read and write.
- Bấm Generate token và chép token ngay, vì GitHub chỉ hiện một lần.
Nếu tổ chức bật duyệt token, token ở trạng thái chờ cho tới khi owner duyệt. Trong lúc chờ, Phillip báo token không có quyền vào repo.
GitHub: classic token
Nếu tổ chức chưa cho dùng fine-grained token, bạn vào Personal access tokens › Tokens (classic) › Generate new token (classic). Đặt Note, chọn Expiration, tích scope repo rồi bấm Generate token. Classic token có quyền trên mọi repo bạn vào được, nên đặt hạn ngắn.
GitLab: personal access token
- Vào ảnh đại diện › Edit profile › Personal access tokens › Add new token.
- Đặt Token name, ví dụ
phillip-laptop, và chọn Expiration date. - Ở Select scopes, chỉ tích
api. - Bấm Generate token và chép token ngay.
Có token rồi, bạn chạy lại ph connect và dán khi được hỏi, hoặc chạy ph connect --method paste để đi thẳng tới bước dán.
Đã có sẵn repo?
Nếu repo và issue của công ty đã nằm trên GitHub hoặc GitLab, bạn không phải làm lại từ đầu, và Tara không ghi gì vào repo của bạn. Owner hoặc Admin làm một lần, sau khi kết nối GitHub (GitHub App) hay một group GitLab:
- Nhập repo. Ở trang Projects, hoặc ở bước 2 của hướng dẫn thiết lập, bấm Import repositories. Tara liệt kê các repo đã kết nối mà chưa thuộc dự án nào. Bạn tick những repo cần nhập, mỗi repo thành một dự án riêng (sửa được khóa dự án), hoặc chọn gộp các repo đã tick vào một dự án. Trên terminal:
ph project import --all, hayph project import --repo owner/repo. - Ánh xạ label. Mở Settings › Labels. Trang này liệt kê những label repo của bạn đang dùng, như
bug,enhancement,in progress, kèm gợi ý mỗi label mang nghĩa gì (trạng thái, loại việc hay cỡ việc). Bạn sửa chỗ gợi ý chưa đúng rồi bấm Save and confirm. Phillip, Bandum và Ryoma áp phép ánh xạ lúc đọc issue, nên số liệu có ngay mà không phải gắn lại label nào. Issue đã có labelstatus:,type:haylevel:thì giữ nguyên label đó. Trên terminal:ph org labels suggest, rồiph org labels set --file map.json --confirm. Repo chưa có label nào thì bước này cho bạn tạo bộ label chuẩn. - Mời nhóm. Khi đã kết nối GitHub, lệnh
ph org github auto-join member(hoặc tùy chọn trên Portal) cho thành viên tổ chức GitHub tự vào khi đăng nhập bằng GitHub, và không bao giờ cấp quyền Admin hay Owner. Xem Kết nối GitHub (GitHub App).
Ryoma tính giai đoạn trước khi dùng AI từ ngày sớm hơn giữa telemetry đầu tiên và ngày tạo dự án, nên repo vừa nhập đã có số "trước" ngay.
Khi gặp lỗi
| Thông báo | Cách xử lý |
|---|---|
| Đăng nhập xong, Tara hiện Get started thay vì tổ chức của bạn | Bạn chưa thuộc tổ chức PhillipCLI nào. Hãy tạo tổ chức, hoặc nhờ Owner, Admin gửi lời mời. Xem Tạo hoặc vào một tổ chức |
Tara báo cần chọn tổ chức (org_required) | Bạn thuộc nhiều tổ chức. Chọn một tổ chức ở bộ chuyển, hoặc chạy ph login --org <slug> |
| Phillip báo token không có quyền vào repo | Token thiếu repo dự án hoặc thiếu quyền ghi. Với GitHub fine-grained, xem token có đang chờ owner duyệt không |
| Phillip hỏi dán token dù đã có app OAuth | Máy chủ trong origin chưa được người vận hành khai báo. Báo Owner hoặc Admin, hoặc dán token để làm tiếp |
Bạn tự cài Tara? Xem trang developer.