How-to

In this section, it will introduce how to declare Helm charts as components via ComponentDefinition.

Before reading this part, please make sure you've learned the definition and template concepts.

Prerequisite

• Make sure you have enabled Helm support in the installation guide.

Declare ComponentDefinition

Here is an example ComponentDefinition about how to use Helm as schematic module.

apiVersion: core.oam.dev/v1beta1

kind: ComponentDefinition

metadata:

name: webapp-chart

annotations:

definition.oam.dev/description: helm chart for webapp

spec:

workload:

definition:

apiVersion: apps/v1

kind: Deployment

schematic:

helm:

release:

chart:

spec:

chart: "podinfo"

version: "5.1.4"

repository:

url: "http://oam.dev/catalog/"

In detail:

• .spec.workload is required to indicate the workload type of this Helm based component. Please also check for known limitations if you have multiple workloads packaged in one chart.
• .spec.schematic.helm contains information of Helm release and repository which leverages fluxcd/flux2.
  • i.e. the spec of release aligns with HelmReleaseSpec and spec of repository aligns with HelmRepositorySpec.

Declare an Application

Here is an example Application.

apiVersion: core.oam.dev/v1beta1

kind: Application

metadata:

name: myapp

namespace: default

spec:

components:

- name: demo-podinfo

type: webapp-chart

properties:

image:

tag: "5.1.2"

The component properties is exactly the overlay values of the Helm chart.

Deploy the application and after several minutes (it may take time to fetch Helm chart), you can check the Helm release is installed.

$ helm ls -A

myapp-demo-podinfo default 1 2021-03-05 02:02:18.692317102 +0000 UTC deployed podinfo-5.1.4 5.1.4

Check the workload defined in the chart has been created successfully.

$ kubectl get deploy

NAME READY UP-TO-DATE AVAILABLE AGE

myapp-demo-podinfo 1/1 1 1 66m

Check the values (image.tag = 5.1.2) from application's properties are assigned to the chart.

$ kubectl get deployment myapp-demo-podinfo -o json | jq '.spec.template.spec.containers[0].image'

"ghcr.io/stefanprodan/podinfo:5.1.2"