{
  "id": "create-a-github-actions-deploy-workflow",
  "type": "prompts",
  "category": "prompts",
  "locale": "es",
  "url": "/es/prompts/create-a-github-actions-deploy-workflow",
  "title": "Prompt para crear un flujo de trabajo de despliegue con GitHub Actions",
  "description": "Prompt para agente de IA para generar un flujo de trabajo CI/CD de producción con GitHub Actions para una app Next.js que incluya pasos de verificación de tipos, pruebas, compilación y despliegue.",
  "tools": [
    "Cursor",
    "Claude Code",
    "Codex",
    "Windsurf"
  ],
  "stack": [
    "Next.js",
    "TypeScript",
    "Cloudflare"
  ],
  "tags": [
    "deploy",
    "nextjs",
    "typescript",
    "cloudflare"
  ],
  "difficulty": "medium",
  "updated": "2026-06-08",
  "markdown": "Proporciona este prompt a tu agente para generar un archivo de flujo de trabajo de GitHub Actions probado en batalla\nque ejecute verificación de tipos, pruebas y una compilación de producción antes de desplegar — sin\ncomprometer secretos ni usar versiones de acciones obsoletas.\n\n## Prompt principal\n\n```txt title=\"Main Prompt\"\nYou are working in a Next.js 15 project that uses TypeScript and Bun as the package manager.\nDeployments go to Cloudflare Pages.\n\nTask: create a GitHub Actions CI/CD workflow at `.github/workflows/deploy.yml`.\n\nRequirements:\n- Trigger on: `push` to `main` and `pull_request` targeting `main`.\n- On pull_request: run only the `ci` job (lint, typecheck, build).\n- On push to main: run `ci` then `deploy` (deploy only if ci passes).\n- `ci` job:\n  - Runner: `ubuntu-latest`.\n  - Steps: checkout, setup Bun (`oven-sh/setup-bun@v2`), `bun install --frozen-lockfile`,\n    `bun run typecheck`, `bun run build`.\n  - Cache: use `actions/cache@v4` to cache `node_modules` keyed on `bun.lock` hash.\n- `deploy` job:\n  - needs: [ci]\n  - if: `github.event_name == 'push'`\n  - Deploy to Cloudflare Pages using `cloudflare/wrangler-action@v3`.\n  - Secrets used: `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` (from GitHub secrets — do NOT\n    hard-code values).\n  - Set `command: pages deploy .next --project-name=my-app --branch=main`.\n- Add a concurrency group to cancel in-progress runs on the same branch.\n- Do NOT pin to `@v1` of any action — use the versions specified above.\n- Do NOT store any secret value in the YAML file.\n\nStop and show the complete workflow YAML before writing the file.\n```\n\n## Notas de implementación\n\n- `oven-sh/setup-bun@v2` instala la versión de Bun desde `.bun-version` o `package.json#engines.bun`\n  si está presente — asegúrate de que exista uno de esos archivos o fija la versión con `bun-version: '1.x'`.\n- `--frozen-lockfile` evita que el CI actualice dependencias silenciosamente; fallar aquí significa que `bun.lock`\n  no está sincronizado localmente.\n- Cloudflare Pages con `wrangler-action@v3` requiere que el proyecto exista primero en el panel de Cloudflare\n  — documenta este requisito previo en un comentario dentro del YAML.\n- Concurrencia: usa `group: ${{ github.workflow }}-${{ github.ref }}` con `cancel-in-progress: true`.\n\n## Cambios de archivo esperados\n\n```txt\n.github/workflows/deploy.yml    (new)\n```\n\n## Criterios de aceptación\n\n- Un PR a `main` activa solo el trabajo `ci` y publica una verificación de estado.\n- Un merge a `main` activa `ci` y luego `deploy`, en orden.\n- No aparecen secretos en el archivo YAML.\n- Un segundo push a la misma rama cancela la ejecución anterior en curso.\n\n## Comandos de prueba\n\n```bash\n# validate YAML syntax locally\nbun x @actions/validator .github/workflows/deploy.yml || true\n# or use actionlint\ndocker run --rm -v \"$(pwd):/repo\" rhysd/actionlint:latest /repo/.github/workflows/deploy.yml\n```\n\n## Errores comunes de la IA\n\n- Codificar el valor de `CLOUDFLARE_API_TOKEN` en lugar de usar `${{ secrets.CLOUDFLARE_API_TOKEN }}`.\n- Usar `actions/checkout@v2` o `actions/cache@v2` obsoletos en lugar de v4.\n- Ejecutar el trabajo de despliegue en eventos pull_request, desplegando desde forks.\n- Falta `needs: [ci]` en el trabajo de despliegue, permitiendo despliegues incluso si las pruebas fallan.\n\n## Prompt de corrección\n\n```txt title=\"Fix Prompt\"\nThe workflow deploys even when CI fails, or secrets are exposed. Fix in order:\n1. Add `needs: [ci]` to the `deploy` job.\n2. Add `if: github.event_name == 'push' && github.ref == 'refs/heads/main'` to the deploy job.\n3. Replace any hard-coded token values with `${{ secrets.CLOUDFLARE_API_TOKEN }}`.\n4. Upgrade any @v1/@v2 action references to the versions specified in the original prompt.\nShow only the corrected YAML diff.\n```"
}