timdeschryver / Sandbox

.NET and Angular Sandbox Some buzzwords that are used: • Aspire • .NET (Minimal) API • EF Core (with Migrations) • Angular • Redis with FusionCache (distributed hybrid caching with backplane synchronization) • OpenTelemetry • Grafana Stack (Tempo, Loki) • Prometheus (and Blackbox) • YARP • Containers • Azure Developer CLI (azd) • Authentication with Keycloak • Secrets OPerationS (SOPS) • Renovate for automatic dependency updates • Testing • Angular tests with Vitest • .NET unit tests with TUnit • .NET integration tests with Testcontainers • End-to-End Testing with Playwright Prerequisites • .NET 11 Preview 2 SDK (the repository is pinned to in ) • • Containerization tool (podman, docker, etc) > [!NOTE] > **Windows Long Path Support** > > Windows has a default path length limitation of 260 characters that may cause errors during Git operations with this repository (e.g., "Filename too long" errors). To enable long path support, run one of the following commands (see git config core.longpaths): > > **System-wide (requires Administrator privileges):** > > > > **User-level (no Administrator required):** > > Secret Management with SOPS The project uses SOPS (Secrets Operations) to encrypt sensitive configuration values: • **Encrypted Configuration**: files contain encrypted secrets • **Selective Encryption**: Only fields matching secret patterns (Secret, Password, Key, Token) are encrypted • **Development Friendly**: Non-sensitive configuration remains in plain text for easy reading SOPS Quick Start Run the project locally Clone the project and run the command in the root folder to start the project. If you want to build the full solution explicitly while the repo is on .NET 11 Preview 2, use: Result Aspire dashboard The Aspire dashboard provides a comprehensive view of all running services, their health status, and resource utilization in the development environment. Grafana Stack with OpenTelemetry data The monitoring stack uses Grafana to visualize OpenTelemetry data collected from all services, providing insights into application performance, logs, traces, and health metrics. Authentication using Keycloak Keycloak serves as the identity and access management solution, providing secure authentication and authorization for the application. OpenAPI Specification with Scalar Scalar provides an interactive API documentation interface generated from the OpenAPI specification, allowing developers to explore and test API endpoints. Additional Resources • github/awesome-copilot: A collection of custom instructions, agents, prompts, and skills for GitHub Copilot. Deploy to Azure To deploy the project, make sure you have an Azure subscription and installed. Then, run the following commands to provision the resources and deploy the project: