# Deploy Release Test > Valida el paquete de preview de Next.js específico de un commit y dispara manualmente toda la suite de tests de despliegue vía el workflow test_e2e_deploy_release.yml de GitHub Actions. Fuente: https://skillsagentes.com/skills/vercel/next.js/deploy-release-test Markdown: https://skillsagentes.com/skills/vercel/next.js/deploy-release-test.md Repositorio: https://github.com/vercel/next.js Autor: vercel Licencia: MIT Actualizado: hace 10 días Coste de contexto: 144 tok instalada, 1.2k tok al activarse, 1.3k tok con todos los archivos del bundle Bundle: 2 archivos, 5 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add vercel/next.js --skill deploy-release-test --agent claude-code # Cursor npx -y skills add vercel/next.js --skill deploy-release-test --agent cursor # Codex npx -y skills add vercel/next.js --skill deploy-release-test --agent codex # Gemini CLI npx -y skills add vercel/next.js --skill deploy-release-test --agent gemini # Windsurf npx -y skills add vercel/next.js --skill deploy-release-test --agent windsurf # Cline npx -y skills add vercel/next.js --skill deploy-release-test --agent cline ``` ## Qué hace - Resuelve el último SHA de la rama de un PR y construye la URL del paquete de vercel-packages para ese commit - Espera con scripts/wait-for-preview-tarball.mjs a que el tarball redirigido responda antes de continuar - Dispara test_e2e_deploy_release.yml vía gh workflow run pasando solo nextVersion, preservando los demás inputs por defecto - Verifica con gh run list que el run creado corresponde a la rama y SHA validados ## Cuándo usarla - Se pide ejecutar manualmente la suite completa de tests de despliegue de Next.js - Se pide correr específicamente el workflow test_e2e_deploy_release.yml desde una rama interna de PR de vercel/next.js ## Cuándo no - Para chequeos puntuales de un test de despliegue o un grupo acotado de tests, usar el flujo local con pnpm test-deploy - Si la rama del PR es de un fork (cross-repository), ya que no puede ejecutar este workflow con secretos ## Qué la activa - "Ejecuta la suite completa de deploy tests para el PR 12345 de next.js" - "Dispara el workflow test_e2e_deploy_release.yml desde mi rama de PR interna" - "Corre todos los tests de despliegue para el commit actual de esta rama" ## Antes de instalar - Requiere gh CLI configurado con acceso al repo vercel/next.js y que la rama del PR exista en ese repositorio (no en un fork). - makes network requests ## Archivos - SKILL.md — 5 KB - agents/openai.yaml — 253 B ## SKILL.md Reproducido tal cual desde vercel/next.js bajo MIT. Esta sección es el documento original y está en inglés. # Deploy Release Test Use this skill only when manually running the entire Next.js deployment test suite for a pull request. Treat package validation as a hard gate: never dispatch the workflow until the exact commit's redirected tarball responds successfully. ## Scope Do not use this workflow to sanity-check one deployment test or a focused group of tests. Follow [Running Deploy Tests Locally](../../../contributing/core/testing.md#running-deploy-tests-locally) instead: ```bash NEXT_TEST_VERSION=https://vercel-packages.vercel.app/next/commits//next pnpm test-deploy ``` If a request to "run deploy tests" does not explicitly call for the entire suite, prefer the focused local workflow and scope it to the affected tests. ## Inputs - Accept a PR number or determine the PR from the current branch. - Use repository `vercel/next.js` and workflow `.github/workflows/test_e2e_deploy_release.yml`. - Require the PR head branch to exist in `vercel/next.js`. A fork branch cannot run this secret-bearing workflow; use the repository's PR adoption process first when appropriate. ## Workflow 1. Resolve the PR branch and its latest commit from GitHub, not merely from the local checkout: ```bash gh pr view --repo vercel/next.js \ --json number,url,headRefName,headRefOid,isCrossRepository ``` If no PR number was supplied, omit `` to detect the PR from the current branch. Stop if `isCrossRepository` is `true`. Record `headRefName` as the branch and `headRefOid` as the commit SHA. 2. Construct the exact package URL: ```text https://vercel-packages.vercel.app/next/commits//next ``` 3. Wait for the package to become downloadable before dispatching anything: ```bash node scripts/wait-for-preview-tarball.mjs --commit-sha ``` Keep the wait in an ongoing terminal session and poll it so the user still receives progress updates. The helper uses `HEAD`, follows the redirect to Vercel Blob, and only succeeds when the final artifact is available. Do not substitute a check that accepts the initial redirect: that endpoint can redirect even while the blob still returns 404. If the helper times out or reports an authorization or build failure, do not dispatch the workflow. Report the failure and inspect the commit's `build-and-deploy` / `upload-preview-tarballs` checks if useful. 4. Resolve the PR again immediately after validation. Compare the current `headRefName` and `headRefOid` with the recorded values. If either changed, return to step 2 and validate the new commit-specific URL. Never reuse the old package URL for a moved branch. 5. Trigger the workflow from the PR branch and pass only `nextVersion`: ```bash gh workflow run test_e2e_deploy_release.yml \ --repo vercel/next.js \ --ref \ -f nextVersion=https://vercel-packages.vercel.app/next/commits//next ``` Do not pass any other `-f` values. Leaving them unspecified preserves the workflow defaults, including `vercelCliVersion: vercel@latest` and empty optional overrides. 6. Find and verify the newly created run: ```bash gh run list --repo vercel/next.js \ --workflow test_e2e_deploy_release.yml \ --branch \ --event workflow_dispatch \ --limit 5 \ --json databaseId,url,status,conclusion,headBranch,headSha,displayTitle,createdAt ``` Confirm that the newest matching run has: - `headBranch` equal to the PR branch - `headSha` equal to the validated commit SHA - `displayTitle` containing the exact commit-specific package URL A race can still move the branch between the final check and dispatch. If the run's `headSha` differs, report the mismatch and do not trigger another run until the new SHA's package has been validated. ## Completion Report Report the PR branch, validated SHA and package URL, workflow run URL, and its current status. Do not wait for the full deployment suite unless the user asks you to monitor it. ## Related Skills - `$pr-status-triage` - Inspect failures if the deployment workflow does not pass. - `$create-pr` - Create or update the internal PR branch before deployment testing. ## Dónde encaja - Categoría: [DevOps e infraestructura](https://skillsagentes.com/categorias/devops-infraestructura.md) — Despliegues, contenedores, IaC y flujos de gestión de incidentes. - Creador: [vercel](https://skillsagentes.com/creators/vercel.md) — 81 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Next Cache Components Adoption](https://skillsagentes.com/skills/vercel/next.js/next-cache-components-adoption.md): Activa Cache Components en una app de Next.js y resuelve las rutas bloqueantes que surgen: el flag cacheComponents, errores de blocking-prerender/instant validation y el codemod cache-components-instant-false. - [Next Cache Components Optimizer](https://skillsagentes.com/skills/vercel/next.js/next-cache-components-optimizer.md): Lleva una ruta de Next.js a navegación instantánea bajo Cache Components o PPR mediante un bucle agéntico: codifica el objetivo como un e2e instant() en rojo y lo trabaja hasta verde, ruta a ruta. - [Next Partial Prefetching Adoption](https://skillsagentes.com/skills/vercel/next.js/next-partial-prefetching-adoption.md): Activa Partial Prefetching en una app Next.js y trabaja los insights que surge: flag `partialPrefetching`, `export const prefetch = 'partial'`, auditoría de `Link prefetch={true}` y tests `instant()`. - [Next Dev Loop](https://skillsagentes.com/skills/vercel/next.js/next-dev-loop.md): Verifica el comportamiento en runtime de Next.js tras editar código de la aplicación. Combina /_next/mcp, la visión de Next.js, con agent-browser, la del navegador. Requiere un next dev en marcha. - [Gate Tests](https://skillsagentes.com/skills/vercel/next.js/gate-tests.md): Cómo usar las directivas de test @gate / @force-gate en lugar de it.skip o patrones de skip falso-verde, con las condiciones, el patrón de axis y los comandos de verificación. ## Skills relacionadas - [Authoring Skills](https://skillsagentes.com/skills/vercel/next.js/authoring-skills.md): Cómo crear y mantener skills de agente en .agents/skills/. Úsalo al crear un SKILL.md, escribir descripciones, elegir campos de frontmatter o decidir qué va en un skill y qué en AGENTS.md. - [Backport Pr](https://skillsagentes.com/skills/vercel/next.js/backport-pr.md): Lleva un pull request fusionado de Next.js desde canary a una rama de release anterior como next-16-2: localiza el commit, crea la rama, hace cherry-pick, valida y abre el PR. - [Create Pr](https://skillsagentes.com/skills/vercel/next.js/create-pr.md): Crea ramas, commits, pushes y pull requests de GitHub para Next.js. Cubre la plantilla de PR, el formato de --body, las ramas codex/ y las directivas de git de la app Codex. - [Dce Edge](https://skillsagentes.com/skills/vercel/next.js/dce-edge.md): Patrones de require() seguros para eliminación de código muerto y restricciones del runtime edge. Úsalo al escribir require condicionales, proteger imports de Node o editar define-env-plugin.ts. - [Flags](https://skillsagentes.com/skills/vercel/next.js/flags.md): Cómo añadir o modificar flags experimentales de Next.js de principio a fin: tipo, esquema zod, inyección en build, paso de variables en runtime y elección entre ramificar o generar variantes. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)