website-and-documentation/content/en/docs/components/_index.md
Stephan Lo 82d424aeca fix(docs): remove Backstage component and add editorial headers
- 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
2025-11-16 13:42:58 +01:00

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:

  1. Overview: Brief description and purpose
  2. Key Features: Main capabilities and use cases
  3. Architecture: How it fits into EDP
  4. Getting Started: Quick start guide
  5. Usage Examples: Common scenarios and patterns
  6. Repository: Link to source code and additional resources
  7. Integration: Connection points with other components
  8. Status: Current maturity level