1
# Workflow 名称，会显示在 GitHub Actions 页面
2
name: Deploy to CN Server (Nginx)
3

4
# 触发条件
5
on:
6
  # 当 main 分支有 push 时自动触发
7
  push:
8
    branches: [ main ]
9

10
  # 允许在 GitHub Actions 页面手动触发
11
  workflow_dispatch:
12

13
jobs:
14
  deploy:
15
    # 使用 GitHub 提供的 Ubuntu Runner
16
    runs-on: ubuntu-latest
17

18
    steps:
19
      # =========================
20
      # 1. 拉取仓库代码
21
      # =========================
22
      - name: Checkout code
23
        uses: actions/checkout@v4
24
        # 作用：
25
        # - 将当前仓库代码拉到 Runner 本地
26
        # - 后续 build、rsync 都基于这份代码
27

28
      # =========================
29
      # 2. 安装 pnpm
30
      # =========================
31
      - name: Setup pnpm
32
        uses: pnpm/action-setup@v4
33

34
      # =========================
35
      # 3. 安装 Node.js
36
      # =========================
37
      - name: Setup Node.js
38
        uses: actions/setup-node@v4
39
        with:
40
          node-version: 20
41
          cache: pnpm
42
        # 作用：
43
        # - 使用稳定的 Node.js 版本
44
        # - 启用 pnpm 缓存，加快后续构建速度
45

46
      # =========================
47
      # 4. 安装项目依赖
48
      # =========================
49
      - name: Install dependencies
50
        run: pnpm install --frozen-lockfile
51
        # --frozen-lockfile：
52
        # - 确保依赖版本严格与 pnpm-lock.yaml 一致
53
        # - 防止 CI 中隐式升级依赖
54

55
      # =========================
56
      # 5. 构建 Astro 项目
57
      # =========================
58
      - name: Build project
59
        run: pnpm build
60
        # 输出结果：
61
        # - 构建完成后生成 dist/ 目录
62
        # - dist/ 即最终需要部署到服务器的静态文件
63

64
      # =========================
65
      # 6. 配置 SSH 环境
66
      # =========================
67
      - name: Setup SSH
68
        run: |
69
          # 创建 SSH 目录
70
          mkdir -p ~/.ssh
71

72
          # 写入私钥（来自 GitHub Secrets）
73
          echo "${{ secrets.CN_SSH_PRIVATE_KEY }}" > ~/.ssh/id_ed25519
74
          chmod 600 ~/.ssh/id_ed25519
75

76
          # 将服务器加入 known_hosts，避免首次连接交互确认
77
          ssh-keyscan -H ${{ secrets.CN_HOST }} >> ~/.ssh/known_hosts
78
        # 作用：
79
        # - 让 Runner 可以无交互地 SSH 登录服务器
80
        # - 私钥通过 GitHub Secrets 安全注入
81

82
      # =========================
83
      # 7. 上传构建产物到服务器
84
      # =========================
85
      - name: Upload dist to server
86
        run: |
87
          # 使用时间戳作为版本号
88
          TS=$(date +%Y%m%d%H%M%S)
89
          echo "RELEASE_TS=$TS" >> $GITHUB_ENV
90

91
          # 在服务器上创建新版本目录
92
          ssh ${{ secrets.CN_USER }}@${{ secrets.CN_HOST }} \
93
            "mkdir -p /var/www/my-site/releases/$TS"
94

95
          # 使用 rsync 上传 dist/ 内容
96
          rsync -az --delete ./dist/ \
97
            ${{ secrets.CN_USER }}@${{ secrets.CN_HOST }}:/var/www/my-site/releases/$TS/
98
        # rsync 参数说明：
99
        # -a：保留文件权限、时间等
100
        # -z：压缩传输，减少网络开销
101
        # --delete：保证目标目录与 dist/ 完全一致
102

103
      # =========================
104
      # 8. 原子切换 current 软链接
105
      # =========================
106
      - name: Switch current symlink
107
        run: |
108
          ssh ${{ secrets.CN_USER }}@${{ secrets.CN_HOST }} "\
109
            # 将 current 指向最新版本（原子操作）
110
            ln -sfn /var/www/my-site/releases/${{ env.RELEASE_TS }} /var/www/my-site/current && \
111
            # 清理旧版本（保留最近 5 个）
112
            ls -1dt /var/www/my-site/releases/* | tail -n +6 | xargs -r rm -rf \
113
          "
114
        # 作用：
115
        # - ln -sfn：原子切换，不会出现“半更新”状态
116
        # - 自动清理旧版本，避免磁盘无限增长