We changed the imagePullPolicy to IfNotPresent so that user can easily install Longhorn in air-gap instalation. Also add a bash script for the developer to quickly change all the imagePullPolicies back to Always so that k8s always pull the lastest images. This will be useful when dev use the tag such as master. Longhorn #1491 Signed-off-by: Phan Le <phan.le@rancher.com> |
||
---|---|---|
.. | ||
templates | ||
.helmignore | ||
app-readme.md | ||
Chart.yaml | ||
questions.yml | ||
README.md | ||
values.yaml |
Rancher Longhorn Chart
Important
: Please install Longhorn chart in
longhorn-system
namespace only.
Warning
: Longhorn doesn't support downgrading from a higher version to a lower version.
The following document pertains to running Longhorn from the Rancher 2.0 chart.
Source Code
Longhorn is 100% open source software. Project source code is spread across a number of repos:
- Longhorn Engine -- Core controller/replica logic https://github.com/longhorn/longhorn-engine
- Longhorn Instance Manager -- Controller/replica instance lifecycle management https://github.com/longhorn/longhorn-instance-manager
- Longhorn Manager -- Longhorn orchestration, includes CSI driver for Kubernetes https://github.com/longhorn/longhorn-manager
- Longhorn UI -- Dashboard https://github.com/longhorn/longhorn-ui
Prerequisites
- Rancher v2.1+
- Docker v1.13+
- Kubernetes v1.14+
- Make sure
curl
,findmnt
,grep
,awk
andblkid
has been installed in all nodes of the Kubernetes cluster. - Make sure
open-iscsi
has been installed in all nodes of the Kubernetes cluster. For GKE, recommended Ubuntu as guest OS image since it containsopen-iscsi
already.
Uninstallation
-
To prevent damage to the Kubernetes cluster, we recommend deleting all Kubernetes workloads using Longhorn volumes (PersistentVolume, PersistentVolumeClaim, StorageClass, Deployment, StatefulSet, DaemonSet, etc).
-
From Rancher UI, navigate to
Catalog Apps
tab and delete Longhorn app.
Troubleshooting
I deleted the Longhorn App from Rancher UI instead of following the uninstallation procedure
Redeploy the (same version) Longhorn App. Follow the uninstallation procedure above.
Problems with CRDs
If your CRD instances or the CRDs themselves can't be deleted for whatever reason, run the commands below to clean up. Caution: this will wipe all Longhorn state!
# Delete CRD instances and definitions
curl -s https://raw.githubusercontent.com/longhorn/longhorn/v0.8.1/scripts/cleanup.sh |bash -s v062
curl -s https://raw.githubusercontent.com/longhorn/longhorn/v0.8.1/scripts/cleanup.sh |bash -s v070
Please see link for more information.