Kubernetes

The kubernetes field is used to specify the kubernetes provider and version. This field is optional and not specifying it will result in blueprint defaulting to the existing provider.

There are currently two kubernetes providers that are officially supported by blueprint: kind and k0s.

An existing provider can also be used to specify an unsupported kubernetes provider. Using this provider will install blueprint and the specified addons on an existing kubernetes cluster but no cluster management will be possible. If a kubeconfig is not specified, blueprint will fail to find the existing cluster.

Using an unsupported kubernetes provider expects that the underlying cluster is being managed outside of blueprint.

k0s

Specifying a k0s will create a k0s cluster, install the blueprint operator, and install the specified components. The following is an example of how to specify a k0s cluster:

spec:
  kubernetes:
    provider: k0s
    version: 1.28.5+k0s.0
    infra:
      hosts:
        - ssh:
            address: 10.0.0.1
            keyPath: ""
            port: 22
            user: root
          role: controller
        - ssh:
            address: 10.0.0.2
            keyPath: ""
            port: 22
            user: root
          role: worker
    config: ...

kind

Specifying a kind provider will create a kind cluster, install the blueprint operator, and install the specified components. The following is an example of how to specify a kind cluster:

apiVersion: blueprint.mirantis.com/v1alpha1
kind: Blueprint
metadata:
  name: blueprint-cluster
spec:
  kubernetes:
    provider: kind
    config: ...

existing

Using an unsupported kubernetes provider expects that the underlying cluster is being managed outside of blueprint.

Specifying an existing provider will install blueprint and the specified addons on an existing kubernetes cluster. This is the default value that will be used if no kubernetes section is provided in the blueprint. The following is an example of how to specify an existing cluster:

apiVersion: blueprint.mirantis.com/v1alpha1
kind: Blueprint
metadata:
  name: blueprint-cluster
spec:
  kubernetes:
    provider: existing
    kubeConfig: /home/user/.kube/config

Read more about kubeconfig precedence in the ../kubeconfig section.