Chris Farhood
46d59b48b5
Updated all GitHub URLs from cpfarhood to privilegedescalation organization: - Repository URLs in package.json and Artifact Hub metadata - Documentation links and references - Git remote updated No functional changes - this is purely an organizational migration. Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
6.1 KiB
6.1 KiB
Headlamp Sealed Secrets Plugin Documentation
Complete documentation for the Headlamp Sealed Secrets plugin.
📚 Documentation Index
Getting Started
New to the plugin? Start here:
- Installation Guide - Install the plugin on Headlamp
- Quick Start - Create your first sealed secret in 5 minutes
User Guide
Learn how to use all the features:
- Creating Secrets - Encrypt and create sealed secrets
- Managing Keys - View and download sealing certificates
- Scopes Explained - Understand strict/namespace/cluster-wide scopes
- RBAC Permissions - Required permissions and access control
- Settings - Configure plugin behavior
Tutorials
Step-by-step guides for common workflows:
- CI/CD Integration - Automate secret creation with GitHub Actions, GitLab CI
- Multi-Cluster Setup - Manage secrets across multiple clusters
- Secret Rotation - Rotate secrets and sealing keys safely
- Disaster Recovery - Backup and restore procedures
- Migration from kubeseal - Migrate from CLI-based workflow
Troubleshooting
Solutions for common issues:
- Common Errors - Error messages and fixes
- Controller Issues - Connection and deployment problems
- Encryption Failures - Debugging encryption errors
- Permission Errors - RBAC troubleshooting
- Performance - Optimization tips
Development
Contributing to the plugin:
- Setup - Development environment configuration
- Workflow - Development and testing workflow
- Testing - Running and writing tests
- Code Style - Coding standards
- Debugging - Debugging tips and tools
- Release Process - How to release new versions
API Reference
Technical documentation:
- Functions - Exported function reference
- Types - TypeScript type definitions
- Hooks - React hooks API
- Components - Component props reference
- Examples - Code examples and patterns
Architecture
Technical design and decisions:
- Overview - System architecture
- Encryption Flow - How encryption works
- Type System - Result types and branded types explained
- Error Handling - Error handling patterns
- Accessibility - WCAG 2.1 AA compliance details
- ADRs - Architecture Decision Records
Deployment
Production deployment guides:
- Kubernetes - Deploy in K8s clusters
- Helm - Using with Helm deployments
- Security Hardening - Security best practices
- Monitoring - Observability setup
🔍 Quick Links
Popular Pages
- Quick Start Guide - Get started in 5 minutes
- CI/CD Integration - Automate your workflow
- Troubleshooting - Solve common issues
- Development Workflow - Contribute to the plugin
External Resources
- GitHub: cpfarhood/headlamp-sealed-secrets-plugin
- Issues: Report bugs
- Discussions: Ask questions
- Headlamp: headlamp.dev
- Sealed Secrets: bitnami-labs/sealed-secrets
📖 About This Documentation
This documentation is organized by user journey:
- Getting Started - For new users
- User Guide - For daily usage
- Tutorials - For specific workflows
- Troubleshooting - For problem-solving
- Development - For contributors
- API Reference - For developers using the plugin
- Architecture - For understanding the design
- Deployment - For production deployments
🤝 Contributing to Docs
Found an error or want to improve the documentation?
- Quick fixes: Edit on GitHub and submit a PR
- Larger changes: Open an issue first to discuss
- New tutorials: Share your use case in Discussions
See CONTRIBUTING.md for guidelines.
📝 Documentation Status
Completed ✅
- Installation guides
- Quick start tutorial
- Development workflow documentation
- Testing guides
- Architecture overview
In Progress 🚧
- User guide sections (creating secrets, managing keys, scopes)
- Tutorial content (CI/CD, multi-cluster, rotation)
- Troubleshooting guides
- API reference (auto-generated coming soon)
Planned 📅
- Video tutorials
- Interactive examples
- Detailed architecture diagrams
- More CI/CD platform examples
- Advanced use cases
🔄 Documentation Updates
This documentation is kept in sync with code changes:
- Version: Matches plugin version (currently v0.2.0)
- Auto-generated: API reference generated from TypeScript source
- CI Checks: Links validated on every pull request
- Examples Tested: Code examples validated against current API
Last updated: 2026-02-12