Hướng dẫn tạo và quản lý nhiều phiên bản source code trên GitHub

Bài viết này nhằm mục đích ghi nhớ thao tác, khá ảo nhưng nay mình mới có nhu cầu này, trước đây thì mỗi lần sửa trên máy thì tống hết lên github, mà nay làm thèng Cloudflare Auto Cache Purge and Preload mới có nhu cầu lưu tạo ra nhiều phiên bản, vì mỗi phiên bản sửa khá nhiều thứ, đôi lúc dùng theo cách cũ ở phiên bản cũ, có khi lại hiệu quả hơn, lưu lại thành nhiều phiên bản trên github, khi cần xem lại tiện hơn

Bước 1: Tạo 1 repository bất kì nếu chưa có

Bước 2: upload source code cho phiên bản đầu tiên

Thường mình dùng trình duyệt để upload, mà cái plugin này dùng thêm Action Scheduler, file nhỏ nhiều quá, phải upload thông qua app trên Windows của Github

• Phần lớn các dự án của chúng ta sẽ đang ở bước 2 như này

Bước 3: tạo phiên bản release đầu tiên

Ấn vào Create a new release

Bước 4: thêm các thông số

1. Đặt tên tùy ý, thường mình thích dùng kiểu v1.0
2. Tạo 1 tag cho phiên bản này, dùng tag v1.0 luôn cho dễ nhớ
3. Giới thiệu phiên bản, thêm vào các thay đổi so với phiên bản trước (do là bản đầu tiên nên viết bừa 1 thông báo gì cho vui)
4. Xong xuôi thì ấn vào Publish release

Lúc này đã thấy phiên bản v1.0 đã được tạo ra

Bước 5: tạo các phiên bản mới hơn

Theo thời gian phát triển, khi bạn có các phiên bản mới hơn, hãy cập nhật, upload trực tiếp các file mới vào main

Tiếp theo vào Release -> “Draft a new release”

Làm tương tự như bước 4

Bước 6: kiểm tra thành quả

Phần Release hiện tại sẽ thấy thêm nhiều phiên bản

Lúc này phiên bản v1.0 sẽ là các dữ liệu ở thời điểm tạo ra bản release v1.0, phiên bản v1.1 là các dữ liệu ở thời điểm tạo ra bản release v1.1

Thi thoảng nghịch phá gì đó trên máy mất hết cả code, có thể vào Github xem lại bản cũ :]]

Tạo link download cho phiên bản mới nhất

• Sử dụng GitHub Actions để cập nhật latest mỗi khi có bản release mới

name: Update latest branch

on:
  release:
    types: [published]
  workflow_dispatch:

permissions:
  contents: write

jobs:
  update-latest:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Configure Git
        run: |
          git config --global user.email "github-actions@github.com"
          git config --global user.name "GitHub Actions"

      - name: Fetch latest release tag
        id: get-latest-tag
        run: echo "LATEST_TAG=$(git describe --tags `git rev-list --tags --max-count=1`)" >> $GITHUB_ENV

      - name: Update latest branch
        run: |
          git checkout latest || git checkout -b latest
          git merge $LATEST_TAG
          git push origin latest

Mỗi khi có bản release mới, nó sẽ tự chép vào latest, lúc này link download phiên bản mới nhất sẽ cố định ở https://github.com/bibicadotnet/cloudflare-auto-cache-purge-and-preload/archive/latest.zip, link download plugin ở bài giới thiệu đỡ phải sửa lại nhiều lần khi có bản release mới

Kết luận

Mình tách nhỏ ra nhiều bước, thêm nhiều hình ảnh, để sau coi lại cho dễ, vì ít làm tầm vài năm là quên sạch, nên nhìn bài dài, chứ thực tế làm vài thao tác à 😛