Đưa mã nguồn lên GitHub và làm việc từ xa

Sau khi đã quản lý tốt mã nguồn ở máy cá nhân (local), chúng ta cần một nơi để lưu trữ và chia sẻ code trực tuyến. GitHub là lựa chọn phổ biến nhất hiện nay để chúng ta tạo các kho lưu trữ từ xa (remote repository).

1. Tạo Repository trên GitHub

Để bắt đầu, chúng ta cần tạo một không gian lưu trữ trên GitHub.

1. Đăng nhập: Truy cập GitHub và đăng nhập vào tài khoản cá nhân.
2. Khởi tạo: Nhấn vào biểu tượng New Repository (dấu + ở góc trên bên phải).
3. Thiết lập thông tin:

• Repository name: Đặt tên là my-first-repo.
• Description: Mô tả ngắn gọn về dự án (ví dụ: “My first GitHub repo”).
• Chế độ: Chọn Public để chia sẻ công khai hoặc Private để giữ riêng tư.
• Lưu ý quan trọng: Không tích chọn mục Add a README file vì chúng ta sẽ đẩy file từ máy cá nhân lên sau.

Sau khi nhấn Create Repository, GitHub sẽ cung cấp một đường dẫn URL có dạng: https://github.com/your-username/my-first-repo.git.

2. Kết nối Repository Local với GitHub

Chúng ta cần thiết lập mối liên kết giữa thư mục làm việc trên máy và repository vừa tạo trên GitHub.

• Lệnh thực hiện:

  git remote add origin https://github.com/your-username/my-first-repo.git

Trong đó: origin là tên mặc định cho remote, bạn có thể thay your-username bằng tên tài khoản của mình.

• Kiểm tra kết nối:

  git remote -v

Nếu kết quả hiển thị đúng URL của GitHub ở cả hai dòng fetch và push, chúng ta đã kết nối thành công.

3. Đẩy mã nguồn lên GitHub (Git Push)

Bước này sẽ chuyển toàn bộ lịch sử commit từ nhánh master dưới máy lên GitHub.

• Lệnh thực hiện:

  git push -u origin master

Tham số -u giúp ghi nhớ liên kết giữa nhánh local và remote cho các lần đẩy sau.

Lưu ý về xác thực: Từ năm 2021, GitHub yêu cầu sử dụng Personal Access Token (PAT) thay cho mật khẩu thông thường khi thực hiện lệnh qua terminal. Chúng ta có thể tạo token này trong phần Settings > Developer settings trên GitHub. Sau khi đẩy thành công, chúng ta chỉ cần làm mới trang GitHub để thấy các file đã xuất hiện trực tuyến.

4. Cập nhật mã nguồn về máy (Git Pull)

Khi có thay đổi trên GitHub (ví dụ: do chúng ta sửa trực tiếp trên web hoặc đồng nghiệp đẩy code lên), chúng ta cần cập nhật những thay đổi đó về máy.

• Lệnh thực hiện:

  git pull origin master

Lệnh này sẽ tự động tải các commit mới nhất và hợp nhất vào nhánh hiện tại trên máy của chúng ta.

Kinh nghiệm thực tế để làm việc hiệu quả

• Luôn Pull trước khi làm việc: Đây là thói quen tốt giúp chúng ta tránh xung đột mã nguồn (conflict) do lệch phiên bản giữa local và remote.
• Kiểm tra URL: Sử dụng git remote -v để đảm bảo chúng ta đang làm việc đúng với repository mong muốn.
• Sử dụng SSH: Nếu làm việc thường xuyên, chúng ta nên thiết lập SSH Key để không phải nhập token xác thực liên tục.

Thử nghiệm nhỏ

Bạn hãy thử sửa nội dung file hello.txt trực tiếp trên giao diện web của GitHub, sau đó quay lại terminal và dùng lệnh git pull để thấy sự thay đổi xuất hiện ngay tại máy cá nhân.

Trong bài viết tới, chúng ta sẽ cùng xử lý một tình huống khá phổ biến khi làm việc nhóm: Giải quyết xung đột (Conflict resolution).