GitHub Actions Importer - Quick Reference Card

# Install the CLI extension
gh extension install github/gh-actions-importer
 
# Update to latest version
gh actions-importer update
 
# Configure credentials (interactive)
gh actions-importer configure
 
# Check version
gh actions-importer version

export GITHUB_ACCESS_TOKEN="ghp_xxxxx"
export GITHUB_INSTANCE_URL="https://github.com"
 
# Jenkins
export JENKINS_ACCESS_TOKEN="xxxxx"
export JENKINS_USERNAME="admin"
export JENKINS_INSTANCE_URL="https://jenkins.amd.com"

# Audit entire Jenkins instance
gh actions-importer audit jenkins \
  --output-dir ./audit-results \
  --jenkins-url https://jenkins.amd.com \
  --jenkins-username admin \
  --jenkins-access-token $JENKINS_TOKEN
 
# What you get:
# - audit_summary.md (high-level overview)
# - jobs.json (complete inventory)
# - plugins.json (plugin usage analysis)
# - shared_libraries.json (dependencies)

✅ Total Pipelines: 847
✅ Simple (auto-convert): 512 (60%)
⚠️  Medium (minor fixes): 254 (30%)
❌ Complex (manual work): 81 (10%)
📊 Conversion Rate: 78%

# Forecast GitHub Actions usage
gh actions-importer forecast jenkins \
  --output-dir ./forecast \
  --jenkins-url https://jenkins.amd.com \
  --jenkins-username admin \
  --jenkins-access-token $JENKINS_TOKEN \
  --start-date 2025-01-01 \
  --end-date 2025-02-01
 
# What you get:
# - Estimated Actions minutes/month
# - Peak concurrent jobs
# - Runner recommendations
# - Cost estimates

Minutes/Month: 1,234,567
Concurrent Jobs (p95): 87
Estimated Cost: $X,XXX/month
Recommended Runners:
  - Self-hosted (small): 40
  - Self-hosted (medium): 30
  - Self-hosted (large): 10

# Convert single pipeline (local output only)
gh actions-importer dry-run jenkins \
  --source-url https://jenkins.amd.com/job/my-project/job/build \
  --output-dir ./converted \
  --jenkins-username admin \
  --jenkins-access-token $JENKINS_TOKEN
 
# What you get:
# - Converted workflow YAML
# - Conversion report (warnings)
# - Manual steps needed
# - Side-by-side comparison

- [ ] All steps converted?
- [ ] Secrets properly referenced?
- [ ] Conditions correct?
- [ ] Matrix strategy needed?
- [ ] Custom actions required?

# Convert and create pull request
gh actions-importer migrate jenkins \
  --source-url https://jenkins.amd.com/job/my-project/job/build \
  --target-url https://github.com/amd/my-project \
  --output-dir ./migration \
  --jenkins-username admin \
  --jenkins-access-token $JENKINS_TOKEN \
  --github-access-token $GITHUB_PAT
 
# What you get:
# - Automatic PR creation
# - Workflow file in .github/workflows/
# - Migration notes in PR description
# - Checklist of manual steps

# Create list of jobs to audit
cat > jobs.txt &lt;<EOF
https://jenkins.amd.com/job/team-a/job/build
https://jenkins.amd.com/job/team-a/job/test
https://jenkins.amd.com/job/team-a/job/deploy
EOF
 
# Batch audit
while read job_url; do
  gh actions-importer dry-run jenkins \
    --source-url "$job_url" \
    --output-dir "./converted/$(basename $job_url)"
done &lt; jobs.txt

# Find all maven builds
gh actions-importer audit jenkins --json | \
  jq -r '.pipelines[] | select(.type=="maven") | .url' | \
while read url; do
  echo "Migrating: $url"
  gh actions-importer migrate jenkins --source-url "$url"
done

# Clone the IssueOps template
gh repo create amd/migration-ops \
  --template actions/importer-issue-ops \
  --private
 
# Users create issues with:
# - Jenkins job URL
# - Target repo
# - Team mention
 
# Workflow auto-creates migration PRs

name: Migrate Jenkins Pipeline
labels: [migrate-jenkins]
 
Jenkins URL: https://jenkins.amd.com/job/my-pipeline
Target Repo: amd/my-project
Team: @amd/backend-team

# Use custom transformer for XYZ-specific patterns
gh actions-importer migrate jenkins \
  --source-url https://jenkins.amd.com/job/build \
  --custom-transformers ./transformers/amd-custom.rb

# Multibranch pipelines
gh actions-importer dry-run jenkins \
  --source-url https://jenkins.amd.com/job/multibranch-project
 
# Freestyle jobs
gh actions-importer dry-run jenkins \
  --source-url https://jenkins.amd.com/job/freestyle-job
 
# Pipeline jobs
gh actions-importer dry-run jenkins \
  --source-url https://jenkins.amd.com/job/pipeline-job

# Migrate entire folder
gh actions-importer audit jenkins \
  --source-url https://jenkins.amd.com/job/team-folder \
  --output-dir ./team-folder-audit

# Verify credentials
curl -u $JENKINS_USERNAME:$JENKINS_TOKEN \
  https://jenkins.amd.com/api/json
 
# For GitHub
gh auth status

# Check warnings in dry-run output
# Look for: "TODO: Manual migration required"
# Create custom action or use alternative

# Shared libraries need manual conversion
# Strategy: Convert to composite actions or reusable workflows
# See: .github/actions/ or .github/workflows/reusable-*.yml

# Extract Groovy scripts
# Convert to shell scripts or Python
# Use composite actions or custom actions

#!/bin/bash
# migration-metrics.sh
 
echo "=== Migration Dashboard ==="
echo "Total Pipelines: $(jq '.total' audit-results/audit_summary.json)"
echo "Migrated: $(gh api repos/amd/projects -q '.workflows | length')"
echo "In Progress: $(gh pr list --label jenkins-migration --json number | jq 'length')"
echo "Success Rate: 78%"
echo "Time Saved: $(( (512 * 8) - (512 * 2) )) hours"

## Post-Migration Validation
 
- [ ] Workflow triggers correctly (push/PR/schedule)
- [ ] All build steps execute
- [ ] Tests pass with same coverage
- [ ] Artifacts generated correctly
- [ ] Secrets/variables configured
- [ ] Notifications working
- [ ] Build time within 20% of Jenkins
- [ ] Team trained on new workflow

#!/bin/bash
# Calculate savings
 
TOTAL_PIPELINES=500
HOURS_PER_MANUAL=8
HOURS_PER_AUTOMATED=2
ENGINEER_RATE=150
 
MANUAL_COST=$(( TOTAL_PIPELINES * HOURS_PER_MANUAL * ENGINEER_RATE ))
AUTO_COST=$(( TOTAL_PIPELINES * HOURS_PER_AUTOMATED * ENGINEER_RATE ))
SAVINGS=$(( MANUAL_COST - AUTO_COST ))
 
echo "Manual Migration: \$$MANUAL_COST"
echo "With Importer: \$$AUTO_COST"
echo "Savings: \$$SAVINGS (75% reduction)"
echo "Time Saved: $(( TOTAL_PIPELINES * (HOURS_PER_MANUAL - HOURS_PER_AUTOMATED) )) hours"

Week 1-2: Audit & Planning
  - Run Actions Importer audit
  - Categorize pipelines (simple/medium/complex)
  - Set up IssueOps workflow

Week 3-6: Pilot & Patterns
  - Migrate 10% (50 simple pipelines)
  - Create reusable workflow templates
  - Build custom transformers

Week 7-16: Bulk Migration
  - IssueOps self-service for teams
  - DevOps team handles complex cases
  - Parallel validation (Jenkins + Actions)

Week 17-20: Optimization & Cutover
  - Performance tuning
  - Team training
  - Decommission Jenkins