-
Notifications
You must be signed in to change notification settings - Fork 718
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
make forward-port longhorn 103.3.0+up1.6.1
- Loading branch information
Showing
39 changed files
with
3,289 additions
and
0 deletions.
There are no files selected for viewing
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
# Patterns to ignore when building packages. | ||
# This supports shell glob matching, relative path matching, and | ||
# negation (prefixed with !). Only one pattern per line. | ||
.DS_Store | ||
# Common VCS dirs | ||
.git/ | ||
.gitignore | ||
.bzr/ | ||
.bzrignore | ||
.hg/ | ||
.hgignore | ||
.svn/ | ||
# Common backup files | ||
*.swp | ||
*.bak | ||
*.tmp | ||
*~ | ||
# Various IDEs | ||
.project | ||
.idea/ | ||
*.tmproj |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
annotations: | ||
catalog.cattle.io/auto-install: longhorn-crd=match | ||
catalog.cattle.io/certified: rancher | ||
catalog.cattle.io/display-name: Longhorn | ||
catalog.cattle.io/kube-version: '>= 1.21.0-0' | ||
catalog.cattle.io/namespace: longhorn-system | ||
catalog.cattle.io/permits-os: linux,windows | ||
catalog.cattle.io/provides-gvr: longhorn.io/v1beta1 | ||
catalog.cattle.io/rancher-version: '>= 2.8.0-0 < 2.9.0-0' | ||
catalog.cattle.io/release-name: longhorn | ||
catalog.cattle.io/type: cluster-tool | ||
catalog.cattle.io/upstream-version: 1.6.1 | ||
apiVersion: v1 | ||
appVersion: v1.6.1 | ||
description: Longhorn is a distributed block storage system for Kubernetes. | ||
home: https://github.com/longhorn/longhorn | ||
icon: https://raw.githubusercontent.com/cncf/artwork/master/projects/longhorn/icon/color/longhorn-icon-color.png | ||
keywords: | ||
- longhorn | ||
- storage | ||
- distributed | ||
- block | ||
- device | ||
- iscsi | ||
- nfs | ||
kubeVersion: '>=1.21.0-0' | ||
maintainers: | ||
- email: maintainers@longhorn.io | ||
name: Longhorn maintainers | ||
name: longhorn | ||
sources: | ||
- https://github.com/longhorn/longhorn | ||
- https://github.com/longhorn/longhorn-engine | ||
- https://github.com/longhorn/longhorn-instance-manager | ||
- https://github.com/longhorn/longhorn-share-manager | ||
- https://github.com/longhorn/longhorn-manager | ||
- https://github.com/longhorn/longhorn-ui | ||
- https://github.com/longhorn/longhorn-tests | ||
- https://github.com/longhorn/backing-image-manager | ||
version: 103.3.0+up1.6.1 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
# Longhorn Chart | ||
|
||
> **Important**: Please install the Longhorn chart in the `longhorn-system` namespace only. | ||
> **Warning**: Longhorn doesn't support downgrading from a higher version to a lower version. | ||
> **Note**: Use Helm 3 when installing and upgrading Longhorn. Helm 2 is [no longer supported](https://helm.sh/blog/helm-2-becomes-unsupported/). | ||
## Source Code | ||
|
||
Longhorn is 100% open source software. Project source code is spread across a number of repos: | ||
|
||
1. Longhorn Engine -- Core controller/replica logic https://github.com/longhorn/longhorn-engine | ||
2. Longhorn Instance Manager -- Controller/replica instance lifecycle management https://github.com/longhorn/longhorn-instance-manager | ||
3. Longhorn Share Manager -- NFS provisioner that exposes Longhorn volumes as ReadWriteMany volumes. https://github.com/longhorn/longhorn-share-manager | ||
4. Backing Image Manager -- Backing image file lifecycle management. https://github.com/longhorn/backing-image-manager | ||
5. Longhorn Manager -- Longhorn orchestration, includes CSI driver for Kubernetes https://github.com/longhorn/longhorn-manager | ||
6. Longhorn UI -- Dashboard https://github.com/longhorn/longhorn-ui | ||
|
||
## Prerequisites | ||
|
||
1. A container runtime compatible with Kubernetes (Docker v1.13+, containerd v1.3.7+, etc.) | ||
2. Kubernetes >= v1.21 | ||
3. Make sure `bash`, `curl`, `findmnt`, `grep`, `awk` and `blkid` has been installed in all nodes of the Kubernetes cluster. | ||
4. Make sure `open-iscsi` has been installed, and the `iscsid` daemon is running on all nodes of the Kubernetes cluster. For GKE, recommended Ubuntu as guest OS image since it contains `open-iscsi` already. | ||
|
||
## Upgrading to Kubernetes v1.25+ | ||
|
||
Starting in Kubernetes v1.25, [Pod Security Policies](https://kubernetes.io/docs/concepts/security/pod-security-policy/) have been removed from the Kubernetes API. | ||
|
||
As a result, **before upgrading to Kubernetes v1.25** (or on a fresh install in a Kubernetes v1.25+ cluster), users are expected to perform an in-place upgrade of this chart with `enablePSP` set to `false` if it has been previously set to `true`. | ||
|
||
> **Note:** | ||
> If you upgrade your cluster to Kubernetes v1.25+ before removing PSPs via a `helm upgrade` (even if you manually clean up resources), **it will leave the Helm release in a broken state within the cluster such that further Helm operations will not work (`helm uninstall`, `helm upgrade`, etc.).** | ||
> | ||
> If your charts get stuck in this state, you may have to clean up your Helm release secrets. | ||
Upon setting `enablePSP` to false, the chart will remove any PSP resources deployed on its behalf from the cluster. This is the default setting for this chart. | ||
|
||
As a replacement for PSPs, [Pod Security Admission](https://kubernetes.io/docs/concepts/security/pod-security-admission/) should be used. Please consult the Longhorn docs for more details on how to configure your chart release namespaces to work with the new Pod Security Admission and apply Pod Security Standards. | ||
|
||
## Uninstallation | ||
|
||
To prevent Longhorn from being accidentally uninstalled (which leads to data lost), we introduce a new setting, deleting-confirmation-flag. If this flag is **false**, the Longhorn uninstallation job will fail. Set this flag to **true** to allow Longhorn uninstallation. You can set this flag using setting page in Longhorn UI or `kubectl -n longhorn-system patch -p '{"value": "true"}' --type=merge lhs deleting-confirmation-flag` | ||
|
||
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 Cluster Explorer UI, navigate to Apps page, delete app `longhorn` then app `longhorn-crd` in Installed Apps tab. | ||
|
||
--- | ||
Please see [link](https://github.com/longhorn/longhorn) for more information. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
# Longhorn | ||
|
||
Longhorn is a lightweight, reliable and easy to use distributed block storage system for Kubernetes. Once deployed, users can leverage persistent volumes provided by Longhorn. | ||
|
||
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. Longhorn supports snapshots, backups and even allows you to schedule recurring snapshots and backups! | ||
|
||
**Important**: Please install Longhorn chart in `longhorn-system` namespace only. | ||
|
||
**Warning**: Longhorn doesn't support downgrading from a higher version to a lower version. | ||
|
||
[Chart Documentation](https://github.com/longhorn/longhorn/blob/master/chart/README.md) | ||
|
||
|
||
## Upgrading to Kubernetes v1.25+ | ||
|
||
Starting in Kubernetes v1.25, [Pod Security Policies](https://kubernetes.io/docs/concepts/security/pod-security-policy/) have been removed from the Kubernetes API. | ||
|
||
As a result, **before upgrading to Kubernetes v1.25** (or on a fresh install in a Kubernetes v1.25+ cluster), users are expected to perform an in-place upgrade of this chart with `enablePSP` set to `false` if it has been previously set to `true`. | ||
|
||
> **Note:** | ||
> If you upgrade your cluster to Kubernetes v1.25+ before removing PSPs via a `helm upgrade` (even if you manually clean up resources), **it will leave the Helm release in a broken state within the cluster such that further Helm operations will not work (`helm uninstall`, `helm upgrade`, etc.).** | ||
> | ||
> If your charts get stuck in this state, please consult the Rancher docs on how to clean up your Helm release secrets. | ||
Upon setting `enablePSP` to false, the chart will remove any PSP resources deployed on its behalf from the cluster. This is the default setting for this chart. | ||
|
||
As a replacement for PSPs, [Pod Security Admission](https://kubernetes.io/docs/concepts/security/pod-security-admission/) should be used. Please consult the Rancher docs for more details on how to configure your chart release namespaces to work with the new Pod Security Admission and apply Pod Security Standards. |
Oops, something went wrong.