How to Upgrade the AI Foundry chart

To upgrade the ai-foundry chart, update the chart version and run helm upgrade.

tip

The chart follows semver: breaking changes are introduced only in major version bumps. Minor releases add new optional configuration; patch releases contain only fixes. Always review the changelog before upgrading across a major boundary.

Direct chart upgrade

If you installed the chart directly:

helm repo update

helm upgrade ai-foundry mia-platform/ai-foundry \
  --namespace ai-foundry \
  --values values.yaml \
  --atomic \
  --timeout 5m

Upgrade via the ai-foundry-deployment wrapper

If you use the ai-foundry-deployment wrapper repository, update the pinned chart version in Chart.yaml:

dependencies:
  - name: ai-foundry
    alias: aiFoundry
    version: "~0.X"   # ← bump to the new target version constraint
    repository: "https://nexus.mia-platform.eu/repository/helm-internal/"

Then update and deploy:

helm dependency update

helm upgrade ai-foundry . \
  --namespace ai-foundry \
  --values values/<env>.yaml \
  --atomic \
  --timeout 5m

Version-specific upgrade notes

From 0.4.79 to 0.4.83-0 (Mia-Platform v15.0.1 to v15.1.0)

No manual action required: install the new chart version.

Also note:

• The new optional namespacePrefix value (default empty) adds a <namespacePrefix>- prefix to the names of all the resources the chart creates, including the image pull Secret and the TLS Secret set in ingressRoute.tls.secretName. Secrets that you create yourself must then use the prefixed names. Setting it on an existing installation renames its resources.
• The name of the Traefik IngressRoute can be set with ingressRoute.name. The default is default-ingress, the previous name.
• aiFoundryWebsite.config.oauth.scopes sets the OAuth scopes shown in the git-credential-oauth setup snippet of the AI Foundry website. When it is not set, the chart uses openid offline_access with isPaaS: false.