Maison/arti-api/auth-service/pipeline/PIPELINE-README.md

Pipeline Configuration Files

This folder contains all Drone CI pipeline-related configuration files and scripts.

📁 File Organization

🔧 Jsonnet Configuration

• common.libsonnet - Shared pipeline components (steps, environment, triggers)
• build-steps.libsonnet - Build-specific logic (external Buildah integration)

🚀 Management Scripts

• manage-external-buildah.sh - External Buildah service management
• update-buildah-pod.sh - Auto-update pod references in configurations
• deploy-external-buildah.sh - Complete deployment automation
• convert-to-jsonnet.sh - Migration helper from YAML to Jsonnet

⚙️ Kubernetes Resources

• buildah-external-deployment.yaml - External Buildah service deployment
• buildah-rbac.yaml - RBAC for Buildah operations
• drone-build-rbac.yaml - RBAC for Drone build steps
• default-sa-binding.yaml - Service account permissions
• drone-configmap-updated.yaml - Drone server configuration with Jsonnet support

📋 Alternative Configurations

• Various .drone.yml.* files - Alternative pipeline configurations for reference
• .drone.star.example - Starlark configuration example (not used)

📚 Documentation

• EXTERNAL-BUILDAH-SYSTEM.md - External build system documentation
• JSONNET-GUIDE.md - Jsonnet usage guide
• Other analysis and guide files

🔄 Usage Workflow

1. Edit Configuration: Modify common.libsonnet or build-steps.libsonnet
2. Test Locally: cd .. && jsonnet .drone.jsonnet
3. Deploy: Commit and push changes
4. Manage: Use scripts in this folder for maintenance

🎯 Key Benefits

• 🧩 Organized Structure: All pipeline files in one place
• 🔄 Modular Design: Separate concerns and reusable components
• 📝 Easy Maintenance: Clear file organization and documentation
• 🛠️ Management Tools: Complete set of automation scripts

📖 Quick Start

# Test current configuration
cd .. && jsonnet .drone.jsonnet

# Check external Buildah status  
./manage-external-buildah.sh status

# Deploy complete system
./deploy-external-buildah.sh

# Update pod references after restarts
./update-buildah-pod.sh

🔗 Related Files

• ../.drone.jsonnet - Root-level entry point (imports from this folder)
• ../Dockerfile - Application container definition
• ../requirements.txt - Application dependencies