Bundles Configuration and Troubleshooting

Cozystack bundles reference: composition, configuration, and troubleshooting.

This section provides practical guidance for working with Cozystack bundles. You’ll also find detailed reference pages for each bundle, outlining their structure, included components, and expected environment.

How to overwrite parameters for specific components

You might want to overwrite specific options for the components. To achieve this, you must specify values in JSON or YAML format using the values- option.

For example, if you want to overwrite k8sServiceHost and k8sServicePort for cilium, take a look at its values.yaml file.

Then specify these options in the values-cilium section of your Cozystack configuration, as shown below:

apiVersion: v1
kind: ConfigMap
metadata:
  name: cozystack
  namespace: cozy-system
data:
  bundle-name: "distro-full"
  ipv4-pod-cidr: "10.244.0.0/16"
  ipv4-svc-cidr: "10.96.0.0/16"
  values-cilium: |
    cilium:
      k8sServiceHost: 11.22.33.44
      k8sServicePort: 6443    

How to disable some components from bundle

Sometimes you may need to disable specific components within a bundle. To do this, use the bundle-disable option and provide a comma-separated list of the components you want to disable. For example:

apiVersion: v1
kind: ConfigMap
metadata:
  name: cozystack
  namespace: cozy-system
data:
  bundle-name: "paas-full"
  bundle-disable: "linstor,dashboard"
  ipv4-pod-cidr: "10.244.0.0/16"
  ipv4-svc-cidr: "10.96.0.0/16"

The paas-full bundle

PaaS platform, full stack version

The paas-hosted bundle

PaaS platform, hosted version

The distro-full bundle

Kubernetes distribution, full stack version

The distro-hosted bundle

Kubernetes distribution, hosted version