Git tag - Đánh dấu commit - Để truy vết lịch sử không còn vất vả

Bài đăng này đã không được cập nhật trong 3 năm

Giới thiệu

Tag là chức năng đặt tên hay đánh dấu cho 1 commit bất kỳ, nhằm giúp chúng ta dễ dàng tìm kiếm đến commit đó. Nó giúp chúng ta dễ dàng tìm kiếm một commit được đánh dấu trong hàng loạt các commit. Ngoài ra, nó còn giúp chúng ta dễ dàng đối chiếu, so sánh về sau này mà không cần nhớ checksum của mỗi commit, mà chỉ cần nhớ tag, cũng như có thể tạo thêm Branch từ tag giúp chúng ta thuận tiện hơn trong việc phân nhánh. Có một chú ý là một khi tạo hay gắn tag cho 1 commit cụ thể thì ta không thể thay đổi lịch sử của commit đó được nữa.

Phân loại tagging

Trên Git, có thể sử dụng 2 loại tag là lightwiegh tag và annotated tag

Lightweigh tag
- Temporary tag là cái không thể thay đổi
- Có thể đặt tên
Lightweight tag thực chất chỉ là đánh dấu (bookmark) cho một commit, vì chúng chỉ lưu trữ hàm băm (hash) của commit mà chúng tham chiếu. Chúng được tạo chỉ gồm tên mà không có các tùy chọn -a, -s hoặc -m và không chứa bất kỳ thông tin bổ sung nào. Vì vậy, nó thường đượcdùng chủ yếu tại không gian local làm việc tạm thời Để tạo ra 1 Lightweigh tag tên là "v.1.0-l" cho Head commit hiện tại, chúng ta chỉ cần lệnh
```
git tag v.1.0-l
# show 
    git tag
```
Sau khi gắn tag cho commit xong, bây giờ chúng ta có thể dễ dàng hiển thị lại lịch sử thông tin tag với lệnh git log --decorate
Annotated tag
- Có thể đính kèm tên và email của người thực hiện và ngày
- Có thể đặt tên
- Có thể đính kèm bình luận
- Có thể đính kèm chữ ký
Ngược lại, Annotated tag ngoài việc tạo tên, nó còn cho phép chúng ta lưu trữ thêm các thông tin như owner, message, date ... Vì vậy, nó được dùng để đánh dấu các commit release và đồng thời thêm các chú thích bên cạnh các đánh dấu đó. Để tạo 1 annotated tag có tên v2.0-a với tin nhắn là "Release version v2.0"
```
git tag -a v2.0-a -m "Release version v2.0"
```
Với tham số -a để đánh dấu rằng đây là annotated tag, hay nói rằng nó sẽ chưa thông tin về người tạo tag. Với tham số -m chính là việc chúng ta sẽ thêm tin nhắn cho tag đó

Xem lại lịch sử tag vừa tạo với git log --decorate

Một số lệnh làm việc với tag

xem các tag và message đi kèm với git tag -n
Xem chi tiết tag chỉ định với git show name_tag Với lệnh này, giúp chúng ta xem được thông tin tác giá, ngày tạo message, nội dung commit (các thay đổi của file code)
Liệt kê các commit cùng với hash code của nó thì dùng lệnh git log --pretty=oneline

Việc show hash code commit nhằm mục đích là đôi khi mình muốn tạo tag cho một commit trong lịch sử commits, chứ không phải là commit cuối thì chúng ta sẽ dùng lệnh git tag -a name_tag hash_code -m "message"

Giả sử, với image trên, chúng ta tạo tag cho commit ae383efaac53a962ddee5814b1ae20a3bd2585f7 (master) init
Quay về 1 phiên bản với tag

Bình thường quan về một phiên bản nào đó bằng cách chỉ ra mã hash của phiên bản cũ, nhưng nếu có tag thì dùng tag sẽ gợi nhớ và có vẻ dễ dàng hơn
```
git checkout tagname
```
Vì lệnh git checkout nó làm cho con trỏ HEAD bị tách ra, nên nếu muốn các commit sau thời điểm checkout được giữ lại thì có thể tạo luôn nhánh branch mới bắt đầu từ tag này
```
git checkout -b newbranchname tagname
```
Đưa tag lên Remote

Mặc định lệnh git push để cập nhật một dữ liệu code lên Remote, nó không có push các tag. Nếu muốn cập nhật lên Remote phải chỉ ra bằng một lệnh git push cụ thể, cứ suy nghĩ mỗi tag giống như branch
```
git push origin tagname
```
Cập nhật tất cả các tag
```
git push origin --tags
```
Xóa 1 tag

Để xóa một tag thì cần thực hiện xóa cả ở Local và ở Remote (nếu đã push tag)
```
git push --delete origin tagname
git tag -d tagname
```