Giới Thiệu

Mỗi tháng, mình rất thích đọc các bản phát hành của GitLab. Trong bản phát hành gần đây nhất (18.4), một công cụ mới đang được phát triển xuất hiện trong hệ sinh thái GitLab: GitLab Knowledge Graph (GKG). Công cụ này cung cấp cho bạn một biểu đồ đồ họa đại diện cho mã của bạn.

🚀 Hãy cùng khám phá công cụ thú vị và đầy hứa hẹn này nhé!

Cài Đặt GKG

Bước 1: Cài Đặt

Để bắt đầu, bạn cần cài đặt GKG. Trong trường hợp của mình, với một chiếc MacBook Pro, quá trình này rất nhanh chóng:

curl -fsSL https://gitlab.com/gitlab-org/rust/knowledge-graph/-/raw/main/install.sh | bash

Tiếp theo, mình đã thêm một alias vào file .zshrc của mình để có thể sử dụng với lệnh gkg.

📚 Tìm hiểu thêm tại: Hướng dẫn bắt đầu nhanh

Dự án thử nghiệm của mình là communities-api.

Bước 2: Chạy Lệnh Index

Lệnh gkg index sẽ quét dự án của bạn. Hành động này diễn ra nhanh chóng với dự án này.

Bước 3: Khởi Động Server

Cuối cùng, chạy server với lệnh gkg server start, và bạn có thể truy cập tại http://127.0.0.1:27495.

Lưu ý, bạn có thể chỉ mục hoặc tái chỉ mục một dự án trực tiếp trong giao diện GKG.

Lưu ý: Mình chưa thử tích hợp với IDEA.

GKG Trong Thực Tế

GKG hiển thị đồ họa trong một giao diện đơn giản:

Trên đồ thị được tạo ra, chúng ta có thể thấy các loại phần tử khác nhau như tất cả các thư mục và tệp.

Các phụ thuộc cũng được hiển thị. Trong dự án Java này, chúng ta có thể thấy các lớp Java được nhập vào trong mỗi lớp:

Loại cuối cùng là “định nghĩa”, và chúng ta có thể thấy các lớp Java, phương thức Java, và các hằng số JavaScript xuất hiện dưới dạng định nghĩa.

Tính năng cuối cùng là khả năng tìm kiếm các mục trong đồ thị.

Phản Hồi

Công cụ mới của GitLab này vẫn đang trong giai đoạn phát triển nhưng phiên bản đầu tiên rất thú vị. Loại công cụ này giải quyết một vấn đề phổ biến trong nhiều nhóm/công ty, và mình chắc chắn rằng nó sẽ được nhiều nhóm áp dụng để hiểu rõ hơn về các dự án và có cái nhìn nhanh chóng về các phụ thuộc trong các dự án phức tạp.

👀 Xem bài viết về bản phát hành này: GitLab 18.4 Released

👀 Xem dự án GitLab: GitLab Knowledge Graph Issues

📝 Gửi phản hồi của bạn về vấn đề này: Feedback Issue

Thực Hành Tốt Nhất

• Luôn cập nhật GKG: Đảm bảo bạn đang sử dụng phiên bản mới nhất để tận dụng các tính năng và sửa lỗi.
• Khám phá các tùy chọn: Tìm hiểu cách tối ưu hóa cấu hình GKG cho dự án của bạn.
• Chia sẻ với nhóm: Khuyến khích các thành viên trong nhóm sử dụng GKG để tất cả đều hiểu rõ hơn về mã nguồn.

Những Cạm Bẫy Thường Gặp

• Kết nối mạng: Đảm bảo kết nối internet ổn định khi cài đặt và sử dụng GKG.
• Cấu hình không chính xác: Kiểm tra cấu hình để đảm bảo không có lỗi trong quá trình cài đặt.

Mẹo Tối Ưu Hiệu Suất

• Tối ưu hóa dự án: Xem xét tổ chức mã nguồn và loại bỏ các phần không cần thiết để cải thiện tốc độ quét.
• Sử dụng lệnh chỉ mục thông minh: Chỉ quét các phần của mã mà bạn thực sự cần phân tích.

Khắc Phục Sự Cố

• Không thể khởi động server: Kiểm tra xem cổng đã được sử dụng chưa hoặc thử khởi động lại máy tính.
• Không thấy các phần tử: Đảm bảo rằng dự án đã được chỉ mục thành công trước khi kiểm tra đồ thị.

Câu Hỏi Thường Gặp (FAQ)

1. GKG có miễn phí không?
   Có, GKG là một công cụ miễn phí trong hệ sinh thái GitLab.

2. Có cần cài đặt thêm phần mềm nào không?
   Không, bạn chỉ cần cài đặt GKG và GitLab.

3. Có thể tích hợp GKG với các IDE khác không?
   Hiện tại, GKG chủ yếu được tích hợp với GitLab, nhưng có thể sẽ có tích hợp với các IDE khác trong tương lai.

Kết Luận

GitLab Knowledge Graph là một công cụ mạnh mẽ giúp các lập trình viên dễ dàng hình dung cấu trúc mã nguồn và các phụ thuộc. Hãy thử nghiệm ngay hôm nay và chia sẻ trải nghiệm của bạn với cộng đồng!