Hướng dẫn đẩy dự án lên GitHub: Các bước chi tiết

Reading Time: 3 minutes

GitHub là dịch vụ quản lý Git trên nền tảng đám mây. Git là hệ thống quản lý phiên bản phân tán, cho phép toàn bộ repository cùng lịch sử của nó tồn tại ở bất kỳ nơi nào được lưu trữ. Trong quy trình làm việc kinh doanh hoặc phát triển, chúng ta thường dùng GitHub như một giải pháp lưu trữ được quản lý để sao lưu repository. Bên cạnh đó, GitHub còn cung cấp khả năng kết nối và hợp tác với đồng nghiệp, bạn bè, tổ chức cũng như nhiều cộng đồng khác.

Trong bài hướng dẫn này, bạn sẽ nắm được cách đẩy dự án lên GitHub.

Cách đẩy dự án lên GitHub

1. Tạo một GitHub Repo mới
2. Khởi tạo Git trong thư mục Project
3. Đưa các thay đổi lên GitHub Repo

Điều kiện cần

Để khởi tạo repo và đẩy code lên GitHub, bạn cần có:

• Một tài khoản GitHub miễn phí
• git đã được cài đặt trên máy local

Bước 1: Tạo một GitHub Repo mới

Đăng nhập vào GitHub và tạo một repository trống. Chúng ta có thể chọn khởi tạo kèm file README hoặc bỏ qua, vì toàn bộ nội dung trên remote repository này sẽ được ghi đè sau đó.

Lưu ý: Trong suốt phần còn lại của hướng dẫn này, chúng tôi giả định username GitHub của bạn là sammy và repo bạn đã tạo tên là my-new-project. Do đó, khi áp dụng vào thực tế, bạn phải thay thế các giá trị này bằng username và tên repo thực tế của mình.

Bước 2: Khởi tạo Git và đẩy Code

Từ terminal, bạn hãy chạy các lệnh sau sau khi điều hướng đến thư mục mà bạn muốn thêm.

Bước 3: Khởi tạo Git Repo

Đảm bảo là bạn đang ở trong thư mục gốc của dự án và chạy lệnh:

Ghi chú: Nếu dự án của bạn đã là một Git repository, bạn có thể bỏ qua lệnh này.

git init

Bước này sẽ tạo một thư mục ẩn có tên .git trong thư mục dự án của bạn. Phần mềm Git sẽ nhận diện thư mục này và sử dụng nó để lưu trữ toàn bộ metadata cùng lịch sử phiên bản của dự án.

Thêm các file vào Git index

git add -A

Lệnh git add được dùng để báo cho git biết những file nào sẽ được đưa vào commit tiếp theo. Tham số -A (hoặc --all) có nghĩa là “bao gồm tất cả các file”.

Commit các file đã thêm

git commit -m 'Added my project'

Lệnh git commit tạo ra một commit mới chứa tất cả các file đã được “add”. Tham số -m (hoặc --message) dùng để đặt thông điệp đi kèm với commit, giúp bạn hiểu được nội dung của commit đó trong tương lai. Trong trường hợp này, thông điệp là: 'Added my project'.

Thêm một remote origin mới

git remote add origin git@github.com:sammy/my-new-project.git

Ghi chú: Bạn đừng quên thay thế phần username và tên repo bằng username và tên repo của mình.

Trong git, “remote” là một phiên bản khác của cùng một repository, thường được đặt trên một server ở đâu đó (trong trường hợp này là GitHub). “origin” là tên mặc định mà git đặt cho một remote server (bạn có thể có nhiều remote). Vì vậy, lệnh git remote add origin hướng dẫn git thêm URL của remote server mặc định cho repo này.

Đẩy code lên GitHub

git push -u -f origin main

• Cờ u (hoặc -set-upstream) thiết lập remote origin làm upstream reference. Điều này cho phép bạn sau này có thể thực hiện lệnh git push và git pull mà không cần chỉ định origin nữa.
• Cờ -f (viết tắt của force) cho phép bắt buộc ghi đè toàn bộ nội dung trong remote repository. Chúng ta sử dụng tùy chọn này để thay thế file README mặc định do GitHub tự động tạo.

Ghi chú: Nếu không khởi tạo file README mặc định khi tạo project trên GitHub, chúng ta sẽ không cần sử dụng cờ -f.

Tất cả các lệnh

git init
git add -A
git commit -m 'Added my project'
git remote add origin git@github.com:sammy/my-new-project.git
git push -u -f origin main

Kết luận

Bây giờ, chúng ta đã sẵn sàng theo dõi các thay đổi trong mã nguồn từ xa trên GitHub.