tsh-deploy
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_URLandUPSTASH_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 buildlocally first
OAuth errors
- Token expired
- Solution: Generate new refresh token in Zoho API Console
Vercel Dashboard
- Project: https://vercel.com/tsh-03790822/tsh-clients-console
- Deployments: Check deployment logs
- Settings: Environment variables, domains
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 buildlocally - 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)