cicd-pipeline-generator

CI/CD Pipeline Generator

Overview

Generate production-ready CI/CD pipeline configuration files for various platforms (GitHub Actions, GitLab CI, CircleCI, Jenkins). This skill provides templates and guidance for setting up automated workflows that handle linting, testing, building, and deployment for modern web applications, particularly Node.js/Next.js projects.

Core Capabilities

1. Platform Selection

Choose the appropriate CI/CD platform based on project requirements:

• GitHub Actions: Best for GitHub-hosted projects with native integration
• GitLab CI/CD: Ideal for GitLab repositories with complex pipeline needs
• CircleCI: Optimized for Docker workflows and fast build times
• Jenkins: Suitable for self-hosted, highly customizable environments

Refer to references/platform-comparison.md for detailed platform comparisons, pros/cons, and use case recommendations.

2. Pipeline Configuration Generation

Generate pipeline configs following these principles:

Pipeline Stages

Structure pipelines with these standard stages:

1. Install Dependencies

   • Checkout code from repository
   • Setup runtime environment (Node.js version)
   • Restore cached dependencies
   • Install dependencies with npm ci
   • Cache dependencies for future runs

2. Lint

   • Run ESLint for code quality
   • Run TypeScript type checking
   • Fail fast on linting errors

3. Test

   • Execute unit tests
   • Execute integration tests
   • Generate code coverage reports
   • Upload coverage to reporting services (Codecov, Coveralls)

4. Build

   • Create production build
   • Verify build succeeds
   • Store build artifacts

5. Deploy

   • Deploy to staging (develop branch)
   • Deploy to production (main branch)
   • Run post-deployment smoke tests

Caching Strategy

Implement effective caching to speed up builds:

# Cache node_modules based on package-lock.json
cache:
  key: ${{ hashFiles('package-lock.json') }}
  paths:
    - node_modules/
    - .npm/