Kết nối GitLab với Notion

Trong tài liệu trợ giúp này

GitLab giúp nhóm quản lý mã, cộng tác phát triển phần mềm và theo dõi bản phát hành. Bạn có thể đồng bộ dự án, vấn đề, yêu cầu hợp nhất, pipeline và bản phát hành GitLab vào Notion để đặt công việc phát triển cạnh kế hoạch và tài liệu của nhóm.


Chúng tôi đang thay thế các bản đồng bộ GitLab được quản lý hiện có bằng các bản đồng bộ tùy chỉnh được hỗ trợ bởi Notion Workers. Bạn có thể tùy chỉnh dữ liệu bạn đồng bộ và cách sắp xếp dữ liệu đó trong Notion. Dữ liệu đã đồng bộ hiện có của bạn vẫn nằm trong Notion; hãy làm theo hướng dẫn này để thiết lập bản thay thế. Tìm hiểu thêm về Notion Workers →

Các bản đồng bộ GitLab hiện có sẽ ngừng hoạt động vào ngày 30 tháng 10 năm 2026. Chúng sẽ tiếp tục hoạt động bình thường cho đến lúc đó, nhưng sẽ không tự động chuyển đổi. Chúng tôi khuyên bạn nên thiết lập bản đồng bộ thay thế trước ngày đó.

Workers chạy quá trình đồng bộ hóa của bạn trên cơ sở hạ tầng của Notion. Để thiết lập thay thế, hãy @-đề cập đến cơ sở dữ liệu đã đồng bộ hóa hiện tại của bạn trong cuộc trò chuyện với Notion AI và bao gồm kỹ năng đồng bộ hóa GitLab.

Hãy chuẩn bị sẵn những thứ sau:

  • Cơ sở dữ liệu đã đồng bộ hóa GitLab hiện tại của bạn trong Notion. Đảm bảo Notion AI có thể truy cập nó.

  • Danh sách đầy đủ các dự án GitLab cần bao gồm. Bạn có thể cung cấp URL dự án, ID số hoặc đường dẫn như my-team/my-project. Tìm hiểu cách xem các dự án trong GitLab →

  • Một mã thông báo truy cập cá nhân hoặc dự án của GitLab với read_api và có quyền truy cập vào mọi dự án đã chọn.

  • Quyền truy cập vào Workers và các công cụ Notion AI cần để tạo và triển khai một Worker trong không gian làm việc của bạn.

  • Trang kỹ năng này, trang mà bạn sẽ Sao chép vào tài khoản Notion của mình: GitLab Guide: Worker Sync. Kỹ năng này dành cho GitLab.com. Nếu bạn sử dụng phiên bản GitLab tự quản lý, hãy thông báo cho Notion AI trước khi thiết lập. Địa chỉ API và cấu hình thông tin đăng nhập của hướng dẫn cần được điều chỉnh và xác thực cho phiên bản của bạn.

Ghi chú: Hướng dẫn này tạo ra các cơ sở dữ liệu thay thế. Cơ sở dữ liệu hiện có của bạn vẫn khả dụng trong khi bạn kiểm tra chúng. Các liên kết trang, chế độ xem, mối quan hệ và thông tin chỉ có trong Notion của cơ sở dữ liệu đó không tự động chuyển sang.

Mở một cuộc trò chuyện với Notion AI trong không gian làm việc chứa cơ sở dữ liệu đã đồng bộ hóa hiện tại của bạn.

Sao chép lời nhắc bên dưới. Thay thế @Existing GitLab sync database bằng cách nhập @ và chọn cơ sở dữ liệu thực tế từ menu đề cập. Nếu các vấn đề (issues) và yêu cầu hợp nhất (merge requests) nằm trong các cơ sở dữ liệu được đồng bộ hóa riêng biệt, hãy đề cập đến cả hai.

Thay thế đồng bộ hóa GitLab hiện tại của tôi, @Existing GitLab sync database, bằng một Notion Worker sử dụng GitLab Guide: Worker Sync.

Kiểm tra cơ sở dữ liệu hiện có và xác nhận danh sách dự án GitLab đầy đủ với tôi. Làm theo kỹ năng để tạo các đồng bộ hóa hàng giờ, năm cơ sở dữ liệu liên quan, chế độ xem và bảng tổng quan trong trang GitLab Sync Riêng tư. Nếu một Worker thay thế đã tồn tại, hãy kiểm tra và sử dụng lại nếu phù hợp.

Giữ nguyên cơ sở dữ liệu hiện tại của tôi. Xác định các thuộc tính tùy chỉnh, giá trị chỉ có trong Notion, chế độ xem, mối quan hệ và liên kết cần xử lý riêng. Yêu cầu mã thông báo GitLab của tôi thông qua đầu vào thông tin xác thực bảo mật, không phải trong cuộc trò chuyện.

Xem trước mọi dự án và loại dữ liệu đã chọn, hoàn tất quá trình đồng bộ hóa đầu tiên và kiểm tra các bản ghi cũng như mối quan hệ dự án. Cho tôi xem các cơ sở dữ liệu thay thế, mọi điểm khác biệt và các bước để chuyển đổi trước khi thay đổi đồng bộ hóa cũ.

Chọn một đề cập cơ sở dữ liệu thực tế trong lời nhắc. Chỉ nhập tên của cơ sở dữ liệu sẽ không cung cấp cho Notion AI liên kết để kiểm tra.

Xác nhận danh sách dự án đầy đủ, bao gồm cả các dự án bị ẩn bởi bộ lọc chế độ xem Notion hiện tại của bạn. Một mã thông báo giới hạn cho một dự án sẽ không đủ cho một quá trình đồng bộ hóa cũng cần quyền truy cập vào các dự án khác.

Làm theo hướng dẫn của Notion AI để cung cấp mã thông báo GitLab của bạn thông qua đầu vào thông tin xác thực bảo mật. Nó cần read_api và quyền truy cập vào các dự án đã chọn.

Đừng dán mã thông báo vào cuộc trò chuyện, trang Notion hoặc thuộc tính cơ sở dữ liệu. Worker sử dụng thông tin xác thực được môi giới nên mã của nó không cần đọc mã thông báo thô.

Thiết lập này sử dụng thông tin xác thực Worker mới. Kết nối GitLab hiện tại của bạn không tự động cung cấp thông tin đó.

Nếu Notion AI không thể truy cập kỹ năng hoặc các công cụ Worker, hãy giải quyết quyền truy cập đó trước. Hướng dẫn được liên kết cũng chứa các hướng dẫn thiết lập cho một người trong nhóm của bạn có thể sử dụng Notion CLI.

Kỹ năng này tạo một trang GitLab Sync Riêng tư chứa năm cơ sở dữ liệu được đồng bộ và một bảng tổng quan:

Cơ sở dữ liệu

Những gì nó bao gồm

GitLab Projects

Tên dự án, đường dẫn, mô tả, trạng thái lưu trữ, khả năng hiển thị, nhánh mặc định, liên kết và ngày hoạt động.

GitLab Issues

Các vấn đề trên nhiều trạng thái, với người được phân công, nhãn, cột mốc, mức độ nghiêm trọng, ngày đến hạn và các mối quan hệ dự án.

GitLab Merge Requests

Các yêu cầu hợp nhất trên nhiều trạng thái, với trạng thái bản nháp, tác giả, người được phân công, nhánh, trạng thái hợp nhất và các mối quan hệ dự án.

GitLab Pipelines

Trạng thái đường ống, tham chiếu, nguồn, ngày tháng, liên kết và các mối quan hệ dự án.

GitLab Releases

Tên bản phát hành, thẻ, mô tả, ngày phát hành, liên kết và các mối quan hệ dự án.

GitLab Dashboard tập hợp các bản ghi này lại với nhau trong các biểu đồ và hàng đợi làm việc. Nó bao gồm các vấn đề mở, yêu cầu hợp nhất mở, đường ống thất bại, các bản phát hành gần đây và hoạt động dự án.

Năm cơ sở dữ liệu được đồng bộ hóa chứa các bản ghi. Bảng tổng quan hiển thị các chế độ xem của các bản ghi đó. Cơ sở dữ liệu vấn đề hoặc yêu cầu hợp nhất cũ của bạn có thể đã bao gồm ít loại dữ liệu hơn so với thiết lập mặc định của kỹ năng này.

Kiểm tra những khác biệt này trước khi chuyển đổi:

  • People and labels: Tác giả, người được phân công và nhãn được lưu trữ dưới dạng văn bản trong hướng dẫn này. Chúng không phải là thuộc tính người hoặc đa lựa chọn của Notion.

  • Quan hệ dự án: Các vấn đề, yêu cầu hợp nhất, đường ống và bản phát hành cần liên kết với các bản ghi dự án đã chọn của chúng.

  • Danh tính bản ghi: Các bản ghi từ các dự án khác nhau phải duy trì sự khác biệt ngay cả khi chúng sử dụng cùng một số vấn đề hoặc yêu cầu hợp nhất cục bộ của dự án.

  • Nội dung bổ sung: Hướng dẫn này không đồng bộ các bình luận vấn đề, thảo luận yêu cầu hợp nhất, tệp kho lưu trữ hoặc nhật ký công việc. Hãy nhờ Notion AI đánh giá bất kỳ trường bổ sung nào mà quy trình làm việc hiện tại của bạn cần.

Đợi cho đến khi Notion AI xác nhận rằng tất cả năm lần đồng bộ đều ổn định và quá trình nhập ban đầu đã hoàn tất.

  1. So sánh từng dự án đã chọn với GitLab. Kiểm tra một mẫu các vấn đề mở và đóng, các yêu cầu đã hợp nhất, đường ống và bản phát hành.

  2. Xác nhận rằng các quan hệ dự án và chế độ xem bảng tổng quan hiển thị các bản ghi như mong đợi.

  3. Kiểm tra xem một thay đổi gần đây trên GitLab có đến được bản thay thế sau khi làm mới thành công hay không.

  4. Xem lại các thuộc tính tùy chỉnh của cơ sở dữ liệu cũ và các giá trị chỉ có trong Notion với Notion AI. Chuyển những gì bạn cần bằng cách sử dụng ID bản ghi GitLab ổn định.

  5. Cập nhật các liên kết, chế độ xem cơ sở dữ liệu được liên kết, quan hệ và tự động hóa cần sử dụng bản thay thế. Xem lại quyền chia sẻ của trang mới.

  6. Khi nhóm của bạn đã sử dụng bản thay thế, hãy nhờ Notion AI giúp ngừng sử dụng bản đồng bộ cũ trong khi vẫn giữ cơ sở dữ liệu cũ để tham khảo.

Bạn không cần xóa cơ sở dữ liệu cũ để sử dụng Worker. Hãy giữ nó cho đến khi bạn đã kiểm tra rằng thông tin và quy trình làm việc của nhóm bạn đã được tính đến.

Kỹ năng này thiết lập năm lần đồng bộ hàng giờ, một cho mỗi loại dữ liệu. Các dự án đồng bộ trước trong quá trình thiết lập để các cơ sở dữ liệu khác có thể liên kết các bản ghi của chúng với đúng dự án.

Mỗi lần làm mới thành công sẽ đọc tất cả các trang kết quả cho các dự án đã định cấu hình và cập nhật cơ sở dữ liệu Notion tương ứng. Worker vẫn tiếp tục chạy khi Notion bị đóng.

Các bản cập nhật truyền từ GitLab sang Notion. Hãy thực hiện thay đổi đối với các giá trị đã đồng bộ trong GitLab; các thay đổi trong Notion sẽ không được ghi lại.

Hàng giờ là lịch trình, không phải là sự đảm bảo rằng mọi lần làm mới đều hoàn thành trong một khoảng thời gian cố định. Lịch sử dự án lớn và giới hạn yêu cầu của GitLab có thể làm chậm quá trình hoàn thành.

Mẹo: Hãy giữ lại danh sách dự án đầy đủ. Các quá trình đồng bộ này sử dụng chế độ thay thế: các bản ghi bị thiếu sau khi làm mới hoàn tất sẽ bị xóa khỏi cơ sở dữ liệu đã đồng bộ. Việc xóa một dự án khỏi cấu hình có thể xóa các bản ghi đã đồng bộ của dự án đó, bao gồm cả thông tin chỉ có trên Notion trong các trang đó. Hãy yêu cầu Notion AI xem trước mọi dự án và loại dữ liệu đã chọn trước khi áp dụng thay đổi.

Kỹ năng này bắt đầu với một trang Đồng bộ GitLab riêng tư. Chỉ chia sẻ nó với những người cần xem các bản ghi đã nhập.

Quyền của Notion kiểm soát quyền truy cập vào dữ liệu đã đồng bộ. Thuộc tính Khả năng hiển thị của dự án GitLab hoặc thuộc tính Bảo mật của một vấn đề không thực thi quyền nguồn đó trong Notion. Xem lại dữ liệu được bao gồm bởi mã thông báo trước khi chia sẻ trang.

Một dự án bị thiếu

Xác nhận danh sách dự án hoàn chỉnh và quyền truy cập token. Cung cấp cho Notion AI URL hoặc ID số của dự án nếu đường dẫn của dự án đó đã thay đổi. Đừng chạy làm mới với danh sách rút gọn chỉ để giải quyết lỗi truy cập.

Một vấn đề hoặc yêu cầu hợp nhất bị thiếu

Yêu cầu Notion AI kiểm tra lựa chọn dự án, xem liệu nó có đang kiểm tra các vấn đề và yêu cầu hợp nhất ở mọi trạng thái hay không, và kiểm tra mọi trang kết quả. Kiểm tra cả các bộ lọc của chế độ xem Notion.

Bảng tổng quan trống

Yêu cầu Notion AI kiểm tra các cơ sở dữ liệu nguồn, kết quả đồng bộ mới nhất của chúng và các mối quan hệ dự án trước khi xây dựng lại bảng tổng quan. Bảng tổng quan có thể trống trong khi quá trình nhập ban đầu vẫn đang chạy.

Tôi thấy các cơ sở dữ liệu trùng lặp

Yêu cầu Notion AI kiểm tra Worker hiện có, URL cơ sở dữ liệu và cấu trúc trang trước khi tạo bất kỳ thứ gì khác. Kỹ năng này yêu cầu năm cơ sở dữ liệu được đồng bộ thực tế và một bảng tổng quan trong GitLab Sync. Hãy để Notion AI xác định bất kỳ bản sao nào trước khi xóa chúng.

Các bản cập nhật đã dừng

Yêu cầu Notion AI kiểm tra các lần chạy mới nhất của Worker, thời hạn token, quyền của token và quyền truy cập vào mọi dự án đã chọn. Đối với phiên bản tự quản lý, hãy kiểm tra cả máy chủ GitLab đã định cấu hình. Các giới hạn yêu cầu có thể làm chậm quá trình cập nhật.


Gửi phản hồi

Tài nguyên này có hữu ích không?


Powered by Fruition