{"id":24033322,"url":"https://github.com/archetypicalsoftware/vdk-flux","last_synced_at":"2026-03-19T10:21:05.784Z","repository":{"id":259980283,"uuid":"783110067","full_name":"ArchetypicalSoftware/vdk-flux","owner":"ArchetypicalSoftware","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-09T02:20:13.000Z","size":240,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-09T08:22:29.859Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ArchetypicalSoftware.png","metadata":{"files":{"readme":"ReadMe.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-04-07T01:00:40.000Z","updated_at":"2026-02-09T02:20:17.000Z","dependencies_parsed_at":"2024-12-14T06:19:33.247Z","dependency_job_id":"b44e24d1-ecb7-4999-9143-93283fabe9e6","html_url":"https://github.com/ArchetypicalSoftware/vdk-flux","commit_stats":null,"previous_names":["archetypicalsoftware/vdk-flux"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ArchetypicalSoftware/vdk-flux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchetypicalSoftware%2Fvdk-flux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchetypicalSoftware%2Fvdk-flux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchetypicalSoftware%2Fvdk-flux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchetypicalSoftware%2Fvdk-flux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ArchetypicalSoftware","download_url":"https://codeload.github.com/ArchetypicalSoftware/vdk-flux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ArchetypicalSoftware%2Fvdk-flux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29965663,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T09:33:09.965Z","status":"ssl_error","status_checked_at":"2026-03-01T09:25:48.915Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-08T18:15:45.764Z","updated_at":"2026-03-19T10:21:05.766Z","avatar_url":"https://github.com/ArchetypicalSoftware.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# VDK Flux\n\nGitOps repository for the [Vega Development Kit (VDK)](https://github.com/ArchetypicalSoftware/VDK-Template) - a CLI tool that creates opinionated Kind clusters for local Kubernetes development.\n\n## Overview\n\nVDK Flux provides a complete local development environment with:\n\n- **Gateway API with KGateway**: Modern ingress using the Kubernetes Gateway API standard\n- **Aspire Dashboard**: Unified observability for traces, logs, and metrics\n- **OpenTelemetry**: Industry-standard telemetry collection and routing\n- **Prometheus + Grafana**: Metrics storage and visualization\n- **Cert Manager**: Automated TLS certificate management\n\n## Quick Start\n\n1. Install the [VDK CLI](https://github.com/ArchetypicalSoftware/VDK-Template)\n\n2. Create a cluster:\n   ```bash\n   vdk cluster create\n   ```\n\n3. Access the Aspire Dashboard:\n   ```\n   https://localhost:30443/observability\n   ```\n\n## Architecture\n\n```\n┌────────────────────────────────────────────────────────────────┐\n│                        Kind Cluster                            │\n│  ┌──────────────────────────────────────────────────────────┐ │\n│  │            Control Plane (ingress-ready=true)            │ │\n│  │                                                          │ │\n│  │   Port 30443 ────► Vega Gateway ────► Your Apps          │\n│  │        │                  │                               │\n│  │        │                  └────► /observability           │\n│  │        │                              │                   │\n│  │        │                              ▼                   │\n│  │        │                    Aspire Dashboard              │\n│  │        │                              ▲                   │\n│  │        │                              │                   │\n│  │   OTEL Collector ◄──── Your Apps ─────┘                   │\n│  │        │                                                  │\n│  │        └────► Prometheus ────► Grafana                    │\n│  └──────────────────────────────────────────────────────────┘ │\n└────────────────────────────────────────────────────────────────┘\n```\n\n## Components\n\n| Component | Version | Purpose |\n|-----------|---------|---------|\n| [Flux](https://fluxcd.io/) | v2.6.2 | GitOps automation |\n| [Gateway API](https://gateway-api.sigs.k8s.io/) | v1.4.0 | Kubernetes standard for ingress |\n| [KGateway](https://kgateway.dev/) | v2.0.5 | Envoy-based Gateway implementation |\n| [Aspire Dashboard](https://aspire.dev/) | 9.1 | Unified observability UI |\n| [OpenTelemetry](https://opentelemetry.io/) | v0.102.0 | Telemetry collection |\n| [Prometheus](https://prometheus.io/) | v81.2.0 | Metrics storage |\n| [Cert Manager](https://cert-manager.io/) | v1.19.2 | TLS management |\n\n## Documentation\n\n- [Getting Started](docs/getting-started.md) - Set up your development environment\n- [Architecture](docs/architecture.md) - Understand the system design\n- [Observability Guide](docs/observability.md) - Use the telemetry stack\n\n## Sending Telemetry\n\nConfigure your applications to send OpenTelemetry data:\n\n```yaml\nenv:\n  - name: OTEL_EXPORTER_OTLP_ENDPOINT\n    value: \"http://otel-collector.opentel.svc.cluster.local:4317\"\n  - name: OTEL_SERVICE_NAME\n    value: \"my-service\"\n```\n\n## Exposing Services\n\nCreate an HTTPRoute to expose your service:\n\n```yaml\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: my-app\n  namespace: my-namespace\nspec:\n  parentRefs:\n    - name: vega-gateway\n      namespace: vega-system\n  rules:\n    - backendRefs:\n        - name: my-service\n          port: 80\n```\n\n## Repository Structure\n\n```\nvdk-flux/\n├── base/                  # Flux Kustomization definitions\n├── clusters/default/      # Cluster configuration\n├── docs/                  # Documentation\n├── modules/               # Component manifests\n│   ├── aspire-dashboard/  # Aspire Dashboard + OTEL Collector\n│   ├── cert-manager/      # Certificate management\n│   ├── flux/              # Flux controllers\n│   ├── gateway-api/       # Gateway API CRDs\n│   ├── kgateway/          # KGateway Helm releases\n│   ├── opentel/           # OpenTelemetry Operator\n│   ├── prometheus/        # Prometheus + Grafana\n│   ├── vega-gateway/      # Main gateway configuration\n│   └── vega-system/       # VDK Operator\n├── CONTRIBUTING.md        # Contribution guidelines\n├── SECURITY.md            # Security policy\n└── README.md\n```\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## Security\n\nFor security concerns, please see [SECURITY.md](SECURITY.md).\n\n## License\n\nThis project is part of the Vega Development Kit ecosystem by [Archetypical Software](https://github.com/ArchetypicalSoftware).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farchetypicalsoftware%2Fvdk-flux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farchetypicalsoftware%2Fvdk-flux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farchetypicalsoftware%2Fvdk-flux/lists"}