docs: Update README and GitHub Actions workflow for enhanced deployment options

.github/workflows/deploy.yml

@@ -5,6 +5,22 @@ on:
     tags:
       - 'v*'
   workflow_dispatch:
+    inputs:
+      run_migrations:
+        description: 'Run database migrations'
+        type: boolean
+        required: true
+        default: false
+      deploy_email_worker:
+        description: 'Deploy email Worker'
+        type: boolean
+        required: true
+        default: false
+      deploy_cleanup_worker:
+        description: 'Deploy cleanup Worker'
+        type: boolean
+        required: true
+        default: false
 
 jobs:
   deploy:
@@ -16,9 +32,10 @@ jobs:
 
       - name: Get previous tag
         id: previoustag
+        if: github.event_name == 'push'
         run: |
           echo "tag=$(git describe --tags --abbrev=0 HEAD^)" >> $GITHUB_OUTPUT
-        continue-on-error: true  # Allow failure if this is the first tag
+        continue-on-error: true
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
@@ -37,12 +54,11 @@ jobs:
       # Check if database migrations have changes
       - name: Check migrations changes
         id: check_migrations
+        if: github.event_name == 'push'
         run: |
-          # If this is the first tag, we need to run migrations
           if [ -z "${{ steps.previoustag.outputs.tag }}" ]; then
             echo "migrations_changed=true" >> $GITHUB_OUTPUT
           else
-            # Check if any files in drizzle directory have changed
             if git diff ${{ steps.previoustag.outputs.tag }}..HEAD --name-only | grep -q "^drizzle/"; then
               echo "migrations_changed=true" >> $GITHUB_OUTPUT
             else
@@ -76,7 +92,9 @@ jobs:
 
       # Run database migrations if needed
       - name: Run database migrations
-        if: steps.check_migrations.outputs.migrations_changed == 'true'
+        if: |
+          github.event_name == 'push' && steps.check_migrations.outputs.migrations_changed == 'true' ||
+          github.event_name == 'workflow_dispatch' && inputs.run_migrations == 'true'
         env:
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
@@ -85,8 +103,8 @@ jobs:
       # Check if workers have changes
       - name: Check workers changes
         id: check_changes
+        if: github.event_name == 'push'
         run: |
-          # If this is the first tag, check all files
           if [ -z "${{ steps.previoustag.outputs.tag }}" ]; then
             if git ls-files | grep -q "workers/email-receiver.ts"; then
               echo "email_worker_changed=true" >> $GITHUB_OUTPUT
@@ -99,7 +117,6 @@ jobs:
               echo "cleanup_worker_changed=false" >> $GITHUB_OUTPUT
             fi
           else
-            # Compare changes between two tags
             if git diff ${{ steps.previoustag.outputs.tag }}..HEAD --name-only | grep -q "workers/email-receiver.ts"; then
               echo "email_worker_changed=true" >> $GITHUB_OUTPUT
             else
@@ -120,17 +137,21 @@ jobs:
           NEXT_PUBLIC_EMAIL_DOMAIN: ${{ secrets.NEXT_PUBLIC_EMAIL_DOMAIN }}
         run: pnpm run deploy:pages
 
-      # Deploy email worker if changed
+      # Deploy email worker if changed or manually triggered
       - name: Deploy Email Worker
-        if: steps.check_changes.outputs.email_worker_changed == 'true'
+        if: |
+          github.event_name == 'push' && steps.check_changes.outputs.email_worker_changed == 'true' ||
+          github.event_name == 'workflow_dispatch' && inputs.deploy_email_worker == 'true'
         env:
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
         run: pnpm run deploy:email
 
-      # Deploy cleanup worker if changed
+      # Deploy cleanup worker if changed or manually triggered
       - name: Deploy Cleanup Worker
-        if: steps.check_changes.outputs.cleanup_worker_changed == 'true'
+        if: |
+          github.event_name == 'push' && steps.check_changes.outputs.cleanup_worker_changed == 'true' ||
+          github.event_name == 'workflow_dispatch' && inputs.deploy_cleanup_worker == 'true'
         env:
           CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

README.md

@@ -157,40 +157,54 @@ pnpm deploy:cleanup
 ### Github Actions 部署
 
 本项目可使用 GitHub Actions 实现自动化部署。支持以下触发方式：
-- 在 GitHub Actions 页面手动触发部署流程
+
-- 推送新的 tag 时触发部署流程
+1. **自动触发**：推送新的 tag 时自动触发部署流程
+2. **手动触发**：在 GitHub Actions 页面手动触发，可选择以下部署选项：
+   - Run database migrations：执行数据库迁移
+   - Deploy email Worker：重新部署邮件 Worker
+   - Deploy cleanup Worker：重新部署清理 Worker
+
+#### 部署步骤
 
 1. 在 GitHub 仓库设置中添加以下 Secrets：
+   - `CLOUDFLARE_API_TOKEN`: Cloudflare API 令牌
+   - `CLOUDFLARE_ACCOUNT_ID`: Cloudflare 账户 ID
+   - `DATABASE_NAME`: D1 数据库名称
+   - `DATABASE_ID`: D1 数据库 ID
+   - `NEXT_PUBLIC_EMAIL_DOMAIN`: 邮箱域名 (例如: moemail.app)
 
-- `CLOUDFLARE_API_TOKEN`: Cloudflare API 令牌
+2. 选择触发方式：
-- `CLOUDFLARE_ACCOUNT_ID`: Cloudflare 账户 ID
-- `DATABASE_NAME`: D1 数据库名称
-- `DATABASE_ID`: D1 数据库 ID
-- `NEXT_PUBLIC_EMAIL_DOMAIN`: 邮箱域名 (例如: moemail.app)
 
-2. 创建并推送新的 tag 来触发部署：
+   **方式一：推送 tag 触发**
+   ```bash
+   # 创建新的 tag
+   git tag v1.0.0
+   
+   # 推送 tag 到远程仓库
+   git push origin v1.0.0
+   ```
 
-```bash
+   **方式二：手动触发**
-# 创建新的 tag
+   - 进入仓库的 Actions 页面
-git tag v1.0.0
+   - 选择 "Deploy" workflow
-
+   - 点击 "Run workflow"
-# 推送 tag 到远程仓库
+   - 选择需要执行的部署选项
-git push origin v1.0.0
+   - 点击 "Run workflow" 开始部署
-```
 
 3. GitHub Actions 会自动执行以下任务：
-
+   - 构建并部署主应用到 Cloudflare Pages
-- 构建并部署主应用到 Cloudflare Pages
+   - 根据选项或文件变更执行数据库迁移
-- 检测并部署更新的 Email Worker
+   - 根据选项或文件变更部署 Email Worker
-- 检测并部署更新的 Cleanup Worker
+   - 根据选项或文件变更部署 Cleanup Worker
 
 4. 部署进度可以在仓库的 Actions 标签页查看
 
-注意事项：
+#### 注意事项
 - 确保所有 Secrets 都已正确设置
-- tag 必须以 `v` 开头（例如：v1.0.0）
+- 使用 tag 触发时，tag 必须以 `v` 开头（例如：v1.0.0）
-- 只有推送 tag 才会触发部署，普通的 commit 不会触发
+- 使用 tag 触发时，只有文件发生变更的部分会被部署
-- 如果只修改了某个 worker，只会部署该 worker
+- 手动触发时，可以选择性地执行特定的部署任务
+- 每次部署都会重新部署主应用
 
 [![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/beilunyang/moemail)