为Zoho Catalyst应用配置GitHub CI/CD集成，实现提交自动部署

前置准备 #

• 确认你的Zoho Catalyst项目ID（可在Catalyst控制台的项目设置页面找到）
• 若Zoho账户开启双因素认证，需先在账户安全设置中生成应用专用密码，替代日常登录密码使用

步骤1：配置GitHub仓库敏感信息 #

进入你的GitHub仓库，依次点击「Settings」→「Secrets and variables」→「Actions」，添加以下3个机密变量：

• ZOHO_CATALYST_EMAIL：你的Zoho账户登录邮箱
• ZOHO_CATALYST_PASSWORD：Zoho账户密码（或上述生成的应用专用密码）
• ZOHO_CATALYST_PROJECT_ID：你的Catalyst项目ID

步骤2：编写GitHub Actions工作流文件 #

在仓库根目录创建.github/workflows文件夹，在其中新建deploy-catalyst.yml文件，内容如下：

name: Auto Deploy to Catalyst
on:
  push:
    branches: [ main ] # 替换为你需要触发部署的分支，比如master

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取仓库代码
        uses: actions/checkout@v4

      - name: 安装Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '18' # 选择与你的Catalyst函数兼容的Node版本，如16/18

      - name: 安装Catalyst CLI工具
        run: npm install -g zcatalyst-cli

      - name: 登录Catalyst并切换到目标项目
        run: |
          catalyst login --email ${{ secrets.ZOHO_CATALYST_EMAIL }} --password ${{ secrets.ZOHO_CATALYST_PASSWORD }}
          catalyst switch --project-id ${{ secrets.ZOHO_CATALYST_PROJECT_ID }}

      - name: 部署客户端代码
        run: catalyst deploy client # 无客户端模块可删除此步骤

      - name: 部署函数模块
        run: catalyst deploy functions # 无函数模块可删除此步骤

关键注意事项 #

• 若客户端代码或函数不在默认目录，需给catalyst deploy命令添加--dir参数指定路径，例如catalyst deploy client --dir ./my-client-files
• 可调整触发条件，比如要在PR合并到主分支时触发部署，可在on字段中添加：pull_request: { branches: [ main ], types: [ closed ] }
• 可在部署步骤前增加测试环节，比如运行单元测试，确保代码无问题后再执行部署

内容的提问来源于stack exchange，提问作者Raghu