Install with Kubectl

Install Longhorn with the kubectl client.

Prerequisites

Each node in the Kubernetes cluster where Longhorn will be installed must fulfill these requirements.

This script can be used to check the Longhorn environment for potential issues.

The initial settings for Longhorn can be customized by editing the deployment configuration file.

Installing Longhorn

  1. Install Longhorn on any Kubernetes cluster using this command:

    1. kubectl apply -f https://raw.githubusercontent.com/longhorn/longhorn/v1.7.2/deploy/longhorn.yaml

    One way to monitor the progress of the installation is to watch pods being created in the longhorn-system namespace:

    1. kubectl get pods \
    2. --namespace longhorn-system \
    3. --watch

  2. Check that the deployment was successful:

    1. $ kubectl -n longhorn-system get pod
    2. NAME                                                READY   STATUS    RESTARTS   AGE
    3. longhorn-ui-b7c844b49-w25g5                         1/1     Running   0          2m41s
    4. longhorn-manager-pzgsp                              1/1     Running   0          2m41s
    5. longhorn-driver-deployer-6bd59c9f76-lqczw           1/1     Running   0          2m41s
    6. longhorn-csi-plugin-mbwqz                           2/2     Running   0          100s
    7. csi-snapshotter-588457fcdf-22bqp                    1/1     Running   0          100s
    8. csi-snapshotter-588457fcdf-2wd6g                    1/1     Running   0          100s
    9. csi-provisioner-869bdc4b79-mzrwf                    1/1     Running   0          101s
    10. csi-provisioner-869bdc4b79-klgfm                    1/1     Running   0          101s
    11. csi-resizer-6d8cf5f99f-fd2ck                        1/1     Running   0          101s
    12. csi-provisioner-869bdc4b79-j46rx                    1/1     Running   0          101s
    13. csi-snapshotter-588457fcdf-bvjdt                    1/1     Running   0          100s
    14. csi-resizer-6d8cf5f99f-68cw7                        1/1     Running   0          101s
    15. csi-attacher-7bf4b7f996-df8v6                       1/1     Running   0          101s
    16. csi-attacher-7bf4b7f996-g9cwc                       1/1     Running   0          101s
    17. csi-attacher-7bf4b7f996-8l9sw                       1/1     Running   0          101s
    18. csi-resizer-6d8cf5f99f-smdjw                        1/1     Running   0          101s
    19. instance-manager-b34d5db1fe1e2d52bcfb308be3166cfc   1/1     Running   0          114s
    20. engine-image-ei-df38d2e5-cv6nc                      1/1     Running   0          114s

  3. To enable access to the Longhorn UI, you will need to set up an Ingress controller. Authentication to the Longhorn UI is not enabled by default. For information on creating an NGINX Ingress controller with basic authentication, refer to this section.

  4. Access the Longhorn UI using these steps.

Note: For Kubernetes < v1.25, if your cluster still enables Pod Security Policy admission controller, need to apply the podsecuritypolicy.yaml manifest in addition to applying the longhorn.yaml manifests.

List of Deployed Resources

The following items will be deployed to Kubernetes:

Namespace: longhorn-system

All Longhorn bits will be scoped to this namespace.

ServiceAccount: longhorn-service-account

Service account is created in the longhorn-system namespace.

ClusterRole: longhorn-role

This role will have access to:

  • In apiextension.k8s.io (All verbs)
    • customresourcedefinitions
  • In core (All verbs)
    • pods
      • /logs
    • events
    • persistentVolumes
    • persistentVolumeClaims
      • /status
    • nodes
    • proxy/nodes
    • secrets
    • services
    • endpoints
    • configMaps
  • In core
    • namespaces (get, list)
  • In apps (All Verbs)
    • daemonsets
    • statefulSets
    • deployments
  • In batch (All Verbs)
    • jobs
    • cronjobs
  • In storage.k8s.io (All verbs)
    • storageclasses
    • volumeattachments
    • csinodes
    • csidrivers
  • In coordination.k8s.io
    • leases

ClusterRoleBinding: longhorn-bind

This connects the longhorn-role to the longhorn-service-account in the longhorn-system namespace

CustomResourceDefinitions

The following CustomResourceDefinitions will be installed

  • In longhorn.io
    • backingimagedatasources
    • backingimagemanagers
    • backingimages
    • backups
    • backuptargets
    • backupvolumes
    • engineimages
    • engines
    • instancemanagers
    • nodes
    • recurringjobs
    • replicas
    • settings
    • sharemanagers
    • volumes

Kubernetes API Objects

  • A config map with the default settings
  • The longhorn-manager DaemonSet
  • The longhorn-backend service exposing the longhorn-manager DaemonSet internally to Kubernetes
  • The longhorn-ui Deployment
  • The longhorn-frontend service exposing the longhorn-ui internally to Kubernetes
  • The longhorn-driver-deployer that deploys the CSI driver
  • The longhorn StorageClass