ci-pipeline

Skill: CI/CD Pipeline

When to Use This Skill

This skill activates when you need to:

• Understand the project's CI/CD setup
• Debug failing CI/CD pipelines
• Fix workflow errors
• Add or modify CI checks
• Understand why checks are failing on your PR

Prerequisites

• Basic understanding of CI/CD concepts
• Access to repository (to view workflow runs)
• Understanding of project's tech stack

Step-by-Step Workflow

Step 1: Identify CI/CD Platform

Check for CI configuration files:

# GitHub Actions
.github/workflows/*.yml

# GitLab CI
.gitlab-ci.yml

# CircleCI
.circleci/config.yml

# Travis CI
.travis.yml

# Jenkins
Jenkinsfile

# Azure Pipelines
azure-pipelines.yml

Step 2: View CI Pipeline Status

GitHub Actions (via CLI):

# Install GitHub CLI if needed
# https://cli.github.com/

# List recent workflow runs
gh run list

# View specific run
gh run view <run-id>

# Watch a running workflow
gh run watch

GitHub Actions (via Web):

1. Go to repository on GitHub
2. Click "Actions" tab
3. Select workflow run
4. View job details and logs

Step 3: Understand Common CI Workflows

Typical CI Pipeline Stages

# .github/workflows/ci.yml example
name: CI
on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup
        # Install dependencies
      - name: Lint
        # Run linter
      - name: Test
        # Run tests
      - name: Build
        # Build project

Common stages:

1. Checkout - Clone repository code
2. Setup - Install language/dependencies
3. Lint - Check code style
4. Test - Run test suite
5. Build - Compile/build project
6. Deploy - Deploy to environment (optional)

Step 4: Debug Failing CI Checks

Step 4a: Identify Which Check Failed

Look at PR checks:

• ✅ Green check - Passed
• ❌ Red X - Failed
• 🟡 Yellow dot - Running
• ⚪ Gray circle - Pending

Click on failed check to see:

• Job name
• Failure step
• Error message
• Logs