Hugh Hackman
39519788d6
- Update headlamp-static-plugin-values.yaml to 0.7.2 - Add headlamp service account to polaris-dashboard-proxy-reader RoleBinding - Update documentation references from headlamp-polaris-plugin to headlamp-polaris Co-Authored-By: Paperclip <noreply@paperclip.ing>
72 lines
3.0 KiB
Markdown
72 lines
3.0 KiB
Markdown
# Documentation
|
|
|
|
Central hub for Headlamp Polaris Plugin documentation.
|
|
|
|
## Quick Links
|
|
|
|
- [Quick Start](getting-started/quick-start.md)
|
|
- [Installation Guide](getting-started/installation.md)
|
|
- [Troubleshooting](troubleshooting/README.md)
|
|
- [Architecture](architecture/overview.md)
|
|
- [Development](development/workflow.md)
|
|
|
|
## Getting Started
|
|
|
|
New to the Headlamp Polaris Plugin? Start here:
|
|
|
|
- **[Prerequisites](getting-started/prerequisites.md)** - System requirements, Headlamp version, Polaris installation
|
|
- **[Installation](getting-started/installation.md)** - Four installation methods: Plugin Manager, Sidecar, Manual, Source
|
|
- **[Quick Start](getting-started/quick-start.md)** - Get up and running in 5 minutes
|
|
|
|
## User Guide
|
|
|
|
Learn how to use the plugin:
|
|
|
|
- **[Features](user-guide/features.md)** - Overview dashboard, namespace views, inline audits, exemption management
|
|
- **[Configuration](user-guide/configuration.md)** - Refresh intervals, dashboard URLs, settings
|
|
- **[RBAC Permissions](user-guide/rbac-permissions.md)** - Required permissions, service proxy access, token-auth mode
|
|
|
|
## Troubleshooting
|
|
|
|
Having issues? Check here:
|
|
|
|
- **[Quick Diagnosis](troubleshooting/README.md)** - Quick reference table for common symptoms
|
|
- **[Common Issues](troubleshooting/common-issues.md)** - Detailed resolution steps for frequent problems
|
|
- **[RBAC Issues](troubleshooting/rbac-issues.md)** - Permission debugging, 403 errors, token-auth
|
|
- **[Network Problems](troubleshooting/network-problems.md)** - NetworkPolicies, connectivity, proxy issues
|
|
|
|
## Architecture
|
|
|
|
Understand how the plugin works:
|
|
|
|
- **[Overview](architecture/overview.md)** - High-level architecture, component hierarchy
|
|
- **[Data Flow](architecture/data-flow.md)** - How data moves from Polaris to the UI
|
|
- **[Design Decisions](architecture/design-decisions.md)** - Key architectural choices and rationale
|
|
- **[ADRs](architecture/adr/README.md)** - Architecture Decision Records
|
|
|
|
## Development
|
|
|
|
Contributing to the plugin:
|
|
|
|
- **[Development Workflow](development/workflow.md)** - Setup, building, hot reload
|
|
- **[Testing](development/testing.md)** - Unit tests, E2E tests, CI/CD
|
|
- **[Code Style](development/code-style.md)** - TypeScript, React, linting, formatting
|
|
- **[Release Process](development/release-process.md)** - Versioning, changelog, GitHub Actions
|
|
|
|
## Deployment
|
|
|
|
Production deployment guides:
|
|
|
|
- **[Kubernetes](deployment/kubernetes.md)** - Direct Kubernetes manifest deployment
|
|
- **[Helm](deployment/helm.md)** - Helm chart configuration, values
|
|
- **[Production Checklist](deployment/production.md)** - RBAC, NetworkPolicies, security, monitoring
|
|
|
|
## API Reference
|
|
|
|
- **[polaris.ts](../src/api/polaris.ts)** - JSDoc-annotated TypeScript API (data fetching, types, utilities)
|
|
- **[PolarisDataContext.tsx](../src/api/PolarisDataContext.tsx)** - React Context provider for shared data
|
|
|
|
---
|
|
|
|
**Need help?** Open an issue on [GitHub](https://github.com/privilegedescalation/headlamp-polaris/issues) or check [CONTRIBUTING.md](../CONTRIBUTING.md) for development guidelines.
|