Workleap generic Helm charts

This repository contains generic Helm charts available through GitHub Pages.

Generic Helm chart for ASP.NET Core

By default, this chart bootstraps the official ASP.NET Core sample application.

Please read the documented charts/aspnetcore/values.yaml file to understand how to override default values in order to deploy your own ASP.NET Core application.

Values Schema

The chart includes a JSON schema file charts/aspnetcore/values.schema.json that defines the structure and validation rules for the values. This schema provides:

• Type validation for configuration values
• Default values documentation
• Property descriptions
• Enum constraints where applicable

Important: When making changes to the values definition in values.yaml, ensure that the corresponding values.schema.json file is updated to maintain consistency and proper validation.

Installing the chart

The recommended way is to add this chart as a dependency of your chart:

apiVersion: v2
name: your-chart
description: Your chart description
version: 1.0.0
dependencies:
  - name: aspnetcore
    alias: aspnetcore
    version: 3.1.0
    repository: https://workleap.github.io/gsoft-helm-charts

Then, in your values.yaml file, override the default values:

aspnetcore:
  image:
    registry: your-registry.com
    repository: your-repository

# [...]

Finally, deploy your chart using the --dependency-update flag:

helm upgrade --install --atomic --cleanup-on-fail --debug --dependency-update [...more options] ./your-chart/

Release and versioning process

• Commit your changes on a new branch.
• In the same branch, manually bump the version property in charts/<affected-chartname>/Chart.yaml by following SemVer guidelines.
• Create a pull request and go through the review process.
• When the pull request is merged back in the main branch, the following workflows are automatically triggered:
  1. Release charts: packages the updated chart, creates a GitHub release and updates the public Helm index.yaml repository file. This has no effect if no chart version was changed.
  2. Deploy pages: deploy the latest index.yaml file to GitHub Pages.

License

Copyright © 2025, Workleap Technologies. This code is licensed under the Apache License, Version 2.0.