Bỏ qua, đến phần nội dung

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.

Tara chỉ xin đọc hồ sơ, email và danh sách group của bạn.

Đă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:

bash
ph connect

Phillip nhận máy chủ từ origin của repo, rồi tìm cách kết nối theo thứ tự sau.

  1. Token có sẵn trên máy, từ gh, glab hay git credential. Phillip luôn hỏi trước khi dùng.
  2. 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.
  3. 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/device trên máy khác, nhập mã rồi bấm Continue.
  4. 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.
Nhập mã Phillip in ra trong terminal. Đừng nhập mã do người khác gử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ảngLoại tokenQuyền cần
GitHubFine-grained (nên dùng)Contents, Issues, Pull requests đều Read and write, chỉ trên repo dự án
GitHubClassicScope repo
GitLabPersonal access tokenScope api, và bạn là Developer trở lên trong project

GitHub: fine-grained token ​

  1. Vào ảnh đại diện › Settings › Developer settings › Personal access tokens › Fine-grained tokens › Generate new token.
  2. Đặt Token name dễ nhận ra, ví dụ phillip-laptop, và chọn Expiration.
  3. Ở 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.
  4. Ở Permissions, bấm Add permissions, thêm Contents, Issues, Pull requests, rồi đổi cả ba sang Read and write.
  5. Bấm Generate token và chép token ngay, vì GitHub chỉ hiện một lần.
Chọn tổ chức ở Resource owner. Nếu không thấy tổ chức, có thể bạn chưa chấp nhận lời mời.
Ba quyền Read and write. Metadata là bắt buộc và luôn ở Read-only.

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.

Classic token chỉ cần tích repo, các scope khác để trống.

GitLab: personal access token ​

  1. Vào ảnh đại diện › Edit profile › Personal access tokens › Add new token.
  2. Đặt Token name, ví dụ phillip-laptop, và chọn Expiration date.
  3. Ở Select scopes, chỉ tích api.
  4. Bấm Generate token và chép token ngay.
Chỉ tích scope api. Token hết hạn thì tạo token mới rồi chạy lại ph connect.

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:

  1. 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, hay ph project import --repo owner/repo.
  2. Á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ó label status:, type: hay level: thì giữ nguyên label đó. Trên terminal: ph org labels suggest, rồi ph 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.
  3. 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áoCách xử lý
Đăng nhập xong, Tara hiện Get started thay vì tổ chức của bạnBạ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 repoToken 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 OAuthMá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.