nolebase
Search K

Appearance

GitHub Actions 快速上手 ​

创建脚本 ​

在项目根目录新建文件夹 .github/workflows 在该文件夹中创建 yaml 格式的脚本文件

设置密钥 ​

设置密钥可以隐藏服务器 IP、SSH 端口等敏感信息

Project -> Settings -> Secrets -> Actions，在其中添加环境变量即可

配置脚本 ​

脚本构成 ​

  • name：脚本的名字
  • on：脚本的触发条件
  • permissions：脚本权限
  • jobs：脚本的具体工作

name ​

yaml
name: deploy-website

on ​

yaml
on:
  push: # 推送时触发
    branches: ["master"]
  workflow_dispatch: # 手动触发

permissions ​

yaml
permissions:
  contents: write # 读写仓库内容

jobs ​

yaml
jobs:
  build:
    # 运行环境
    runs-on: ubuntu-latest

    steps:
      # 获取仓库文件
      - name: checkout
        uses: actions/checkout@v3

      # 设置 Node 版本（可选）
      - name: Setup Node
        uses: actions/setup-node@v3
        with:
          node-version: 16

      # 项目依赖安装及构建
      - name: Install and Build 🔧
        run: |
          npm install
          npm run build

      # 使用 SCP 部署至 VPS（二选一）
      - name: Deploy
        uses: appleboy/scp-action@master
        with:
          host: ${{ secrets.HOST }}
          username: ${{ secrets.USERNAME }}
          password: ${{ secrets.PASSWORD }}
          port: ${{ secrets.PORT }}
          source: .vitepress/dist # 文件路径 (./* 为全部)
          target: ${{ secrets.TARGET }} # 目标路径
          strip_components: 2 # 打包层数

      # 部署至 GitHub Pages（二选一）
      - name: Deploy 🚀
        uses: JamesIves/github-pages-deploy-action@releases/v3
        with:
          folder: .vitepress/dist
          branch: gh-pages