返回

网站自动部署交给 Github Actions!手把手教你 10 分钟完成

前端

用 GitHub Actions 轻松部署个人网站

导言

在数字时代的今天,拥有自己的网站是必不可少的。然而,对于没有技术背景的人来说,网站的部署和维护可能是一项艰巨的任务。传统的方法需要手动上传代码、配置环境变量和进行繁琐的测试,耗时且容易出错。

GitHub Actions:网站部署的救星

GitHub Actions 是一款强大的自动化工具,可以帮助你简化网站部署过程。它允许你自动执行以下任务:

  • 将代码从 GitHub 仓库部署到服务器
  • 安装和配置所需的软件环境
  • 运行单元测试和集成测试
  • 部署到生产环境
  • 发送部署成功的通知

配置 GitHub Actions

创建工作流

首先,你需要在 GitHub 仓库中创建新的 Actions 工作流:

  1. 登录 GitHub 并打开你的仓库。
  2. 点击仓库页面右上角的 “Actions” 按钮。
  3. 选择 “New workflow” 创建新的工作流文件。

配置工作流

工作流文件中需要填写一些基本信息,包括名称、触发条件和模板:

  • 触发条件: 选择触发工作流的事件,例如代码提交或合并请求。
  • 模板: 从 GitHub 提供的众多模板中选择与你的项目相关的模板,然后根据需要编辑代码。

步骤详解

步骤 1:创建 GitHub Actions 工作流

name: Deploy Personal Website

on:
  push:
    branches:
      - main
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '16'
      - run: npm install
      - run: npm run build
      - uses: actions/deploy-pages@v1
        with:
          source: ./build
          destination: ./deploy
          github_token: ${{ secrets.GITHUB_TOKEN }}

步骤 2:配置工作流

触发条件:push 事件,当 main 分支有新的提交时触发。

工作流任务:

  • actions/checkout@v3:签出代码。
  • actions/setup-node@v3:设置 Node.js 环境。
  • npm install:安装依赖项。
  • npm run build:构建网站。
  • actions/deploy-pages@v1:部署网站到 GitHub Pages。

步骤 3:测试工作流

在 GitHub 仓库中,找到你的工作流文件并点击 “Run workflow” 按钮测试工作流。

步骤 4:部署网站

测试通过后,点击 “Deploy to production” 按钮部署网站。

步骤 5:查看部署结果

部署完成后,点击 “View logs” 按钮查看详细日志。

常见问题解答

1. 我如何自定义部署路径?

编辑 actions/deploy-pages@v1 操作中的 destination 参数以指定自定义部署路径。

2. 如何使用自定义域名?

在 GitHub 仓库的 “Settings” 页面中,配置自定义域名并更新 actions/deploy-pages@v1 操作中的 custom_domain 参数。

3. 我可以部署多个网站吗?

是的,创建多个工作流,每个工作流部署不同的网站。

4. 如何禁用工作流?

在工作流文件中,将 on 部分注释掉即可禁用工作流。

5. 如何获取 GitHub 身份验证令牌?

在 GitHub 仓库的 “Settings” 页面中,转到 “Secrets” 选项卡并创建新的令牌,然后将它添加到工作流文件的 GITHUB_TOKEN 环境变量中。

结语

利用 GitHub Actions,你可以轻松实现网站的自动部署,节省时间和精力。通过遵循这些步骤并使用代码示例,你可以在几分钟内部署自己的个人网站,而无需任何技术知识。