使用 GitHub Actions 部署博客到 GitHub Pages
2021-8-15 00:0:0 Author: taxodium.ink(查看原文) 阅读量:0 收藏

  1. 在 Git 仓库下创建 .github/workflows 目录, 目录下创建一个对应的 xxxx.yaml 配置文件,每个 yaml 文件对应一个 workflows
  2. 一个 xxx.yaml 文件,内容大致如下:(这是我的博客的部署 workflows, 具体含义见注释)

    # Optional - The name of the workflow as it will appear in the Actions tab of the GitHub repository.
    # workflows 的名称
    name: deploy-to-github-page
    # Specify the event that automatically triggers the workflow file.
    # 监听什么事件时触发这个workflows, 这里监听push
    on: [push]
    # Groups together all the jobs that run in the workflow file
    # 这个workflows具体是由哪些任务组成的
    jobs:
      # define job name
      # 任务1, `deploy`是任务的名称
      deploy:
        # Configures the job to run on an Ubuntu Linux runner
        # 在什么环境下执行这个任务
        runs-on: ubuntu-latest
        # Groups together all the steps that run in the job
        # Each item nested under this section is a separate action or shell command.
        # 任务具体包含什么步骤
        steps:
          # actions The uses keyword tells the job to retrieve v2 of the community action named actions/checkout@v2
          # 每个步骤,即可以使用(`uses`)别人写好的`actions`, 也可以跑自己写的命令(`run`)
          - uses: actions/checkout@v2 # 拉取代码
            - uses: actions/setup-node@v2 # 装node.js环境
              with: # 输入这个`actions`需要的参数,例如版本号
              node-version: '14'
              # shell command, The run keyword tells the job to execute a command on the runner.
              - run: yarn install # 安装博客的依赖
                - run: yarn build # 构建博客的静态文件
                  - name: Deploy
                    uses: peaceiris/actions-gh-pages@v3 # 使用别人写好把静态文件发布到`GitHub Pages`的`actions`
                    with:
                      github_token: ${{ secrets.GITHUB_TOKEN }}
                      publish_dir: docs/.vuepress/dist
    
    

部署博客的 workflows 还是蛮简单的,阅读配置文件,可以发现 GitHub Actions 的大致流程是这样的:

  • 当某个事件发生,例如 push ,就会触发 workflows ,对应 .github/workflows 目录下定义的 yaml 配置
  • 每个 workflows 定义
    • 匹配什么事件 (on: push)
    • 定义都有那些任务 (jobs)
  • jobs 中定义任务的执行环境 (runs-on) ,每个 jobs 是由一个一个步骤 (steps) 组成的,每个 steps 可以是
    • uses 别人写好的 actions
    • run 自己定义的命令

所以,思考你想在仓库发生什么事件时,做什么任务,这个任务具体包含哪些步骤,然后编写一个配置文件,就差不多了。


文章来源: https://taxodium.ink/use-github-action-deploy-blog.html
如有侵权请联系:admin#unsafe.sh