tsh-deploy

Qmop1967 的头像作者 Qmop1967

TSH客户端控制台的Vercel部署工作流。适用于:(1) 将更改部署到生产或暂存环境(2) 检查部署状态(3) 解决部署问题(4) 设置环境变量(5) 管理域名和DNS(6) 部署后运行缓存重新验证

📖 中文导读:TSH客户端控制台的Vercel部署工作流。适用于:(1) 将更改部署到生产或暂存环境(2) 检查部署状态(3) 解决部署问题(4) 设置环境变量(5) 管理域名和DNS(6) 部署后运行缓存重新验证 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: tsh-deploy description: | Vercel deployment workflow for TSH Clients Console. Use when: (1) Deploying changes to production or staging (2) Checking deployment status (3) Troubleshooting deployment issues (4) Setting up environment variables (5) Managing domains and DNS (6) Running cache revalidation after deployment

TSH Deployment

Quick Deploy

# Deploy to PRODUCTION
cd "/Users/khaleelal-mulla/General/ Projects/tsh-clients-console"
vercel --prod --yes

URLs

Environment URL
Production https://www.tsh.sale
Staging https://staging.tsh.sale
Vercel Default https://tsh-clients-console.vercel.app

Deployment Workflow

1. Pre-deployment Checks

# Run type check
npm run build

# Check for lint errors
npm run lint

# Verify environment variables
vercel env ls

2. Deploy to Staging (Optional)

vercel --yes
# Verify at staging.tsh.sale

3. Deploy to Production

vercel --prod --yes

4. Post-deployment

# Revalidate caches
curl "https://www.tsh.sale/api/revalidate?tag=all&secret=tsh-revalidate-2024"

# Verify site is up
curl -I https://www.tsh.sale

Environment Variables

Required Variables (Vercel Dashboard)

# Zoho OAuth
ZOHO_CLIENT_ID=<client_id>
ZOHO_CLIENT_SECRET=<client_secret>
ZOHO_REFRESH_TOKEN=<refresh_token>
ZOHO_ORGANIZATION_ID=748369814

# Upstash Redis (CRITICAL for token caching)
UPSTASH_REDIS_REST_URL=https://fine-mole-41883.upstash.io
UPSTASH_REDIS_REST_TOKEN=<token>

# NextAuth
NEXTAUTH_URL=https://www.tsh.sale
NEXTAUTH_SECRET=<secret>

# Email
RESEND_API_KEY=<api_key>
EMAIL_FROM=TSH <noreply@tsh.sale>

Managing Variables

# List all variables
vercel env ls

# Add variable
vercel env add VARIABLE_NAME production preview

# Remove variable
vercel env rm VARIABLE_NAME production preview

Domain Configuration

DNS Records (Namecheap):

www      CNAME   cname.vercel-dns.com
staging  CNAME   cname.vercel-dns.com
_vercel  TXT     <verification>

Common Issues

"Contact for price" after deploy

  • Upstash Redis env vars missing
  • Solution: Verify UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN

Stock/prices not updating

  • Cache needs revalidation
  • Solution: curl "https://www.tsh.sale/api/revalidate?tag=all&secret=tsh-revalidate-2024"

Build fails

  • Type errors
  • Solution: Run npm run build locally first

OAuth errors

  • Token expired
  • Solution: Generate new refresh token in Zoho API Console

Vercel Dashboard

Rollback

# List recent deployments
vercel ls

# Promote previous deployment
vercel promote <deployment-url>

Cache Revalidation

# All caches
curl "https://www.tsh.sale/api/revalidate?tag=all&secret=tsh-revalidate-2024"

# Specific tags
curl "https://www.tsh.sale/api/revalidate?tag=products&secret=tsh-revalidate-2024"
curl "https://www.tsh.sale/api/revalidate?tag=price-lists&secret=tsh-revalidate-2024"

Deployment Checklist

  • Run npm run build locally
  • Fix any type/lint errors
  • Commit all changes
  • Deploy: vercel --prod --yes
  • Wait for deployment to complete
  • Verify site: curl -I https://www.tsh.sale
  • Revalidate caches if needed
  • Test critical pages (shop, login, dashboard)