从Zeit Now迁移到vercel-action完整迁移指南与注意事项【免费下载链接】vercel-actionThis action make a deployment with github actions instead of Vercel builder.项目地址: https://gitcode.com/gh_mirrors/ve/vercel-action想要从Zeit Now无缝迁移到Vercel Action吗这篇完整指南将带你了解从Zeit Now迁移到vercel-action的详细步骤、关键注意事项和最佳实践。vercel-action是一个强大的GitHub Actions工具让你完全掌控部署流程摆脱Vercel Builder的限制。为什么需要从Zeit Now迁移到vercel-actionZeit Now是Vercel的前身而vercel-action是专门为GitHub Actions设计的部署工具。迁移到vercel-action的主要优势包括完全控制部署流程使用GitHub Actions进行构建和部署更灵活的配置选项支持预构建部署、GitHub部署集成等功能更好的CI/CD集成与GitHub Actions生态系统完美融合现代化的功能支持支持Vercel CLI最新特性迁移前的准备工作1. 了解关键术语变化在开始迁移前先熟悉这些关键术语的变化Zeit Now 术语Vercel Action 对应术语zeit-tokenvercel-tokennow-org-idvercel-org-idnow-project-idvercel-project-idnow-argsvercel-args2. 获取必要的凭证迁移前需要准备以下凭证Vercel Token从Vercel账户设置中生成Vercel组织ID在项目设置中找到Vercel项目ID在项目概览页面获取迁移步骤详解步骤1更新GitHub Actions工作流将工作流中的action引用从now-deployment改为vercel-action# 旧版本Zeit Now - name: Zeit Now Deployment uses: amondnet/now-deploymentv2 # 新版本Vercel Action - name: Vercel Action uses: amondnet/vercel-actionv42步骤2更新输入参数更新工作流中的所有输入参数名称# 旧参数 with: zeit-token: ${{ secrets.ZEIT_TOKEN }} now-org-id: ${{ secrets.ORG_ID }} now-project-id: ${{ secrets.PROJECT_ID }} now-args: --prod # 新参数 with: vercel-token: ${{ secrets.VERCEL_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} vercel-args: --prod步骤3配置GitHub Secrets在GitHub仓库的Settings → Secrets and variables → Actions中更新密钥将ZEIT_TOKEN重命名为VERCEL_TOKEN确保ORG_ID和PROJECT_ID的值仍然有效如果需要添加GITHUB_TOKEN用于PR评论功能核心配置详解基本部署配置最基本的vercel-action配置如下name: Deploy to Vercel on: [push, pull_request] jobs: deploy: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - uses: amondnet/vercel-actionv42 with: vercel-token: ${{ secrets.VERCEL_TOKEN }} github-token: ${{ secrets.GITHUB_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} vercel-args: --prod禁用Vercel的自动部署为了完全控制部署流程需要在Vercel项目中禁用自动部署使用vercel.json配置{ public: false, git: { deploymentEnabled: false } }使用vercel.ts配置推荐import type { VercelConfig } from vercel/config/v1; export const config: VercelConfig { public: false, git: { deploymentEnabled: false, }, };高级功能迁移指南预构建部署迁移从Zeit Now迁移到vercel-action的预构建部署# 旧方式Zeit Now - name: Build with Now run: npx now build # 新方式Vercel Action - name: Build with Vercel CLI run: vercel build --token${{ secrets.VERCEL_TOKEN }} env: VERCEL_ORG_ID: ${{ secrets.ORG_ID }} VERCEL_PROJECT_ID: ${{ secrets.PROJECT_ID }} - uses: amondnet/vercel-actionv42 with: vercel-token: ${{ secrets.VERCEL_TOKEN }} github-token: ${{ secrets.GITHUB_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} prebuilt: trueGitHub部署集成vercel-action支持GitHub Deployments功能提供更好的部署跟踪- uses: amondnet/vercel-actionv42 id: vercel with: vercel-token: ${{ secrets.VERCEL_TOKEN }} github-token: ${{ secrets.GITHUB_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} github-deployment: true github-deployment-environment: production - run: echo Deployment ID is ${{ steps.vercel.outputs.deployment-id }}域名别名配置迁移域名别名配置到vercel-actionwith: vercel-token: ${{ secrets.VERCEL_TOKEN }} github-token: ${{ secrets.GITHUB_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} alias-domains: | staging.yourdomain.com pr-{{PR_NUMBER}}.yourdomain.com {{BRANCH}}.yourdomain.com常见问题与解决方案问题1Vercel CLI版本兼容性解决方案确保使用Vercel CLI 17版本旧版本可能不兼容- name: Install Vercel CLI run: npm install --global vercellatest问题2项目链接失败解决方案在本地使用Vercel CLI链接项目vercel按照提示选择团队和项目系统会自动生成.vercel目录其中包含orgId和projectId。问题3部署环境变量丢失解决方案通过vercel-action的env参数传递环境变量with: vercel-token: ${{ secrets.VERCEL_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} env: | API_URLhttps://api.example.com DATABASE_URL${{ secrets.DATABASE_URL }}最佳实践建议1. 使用最新稳定版本始终使用vercel-action的最新稳定版本当前为v42uses: amondnet/vercel-actionv422. 分离构建和部署步骤对于复杂项目建议分离构建和部署步骤jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - name: Build project run: npm run build - uses: actions/upload-artifactv4 with: name: build-output path: dist/ deploy: needs: build runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - uses: actions/download-artifactv4 with: name: build-output path: dist/ - uses: amondnet/vercel-actionv42 with: vercel-token: ${{ secrets.VERCEL_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} prebuilt: true3. 配置环境特定的部署根据不同环境配置不同的部署策略jobs: preview-deploy: if: github.event_name pull_request runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - uses: amondnet/vercel-actionv42 with: vercel-token: ${{ secrets.VERCEL_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} github-comment: true production-deploy: if: github.ref refs/heads/main runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - uses: amondnet/vercel-actionv42 with: vercel-token: ${{ secrets.VERCEL_TOKEN }} vercel-org-id: ${{ secrets.ORG_ID }} vercel-project-id: ${{ secrets.PROJECT_ID }} vercel-args: --prod迁移验证清单完成迁移后使用以下清单验证配置Action名称已从now-deployment更新为vercel-action所有输入参数已更新为新命名规范GitHub Secrets已正确配置Vercel项目的自动部署已禁用预构建部署配置正确如适用域名别名配置正确如适用GitHub部署集成正常工作如启用环境变量正确传递部署日志无错误信息性能优化技巧1. 使用缓存加速构建- name: Cache node modules uses: actions/cachev3 with: path: ~/.npm key: ${{ runner.os }}-node-${{ hashFiles(**/package-lock.json) }} restore-keys: | ${{ runner.os }}-node-2. 并行化部署步骤对于多环境部署可以使用并行作业jobs: deploy-preview: # 预览环境配置 deploy-staging: # 预发布环境配置 needs: deploy-preview deploy-production: # 生产环境配置 needs: deploy-staging3. 监控和告警配置设置部署监控和告警- name: Notify on failure if: failure() uses: actions/github-scriptv6 with: script: | github.rest.issues.createComment({ issue_number: context.issue.number, owner: context.repo.owner, repo: context.repo.repo, body: 部署失败请检查日志。 })总结从Zeit Now迁移到vercel-action是一个简单但重要的升级过程。通过遵循本指南中的步骤你可以顺利迁移到更现代化、功能更强大的部署方案。vercel-action不仅提供了更好的GitHub Actions集成还支持更多高级功能如预构建部署、GitHub部署集成和域名别名管理。记住迁移的关键点更新action引用和参数名称配置正确的GitHub Secrets禁用Vercel的自动部署根据需求配置高级功能通过vercel-action你可以获得更灵活的部署控制、更好的CI/CD集成和更可靠的部署流程。立即开始迁移体验更高效的Vercel部署工作流【免费下载链接】vercel-actionThis action make a deployment with github actions instead of Vercel builder.项目地址: https://gitcode.com/gh_mirrors/ve/vercel-action创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考