{"id":37584012,"url":"https://github.com/pmdevers/k8s-frontman","last_synced_at":"2026-02-18T02:08:24.981Z","repository":{"id":332516684,"uuid":"1131020905","full_name":"pmdevers/k8s-frontman","owner":"pmdevers","description":"A Kubernetes operator for hosting and managing versioned static content with support for multiple storage providers (Azure Blob, File System). Built with .NET 10.0 and C# 14.","archived":false,"fork":false,"pushed_at":"2026-02-13T13:57:22.000Z","size":2687,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-13T22:47:04.564Z","etag":null,"topics":["asp-net-core","azure-blob-storage","cloud-native","containerization","content-management","csharp","docker","dotnet","k8s","kubernetes","kubernetes-operator","operator-framework","static-content","versioning","webserver"],"latest_commit_sha":null,"homepage":"https://pmdevers.github.io/k8s-frontman/","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pmdevers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"2026-01-09T10:59:39.000Z","updated_at":"2026-02-13T14:00:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pmdevers/k8s-frontman","commit_stats":null,"previous_names":["pmdevers/k8s-frontman"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/pmdevers/k8s-frontman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmdevers%2Fk8s-frontman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmdevers%2Fk8s-frontman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmdevers%2Fk8s-frontman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmdevers%2Fk8s-frontman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pmdevers","download_url":"https://codeload.github.com/pmdevers/k8s-frontman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmdevers%2Fk8s-frontman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29566366,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T00:47:08.760Z","status":"online","status_checked_at":"2026-02-18T02:00:09.468Z","response_time":162,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["asp-net-core","azure-blob-storage","cloud-native","containerization","content-management","csharp","docker","dotnet","k8s","kubernetes","kubernetes-operator","operator-framework","static-content","versioning","webserver"],"created_at":"2026-01-16T09:44:39.669Z","updated_at":"2026-02-18T02:08:24.977Z","avatar_url":"https://github.com/pmdevers.png","language":"C#","readme":"# k8s-frontman\n\nManager for hosting versioned static content within Kubernetes\n\n![License](https://img.shields.io/github/license/pmdevers/k8s-frontman)\n![Release](https://img.shields.io/github/v/release/pmdevers/k8s-frontman)\n\n![Alt text](https://github.com/pmdevers/k8s-frontman/raw/main/assets/logo_256.png \"k8s-frontman logo\")\n\n## Overview\n\nk8s-frontman is a Kubernetes operator that simplifies the deployment and management of versioned static content. It provides a declarative approach to hosting and serving static files from multiple sources, with built-in support for various storage providers.\n\n## Features\n\n- 🚀 **Kubernetes Native** - Deploy as a native Kubernetes operator\n- 📦 **Multiple Storage Providers** - Support for Azure Blob Storage, File System, and more\n- 🔄 **Version Management** - Manage multiple versions of your static content\n- 🎯 **Declarative Configuration** - Define your content using Kubernetes Custom Resources\n- ⚡ **High Performance** - Built-in response caching and compression\n- 🐳 **Container Ready** - Available as a Docker image on GitHub Container Registry\n\n## Quick Start\n\n### Prerequisites\n\n- Kubernetes cluster (v1.20+)\n- kubectl configured to communicate with your cluster\n\n### Installation\n\n**Using kubectl:**\n```bash\nkubectl apply -f https://github.com/pmdevers/k8s-frontman/releases/latest/download/install.yaml\n```\n\n**Using Helm (if available):**\n```bash\nhelm repo add k8s-frontman https://pmdevers.github.io/k8s-frontman\nhelm install k8s-frontman k8s-frontman/k8s-frontman\n```\n\n### CLI Installation\n\nFor local development and management, install the k8s-frontman CLI:\n\n**Linux/macOS:**\n```bash\ncurl -s https://raw.githubusercontent.com/pmdevers/k8s-frontman/main/install/setup.sh | sudo bash\n```\n\n**Windows (PowerShell):**\n```powershell\niwr -useb https://raw.githubusercontent.com/pmdevers/k8s-frontman/main/install/setup.ps1 | iex\n```\n\nFor detailed installation options, see the [install README](install/README.md).\n\n## Usage\n\n### Defining a Provider\n\nCreate a provider to specify where your static content is stored:\n\n```yaml\napiVersion: frontman.k8s.io/v1\nkind: Provider\nmetadata:\n  name: my-static-content\nspec:\n  type: azureBlob\n  azureBlob:\n    connectionString: \u003cyour-connection-string\u003e\n    containerName: static-files\n```\n\n### Creating a Release\n\nCreate a release to serve specific versions of your content:\n\n```yaml\napiVersion: frontman.k8s.io/v1\nkind: Release\nmetadata:\n  name: my-app-v1\nspec:\n  provider: my-static-content\n  version: \"1.0.0\"\n  path: /app\n```\n\n### Accessing Your Content\n\nOnce deployed, your static content will be available at the configured path through the k8s-frontman service.\n\n## Configuration\n\nConfiguration is done through Kubernetes Custom Resources. For detailed configuration options, see the [documentation](docs/introduction.md).\n\n### Supported Providers\n\n- **Azure Blob Storage** - Store content in Azure Blob Storage\n- **File System** - Use local file system storage\n- More providers coming soon!\n\n## Development\n\n### Building from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/pmdevers/k8s-frontman.git\ncd k8s-frontman\n\n# Build the project\ndotnet build\n\n# Run locally\ndotnet run --project src/k8sFrontman\n```\n\n### Running Tests\n\n```bash\ndotnet test\n```\n\n## Documentation\n\nFor more information, see:\n\n- [Getting Started Guide](docs/getting-started.md)\n- [Introduction](docs/introduction.md)\n- [Installation Guide](install/README.md)\n\n## Contributing\n\nContributions are welcome! Please see our [Code of Conduct](CODE_OF_CONDUCT.md) for details.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\nBuilt with:\n- [.NET 10.0](https://dotnet.microsoft.com/)\n- [k8sOperator](https://github.com/pmdevers/k8sOperator) - Kubernetes Operator framework for .NET\n\n---\n\nMade with ❤️ by [Patrick Evers](https://github.com/pmdevers)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpmdevers%2Fk8s-frontman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpmdevers%2Fk8s-frontman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpmdevers%2Fk8s-frontman/lists"}