zoukankan      html  css  js  c++  java
  • 使用Github Actions将Vue项目部署到Github Pages

    GitHub Actions 是 GitHub 的持续集成服务,是一个非常强大的功能,用它可以实现很多自动化功能。现在我们来使用Github Actions将我们做好的Vue项目部署到Github Pages上。

    本项目源码:Tuzilow/github-actions-demo

    Github Actions是什么?

    持续集成通常由很多操作组成,比如运行单元测试、登录远程服务器、打包代码等等,Github将这些操作称为actions。
    这些actions在不同项目中也是类似甚至是完全相同的,是完全可以共享的。而Github就根据这个特点创建了一个actions市场,可以发布自己的actions和使用其他人的写好的actions。

    基本概念

    • workflow:持续集成一次运行的过程,即一个工作流程
    • job:任务,一个工作流程由一个或多个任务组成
    • step:步骤,每个任务由多个步骤组成,逐步完成
    • action:动作,每个步骤可以执行一个或多个动作

    创建一个Vue项目

    使用Vue CLI创建一个Vue项目

    vue create github-actions-demo
    cd github-actions-demo
    

    在项目根目录下创建一个vue.config.js,修改publicPath为将要发布的Github Pages的子路径,比如发布后的地址https://tuzilow.github.io/github-actions-demo/,那么publicPath就要设置为/github-actions-demo/

    module.exports = {
      publicPath: '/github-actions-demo/',
    };
    

    编写workflow文件

    workflow文件采用YAML格式,后缀为.yml,在项目根目录下创建.github/workflows/目录,Github只要发现该目录中由yml文件就会自动运行该文件。
    创建ci.yml

    # 该workflow的名称,可以随意填写
    name: Build And Deploy To Github Pages
    
    # workflow的触发事件,这里代表main分支的push事件触发
    on:
      push:
        branches: [ main ]
    
    # 任务
    jobs:
      # build-and-deploy 为任务的ID
      build-and-deploy:
        # 运行所需要的环境
        runs-on: ubuntu-latest 
    
        steps:
          # 步骤名
          - name: Checkout
            # 使用的actions脚本,这里是官方提供的获取源码脚本
            uses: actions/checkout@v2.3.1
            # 这个为使用 JamesIves/github-pages-deploy-action脚本所需要的配置
            with:
              persist-credentials: false
    
          # 执行npm脚本打包项目
          - name: Install and Build
            run: |
              npm install
              npm run build
          
          # 执行JamesIves/github-pages-deploy-action将项目发布到Github Pages
          - name: Deploy
            uses: JamesIves/github-pages-deploy-action@3.7.1
            with:
              # 该workflow需要操作repo,因此需要一个密钥,下面会讲到如何获取这个密钥
              ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN }}
              # 发布到的分支
              BRANCH: gh-pages
              # 要发布的文件夹
              FOLDER: dist
    

    获取密钥并存储到Github仓库中

    创建密钥

    进入Github的Settings中https://github.com/settings/,依次点击 Developer settingsPersonal access tokens。然后点击Generate new token创建。因为要操作仓库,所以需要勾选repo权限。

    具体请参考:创建个人访问令牌

    请及时保存生成的密钥

    将密钥存储到Github仓库

    首先创建一个Github仓库,然后到仓库的Settings/Secret下,点击New repository secret将刚才保存的密钥保存,并命名为ACCESS_TOKEN(注意,如果这里的命名更改了,前面的yml文件中的${{ secrets.ACCESS_TOKEN }}也要更改)

    推送仓库

    根据Github上的提示,将准备好的本地仓库推送之后就会自动执行workflow。

    我们可以到Actions中实时查看运行日志。

    一个小问题

    workflow执行成功后我们仍然有可能访问对应网址(https://tuzilow.github.io/github-actions-demo)时显示404。

    这时候我们需要到Github仓库中的Settings/Options下,找到Github Pages,点击Choose a theme选择任意一个主题即可正常访问。

    参考文章

  • 相关阅读:
    容器之队列的使用
    容器之栈的使用
    rapidxml的使用
    C++判断文件夹是否存在并创建文件夹
    VS2017,不能将const char *转为char *
    CSS_day01_选择器
    HTML_day02_列表
    HTML_day01基本标签
    python_day3
    python_day2
  • 原文地址:https://www.cnblogs.com/xueyubao/p/13991935.html
Copyright © 2011-2022 走看看