Làm thế nào để sử dụng GitHub CLI? [Beginner’s Tutorial]

Không quan trọng cho dù bạn là người mới bắt đầu hay chuyên gia phát triển phần mềm, tất cả các nhà phát triển đều cần hiểu và học cách sử dụng nền tảng phát triển phần mềm hàng đầu thế giới, GitHub. Cho đến khi GitHub CLI Beta được phát hành, GitHub chỉ có thể được truy cập thông qua trình duyệt hoặc ứng dụng.

Nhưng bây giờ, bạn không cần sử dụng trình duyệt để kiểm tra các thay đổi nhỏ được thực hiện trong kho lưu trữ. Sử dụng công cụ dòng lệnh GitHub, gh, bạn có thể tương tác trực tiếp với GUI GitHub từ thiết bị đầu cuối cục bộ của bạn.

GitHub CLI là gì?

Hầu như tất cả các nhà phát triển sử dụng Git để hợp tác dự án và GitHub cho lưu trữ mã. Nhưng không có công cụ dòng lệnh để thực hiện các chức năng GitHub từ một thiết bị đầu cuối.

Bạn có thể lập luận rằng đã có một công cụ CLI Hub cho cùng. Nhưng hãy để tôi làm rõ điều đó Hub là trình bao bọc mang đến các tính năng Git bổ sung để tạo điều kiện cho trải nghiệm GitHub tốt hơn. Trong khi đó GitHub CLI là một công cụ độc lập có cách tiếp cận khác với Hub và cho phép bạn thực thi các sự kiện ứng dụng web GitHub.

Trước khi chúng tôi bắt đầu bài hướng dẫn, trước tiên, hãy cài đặt GitHub CLI.

Làm thế nào để cài đặt GitHub CLI?

Tại thời điểm viết bài viết này, GitHub CLI có sẵn trong phiên bản beta v5.5.0 cho macOS, Windowsvà Linux.

Để cài đặt GitHub CLI, bạn có thể chạy lệnh:

trên macOS

brew install github/gh/gh

trên Windows

scoop bucket add github-gh https://github.com/cli/scoop-gh.git scoop install gh or choco install gh

trên Linux

Bạn có thể tải xuống các tệp nhị phân dựng sẵn từ đây.

Tạo và xem các vấn đề bằng GitHub CLI

Để báo cáo lỗi hoặc cải tiến trong dự án, bạn tạo một vấn đề và theo dõi trạng thái.

gh cung cấp các lệnh để xem tất cả thông tin liên quan đến vấn đề. Bạn có thể kiểm tra tất cả các lệnh có sẵn để thao tác với các vấn đề.

$ gh issue

Các lệnh liên quan đến các vấn đề

Nếu bạn muốn tạo ra một vấn đề, trước tiên bạn cần vào thư mục dự án của bạn và chạy lệnh:

$ gh issue create

Nó sẽ nhắc cho các đầu vào về tiêu đề và nội dung của vấn đề.

Tạo một vấn đề

Sau khi nhập dữ liệu, bạn có thể chọn một tùy chọn để gửi vấn đề từ thiết bị đầu cuối hoặc trình duyệt.

Một sự cố trong trình duyệt được mở từ thiết bị đầu cuối

Hơn nữa, bạn cũng có thể tạo ra một vấn đề bằng cách nhập tiêu đề và nội dung bằng cờ.

Tạo một vấn đề bằng cách sử dụng cờ

Sau đó, bạn có thể liệt kê tất cả các vấn đề và xem trạng thái của chúng bằng lệnh:

$ gh issue list

Bạn cũng có thể lọc danh sách các vấn đề chuyển qua các cờ như người được chuyển nhượng, nhãn, trạng thái và một số vấn đề làm đối số để mở một vấn đề cụ thể.

$ gh issue list (flags)

Liệt kê các vấn đề bằng cách sử dụng thẻ bộ lọc

Tại đây, danh sách các cờ bạn có thể sử dụng để lọc các vấn đề:

-a, --assignee string   Filter by assignee -B, --base string       Filter by base branch -l, --label strings     Filter by label -L, --limit int         Maximum number of items to fetch (default 30) -s, --state string      Filter by state: {open|closed|merged|all} (default "open")

Bây giờ, khi chúng tôi đã tạo và xem tất cả các vấn đề, cũng cần phải giải quyết các vấn đề này. Do đó, nếu ai đó khắc phục hoặc cập nhật sự cố, chúng tôi có thể kiểm tra các thay đổi được thực hiện đối với bất kỳ sự cố nào bằng các cờ khác nhau như URL hoặc số.

$ gh issue status

Xem trạng thái sự cố

Tại đây, bạn có thể xem thông tin tối thiểu về các vấn đề. Nhưng nếu bạn muốn biết thêm thông tin để đọc và cũng thêm một sửa đổi, bạn có thể mở vấn đề trong trình duyệt trực tiếp từ thiết bị đầu cuối bằng lệnh:

$ gh issue view (issue-number or url)

Bạn cũng có thể sử dụng cờ xem trước trong các ứng dụng trong trò chơi điện tử địa phương.

Xem trước nội dung vấn đề

Tạo, xem và thanh toán các yêu cầu kéo bằng GitHub CLI

Một chức năng GUI khác của GitHub mà bạn có thể thao tác bằng cách sử dụng gh Công cụ CLI là yêu cầu Kéo.

Bạn có thể đóng góp cho kho lưu trữ khác hoặc làm việc trên một phiên bản mới bằng cách tạo một nhánh mới và kéo yêu cầu để hợp nhất các thay đổi mới vào nhánh chính.

Để thực hiện hành động này, bây giờ bạn có thể sử dụng gh pr lệnh với một bộ lọc trực tiếp từ thiết bị đầu cuối địa phương của bạn.

Đối với bản demo, tôi đã tạo một nhánh mới uivà chuyển sang một nhánh mới để tạo một yêu cầu kéo cho ui vào bậc thầy chi nhánh.

Để tạo và chuyển sang một nhánh mới, bạn có thể sử dụng lệnh:

$ gh pr checkout (branch-name)

Thanh toán cho chi nhánh PR

Bây giờ bạn có thể thực hiện một số thay đổi cho chi nhánh mới. Sau khi sửa đổi tệp, tạo yêu cầu kéo bằng cách sử dụng gh pr lệnh để hợp nhất vào bậc thầy chi nhánh:

$ gh pr create

Tạo một yêu cầu kéo

Ngoài ra, nếu bạn muốn nhập tiêu đề và nội dung trong lệnh, bạn có thể sử dụng các cờ cờ -tọ cho một tiêu đề và khăn -biết cho văn bản cơ thể.

Tạo yêu cầu kéo bằng cờ

Bây giờ, khi bạn đã mở yêu cầu kéo, chủ sở hữu kho lưu trữ có thể kiểm tra danh sách các yêu cầu kéo cùng với bộ lọc bằng các cờ.

$ gh pr list (flags)

Liệt kê các yêu cầu kéo bằng cờ

Hơn nữa, nếu bạn muốn kiểm tra xem PR của bạn có được hợp nhất hoặc yêu cầu sửa đổi hay không, bạn có thể sử dụng lệnh sau để kiểm tra trạng thái của PR:

$ gh pr status (flags)

Kiểm tra trạng thái yêu cầu kéo

Tiến về phía trước, để sửa đổi hoặc hiển thị nội dung PR, bạn có thể mở PR trong trình duyệt hoặc thiết bị đầu cuối.

$ gh pr view

Xem yêu cầu kéo

Một con đường phía trước

GitHub CLI hiện đang trong giai đoạn phát triển, do đó, chúng tôi có thể mong đợi nhiều tính năng hơn sẽ được thêm vào trước khi phát hành phiên bản đầu tiên.

Ngoài các vấn đề và yêu cầu kéo, sẽ rất tuyệt nếu GitHub thêm các lệnh để kết nối với bảng dự án và các hành động GitHub.