mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-05-06 05:03:27 +00:00
Billy Tat
6eb75c1d21
'Apps' applies to Rancher v2.6.5+ 'Apps & Marketplace' applies to v2.6.0-v2.6.4 Ref: https://github.com/rancher/dashboard/pull/5489
102 lines
4.5 KiB
Markdown
102 lines
4.5 KiB
Markdown
---
|
|
title: Longhorn - Cloud native distributed block storage for Kubernetes
|
|
---
|
|
|
|
[Longhorn](https://longhorn.io/) is a lightweight, reliable, and easy-to-use distributed block storage system for Kubernetes.
|
|
|
|
Longhorn is free, open source software. Originally developed by Rancher Labs, it is now being developed as a sandbox project of the Cloud Native Computing Foundation. It can be installed on any Kubernetes cluster with Helm, with kubectl, or with the Rancher UI. You can learn more about its architecture [here.](https://longhorn.io/docs/latest/concepts/)
|
|
|
|
With Longhorn, you can:
|
|
|
|
- Use Longhorn volumes as persistent storage for the distributed stateful applications in your Kubernetes cluster
|
|
- Partition your block storage into Longhorn volumes so that you can use Kubernetes volumes with or without a cloud provider
|
|
- Replicate block storage across multiple nodes and data centers to increase availability
|
|
- Store backup data in external storage such as NFS or AWS S3
|
|
- Create cross-cluster disaster recovery volumes so that data from a primary Kubernetes cluster can be quickly recovered from backup in a second Kubernetes cluster
|
|
- Schedule recurring snapshots of a volume, and schedule recurring backups to NFS or S3-compatible secondary storage
|
|
- Restore volumes from backup
|
|
- Upgrade Longhorn without disrupting persistent volumes
|
|
|
|
<figcaption>Longhorn Dashboard</figcaption>
|
|
|
|
|
|
|
|
### Installing Longhorn with Rancher
|
|
|
|
<Tabs groupId="rancher-version">
|
|
<TabItem value="Rancher v2.6.5+">
|
|
|
|
1. Fulfill all [Installation Requirements.](https://longhorn.io/docs/latest/deploy/install/#installation-requirements)
|
|
1. Go to the cluster where you want to install Longhorn.
|
|
1. Click **Apps**.
|
|
1. Click **Charts**.
|
|
1. Click **Longhorn**.
|
|
1. Optional: To customize the initial settings, click **Longhorn Default Settings** and edit the configuration. For help customizing the settings, refer to the [Longhorn documentation.](https://longhorn.io/docs/latest/references/settings/)
|
|
1. Click **Install**.
|
|
|
|
</TabItem>
|
|
<TabItem value="Rancher before v2.6.5">
|
|
|
|
1. Fulfill all [Installation Requirements.](https://longhorn.io/docs/latest/deploy/install/#installation-requirements)
|
|
1. Go to the cluster where you want to install Longhorn.
|
|
1. Click **Apps & Marketplace**.
|
|
1. Click **Charts**.
|
|
1. Click **Longhorn**.
|
|
1. Optional: To customize the initial settings, click **Longhorn Default Settings** and edit the configuration. For help customizing the settings, refer to the [Longhorn documentation.](https://longhorn.io/docs/latest/references/settings/)
|
|
1. Click **Install**.
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
**Result:** Longhorn is deployed in the Kubernetes cluster.
|
|
|
|
### Accessing Longhorn from the Rancher UI
|
|
|
|
1. Go to the cluster where Longhorn is installed. In the left navigation menu, click **Longhorn**.
|
|
1. On this page, you can edit Kubernetes resources managed by Longhorn. To view the Longhorn UI, click the **Longhorn** button in the **Overview** section.
|
|
|
|
**Result:** You will be taken to the Longhorn UI, where you can manage your Longhorn volumes and their replicas in the Kubernetes cluster, as well as secondary backups of your Longhorn storage that may exist in another Kubernetes cluster or in S3.
|
|
|
|
### Uninstalling Longhorn from the Rancher UI
|
|
|
|
<Tabs groupId="rancher-version">
|
|
<TabItem value="Rancher v2.6.5+">
|
|
|
|
1. Go to the cluster where Longhorn is installed and click **Apps**.
|
|
1. Click **Installed Apps**.
|
|
1. Go to the `longhorn-system` namespace and check the boxes next to the `longhorn` and `longhorn-crd` apps.
|
|
1. Click **Delete,** and confirm **Delete**.
|
|
|
|
</TabItem>
|
|
<TabItem value="Rancher before v2.6.5">
|
|
|
|
1. Go to the cluster where Longhorn is installed and click **Apps & Marketplace**.
|
|
1. Click **Installed Apps**.
|
|
1. Go to the `longhorn-system` namespace and check the boxes next to the `longhorn` and `longhorn-crd` apps.
|
|
1. Click **Delete,** and confirm **Delete**.
|
|
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
**Result:** Longhorn is uninstalled.
|
|
|
|
### GitHub Repository
|
|
|
|
The Longhorn project is available [here.](https://github.com/longhorn/longhorn)
|
|
|
|
### Documentation
|
|
|
|
The Longhorn documentation is [here.](https://longhorn.io/docs/)
|
|
|
|
### Architecture
|
|
|
|
Longhorn creates a dedicated storage controller for each volume and synchronously replicates the volume across multiple replicas stored on multiple nodes.
|
|
|
|
The storage controller and replicas are themselves orchestrated using Kubernetes.
|
|
|
|
You can learn more about its architecture [here.](https://longhorn.io/docs/latest/concepts/)
|
|
|
|
<figcaption>Longhorn Architecture</figcaption>
|
|
|
|
|