How buildkite/agent works
Core Components (Main Layer)
• Agent Core (from /agent directory)
• Job Runner (from /agent/job_runner.go)
• API Client (from /api directory)
• CLI Command Interface (from /clicommand directory)
Integration Layer
• Buildkite.com API (primary connection)
• Cloud Provider Metadata Services (AWS EC2, GCP, ECS)
• Container Platforms (Kubernetes, Docker)
• Artifact Storage (S3, GCS, Azure Blob)
Job Execution Layer
• Components from /internal/job:
• Job Executor
• Git Checkout System
• Plugin System
• Hook System
• Docker Integration
Supporting Systems
• Logging System (/logger)
• Metrics Collection (/metrics)
• Process Management (/process)
• Lock Management (/lock)
• Status Monitoring (/status)
Use these visual elements:
Plugin Architecture
• How the agent supports extensibility through plugins
• Plugin interface from /agent/plugin
Job Pipeline
• Flow from job reception to execution
• Hook points in the pipeline
Multi-platform Support
• Platform-specific components
• Container integration points
Security Layer
• Authentication mechanisms
• OIDC integration points
• Credential management
Additional Considerations:
Integration points for
• CI/CD systems
• Source control systems
• Artifact storage systems
Observability components
• Logging
• Metrics
• Status reporting