foxhunt/scripts/LOCAL_CI_QUICK_REF.md

Local CI/CD Pipeline - Quick Reference

Script: scripts/local_ci_pipeline.sh Status: ✅ Production Ready

---

Quick Commands

# Full pipeline (Build + Test + Push)
./scripts/local_ci_pipeline.sh

# Test only (skip push)
./scripts/local_ci_pipeline.sh --skip-push

# Dry-run (show commands)
./scripts/local_ci_pipeline.sh --dry-run

# Verbose output
./scripts/local_ci_pipeline.sh --verbose --skip-push

---

Pipeline Stages

Stage	Emoji	Duration	Description
0. Pre-flight	🔍	<5s	Docker, git, Dockerfile checks
1. Build	🔨	2-3 min	Build Docker image
2. Test	🧪	10-20s	GLIBC, CUDA, entrypoint validation
3. Push	🚀	1-5 min	Push to Docker Hub

---

Test Checklist

• ✅ GLIBC 2.35 (Ubuntu 22.04)
• ✅ CUDA 12.4.1 libraries
• ✅ cuDNN 9 libraries
• ✅ Entrypoint scripts
• ✅ Volume mount architecture

---

Expected Output

========================================
🚀 LOCAL CI/CD PIPELINE SIMULATOR
========================================

🔍 STAGE 0: PRE-FLIGHT CHECKS
✓ All required commands available
✓ Docker daemon running
⏱ Pre-flight checks completed in 0m 1s

🔨 STAGE 1: BUILD
✓ Docker image built successfully: 7.73 GB
⏱ Build completed in 0m 17s

🧪 STAGE 2: TEST
✓ GLIBC 2.35 validated
✓ CUDA libraries validated
✓ Binary GLIBC dependencies validated
✓ Entrypoint scripts validated
⏱ Test completed in 0m 3s

========================================
✅ PIPELINE COMPLETE
========================================
✓ Total pipeline time: 0m 20s
ℹ GitLab CI/CD readiness: ✅

---

Troubleshooting

Error	Fix
Docker daemon not running	sudo systemctl start docker
Docker Hub auth failed	docker login
GLIBC version mismatch	Check Dockerfile base image
CUDA libraries missing	Check cudnn-devel variant

---

GitLab CI/CD Integration

# .gitlab-ci.yml
stages: [build, test, push]

build:
  stage: build
  script:
    - docker build -f Dockerfile.runpod -t jgrusewski/foxhunt:latest .

test:
  stage: test
  script:
    - docker run --rm --entrypoint /bin/bash jgrusewski/foxhunt:latest -c "ldd --version | grep 2.35"
    - docker run --rm --entrypoint /bin/bash jgrusewski/foxhunt:latest -c "ldconfig -p | grep libcublas"

push:
  stage: push
  script:
    - docker login -u $DOCKER_HUB_USER -p $DOCKER_HUB_TOKEN
    - docker push jgrusewski/foxhunt:latest

---

Performance

Metric	Value
Total time	4-9 min
Image size	7.73 GB
Test time	10-20s
Cost	$0 (local)

---

Files

• Script: /scripts/local_ci_pipeline.sh
• Guide: /LOCAL_CI_PIPELINE_GUIDE.md
• Validation: /LOCAL_CI_PIPELINE_VALIDATION.md
• Dockerfile: /Dockerfile.runpod