Longhorn

The role performs various tasks related to Helm chart deployment, reset and validation.

Role Settings

See the related role settings listed below, defined into main.yaml defaults file.

longhorn_vars.kubernetes

  • Default value: null

See the related child settings, listed below.

kubernetes.default_settings

  • Default value: null
default_settings.backup
  • Default value: null
backup.enabled
  • Default value: boolean, false
backup.secret
  • Default value: null
secret.name
  • Default value: string, longhorn-secret
backup.target
  • Default value: string, nfs://server:/mount
backup.user
  • Default value: null
user.name
  • Default value: string, user
user.password
  • Default value: string, password

Encrypt the variable with ansible-vault.

default_settings.data_locality
  • Default value: string, strict-local
default_settings.orphan_auto_deletion
  • Default value: boolean, true
default_settings.pod_deletion_policy
  • Default value: string, delete-both-statefulset-and-deployment-pod
default_settings.replica_auto_balance
  • Default value: string, best-effort
default_settings.replicas
  • Default value: integer, 3

Read the Inventory Configuration guide, for more details.

kubernetes.helm

  • Default value: null
helm.chart
  • Default value: null
chart.name
  • Default value: string, longhorn
chart.version
  • Default value: string

Visit longhorn/longhorn, for latest release version.

helm.repository
  • Default value: null
repository.name
  • Default value: string, longhorn
repository.org
  • Default value: string, longhorn
repository.url
  • Default value: string, https://charts.longhorn.io

kubernetes.gateway

  • Default value: null

Read the Gateway API tutorial, for more details.

gateway.service
  • Default value: string, longhorn-frontend
gateway.subdomain
  • Default value: string, longhorn

Sets the subdomain name for Longhorn UI.

kubernetes.infrastructure

  • Default value: null
infrastructure.annotations
  • Default value: map

Sets the infrastructure annotations.

kubernetes.namespace

  • Default value: string, kube-system

kubernetes.persistence

  • Default value: null
persistence.data_locality
  • Default value: string, best-effort
persistence.migratable
  • Default value: boolean, true
persistence.replicas
  • Default value: integer, 3

Read the Inventory Configuration guide, for more details.

Role Tasks

See the related role tasks, listed below.

Facts

Ansible facts, see facts.yaml for details.

Main

Main role related tasks, see main.yaml for details.

Reset

Reset related tasks, see reset.yaml for details.

Validation

Validation related tasks, see validation.yaml for details.

Role Templates

See the related role templates, listed below.

Helm Chart

Helm chart values template, see values.j2 for details.

Gateway

Kubernetes Gateway resource template, see gateway.j2 for details.

HTTP Route

Insecure Route

Kubernetes HTTPRoute resource template, see http_route.j2 for details.

Secure Route

Kubernetes HTTPRoute resource template, see https_route.j2 for details.

Load Balancer

Kubernetes Service resource template, see loadbalancer.j2 for details.