Trigger.dev项目与自动化部署工作流深度解析

左松钦Travis

于 2025-06-03 09:11:35 发布

阅读量260

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01048/article/details/148394010

Trigger.dev项目与自动化部署工作流深度解析

trigger.dev ✨ Trigger.dev is the open source background jobs framework for TypeScript. With features like API integrations, webhooks, scheduling and delays. 项目地址: https://gitcode.com/gh_mirrors/tr/trigger.dev

引言

在现代软件开发中，自动化部署已成为提高开发效率的关键环节。Trigger.dev作为一个强大的任务自动化平台，提供了与主流CI/CD工具无缝集成的能力。本文将深入探讨如何利用自动化工作流实现Trigger.dev任务的自动化部署。

基础部署配置

生产环境部署

对于生产环境部署，我们可以配置一个自动化工作流，当代码推送到主分支时自动触发部署：

name: 部署到Trigger.dev(生产环境)

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 使用Node.js 20.x
        uses: actions/setup-node@v4
        with:
          node-version: "20.x"
      - name: 安装依赖
        run: npm install
      - name: 🚀 部署Trigger.dev
        env:
          TRIGGER_ACCESS_TOKEN: ${{ secrets.TRIGGER_ACCESS_TOKEN }}
        run: |
          npx trigger.dev@latest deploy

这个配置会在每次代码推送到main分支时，自动执行Trigger.dev的部署命令。

测试环境部署

测试环境部署通常需要更灵活的控制，我们可以配置手动触发的部署流程：

name: 部署到Trigger.dev(测试环境)

on:
  workflow_dispatch:

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 使用Node.js 20.x
        uses: actions/setup-node@v4
        with:
          node-version: "20.x"
      - name: 安装依赖
        run: npm install
      - name: 🚀 部署Trigger.dev
        env:
          TRIGGER_ACCESS_TOKEN: ${{ secrets.TRIGGER_ACCESS_TOKEN }}
        run: |
          npx trigger.dev@latest deploy --env staging

通过workflow_dispatch触发器，开发者可以手动选择何时将代码部署到测试环境。

访问令牌配置

安全是自动化部署中的重要考虑因素。Trigger.dev使用访问令牌进行身份验证，配置步骤如下：

在Trigger.dev账户中创建个人访问令牌
在代码仓库的"Secrets"设置中添加TRIGGER_ACCESS_TOKEN
将令牌值安全地存储在仓库机密中

版本管理最佳实践

Trigger.dev CLI与相关npm包的版本必须保持一致，否则可能导致不可预期的行为。以下是几种管理版本的方法：

通过package.json管理

{
  "scripts": {
    "deploy:trigger-prod": "npx trigger.dev@3.0.0 deploy",
    "deploy:trigger-staging": "npx trigger.dev@3.0.0 deploy --env staging"
  }
}

然后在工作流中引用这些脚本：

- name: 🚀 部署Trigger.dev
  env:
    TRIGGER_ACCESS_TOKEN: ${{ secrets.TRIGGER_ACCESS_TOKEN }}
  run: |
    npm run deploy:trigger-prod

这种方法确保了本地开发和CI环境中使用相同的版本。

自托管部署方案

对于需要自托管Trigger.dev实例的场景，部署流程需要额外配置：

设置TRIGGER_API_URL环境变量指向自托管实例
配置Docker构建和推送能力
添加容器注册表凭据

自托管部署示例：

name: 部署到自托管Trigger.dev

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 使用Node.js 20.x
        uses: actions/setup-node@v4
        with:
          node-version: "20.x"
      - name: 安装依赖
        run: npm install
      - name: 设置Docker Buildx
        uses: docker/setup-buildx-action@v3
      - name: 登录到DockerHub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}
      - name: 🚀 部署Trigger.dev
        env:
          TRIGGER_ACCESS_TOKEN: ${{ secrets.TRIGGER_ACCESS_TOKEN }}
          TRIGGER_API_URL: ${{ secrets.TRIGGER_API_URL }}
        run: |
          npx trigger.dev@latest deploy --self-hosted --push