- Remove Backstage component page (not in product structure) - Add editorial status alert to all draft pages with: * Jira ticket reference placeholder * Assignee field * Draft status indicator * Last updated date * TODO checklist for completion - Update component template with editorial header - Use Docsy alert shortcode (warning style) for professional appearance
2.6 KiB
| title | linkTitle | weight | description |
|---|---|---|---|
| Components | Components | 2 | Overview of EDP platform components and their integration. |
{{% alert title="Draft" color="warning" %}} Editorial Status: This page is currently being developed.
- Jira Ticket: TBD
- Assignee: Team
- Status: Draft - Overview and template created
- Last Updated: 2025-11-16
- TODO:
- Document each component based on product structure
- Add component maturity levels
- Include integration diagrams {{% /alert %}}
Component Overview
The Edge Developer Platform consists of multiple integrated components. Each component serves specific purposes in the overall platform architecture.
This section provides detailed documentation for each component, including:
- Description and purpose
- Key features and capabilities
- Repository links and resources
- Usage instructions and examples
- Integration points with other components
Core Components
Source Code Management
Forgejo: Self-hosted Git service with repository management, issue tracking, and collaboration features.
GitLab: Enterprise-grade Git repository management with CI/CD integration.
Container Orchestration
Kubernetes: Container orchestration platform for deploying and managing containerized applications.
CI/CD & Automation
Woodpecker: Lightweight CI/CD server with pipeline automation.
GARM: GitHub Actions-compatible runner manager for self-hosted environments.
ArgoCD: GitOps continuous delivery tool for Kubernetes.
Developer Portal
Backstage: Developer portal providing unified interface for platform services, documentation, and tooling.
Observability
VictoriaMetrics: Time-series database for metrics storage and querying.
Prometheus: Metrics collection and alerting.
Grafana: Visualization and dashboards for metrics and logs.
Infrastructure as Code
Terraform: Infrastructure provisioning and management.
Crossplane: Kubernetes-native infrastructure management.
Component Status
Each component page includes current status and maturity level. Check individual component documentation for detailed information.
Template for Component Documentation
When documenting a component, include:
- Overview: Brief description and purpose
- Key Features: Main capabilities and use cases
- Architecture: How it fits into EDP
- Getting Started: Quick start guide
- Usage Examples: Common scenarios and patterns
- Repository: Link to source code and additional resources
- Integration: Connection points with other components
- Status: Current maturity level