Operator Manual¶
Configure and run secure automation infrastructure.
This manual covers the operational procedures for setting up and managing automation systems. While the Developer Guide focuses on building systems, this manual focuses on running them.
GitHub Actions¶
Enterprise-grade GitHub automation with centralized authentication and cross-repository operations.
-
GitHub App Setup
Create and configure organization-level GitHub Apps for secure, centralized authentication.
-
Actions Integration
Generate and use tokens in workflows with proper scoping and security.
-
Use Cases
Real-world patterns for cross-repository automation.
What's Covered¶
GitHub App Setup¶
- Creating organization-level GitHub Apps
- Storing credentials securely
- Permission patterns and scoping
- Installation and maintenance
Actions Integration¶
- Token generation with
actions/create-github-app-token - Workflow patterns for cross-repo operations
- Error handling and troubleshooting
- Performance optimization
Use Cases¶
- File Distribution - Sync files across multiple repositories
- Three-stage workflow pattern (Discovery → Distribution → Summary)
- Idempotent operations for safe reruns
Coming Soon¶
Expanding Coverage
Future additions to the Operator Manual:
- Argo Workflows - Event-driven Kubernetes automation
- Argo Events - Event source configuration
- Monitoring - Observability and alerting setup
- Troubleshooting - Common issues and solutions
See the Roadmap for the full list.
Running automation that doesn't wake you up at 3am.