Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc(install): support helm-controller #1007

Merged
merged 1 commit into from
Nov 5, 2024

Conversation

james-munson
Copy link
Contributor

Which issue(s) this PR fixes:

Issue longhorn/longhorn#9506

What this PR does / why we need it:

Add documentation for install/upgrade/uninstall using HelmChart resource and helm-controller.

Special notes for your reviewer:

Additional documentation or context

@james-munson james-munson requested a review from a team as a code owner October 21, 2024 20:19
@james-munson james-munson self-assigned this Oct 21, 2024
@james-munson james-munson marked this pull request as draft October 21, 2024 20:20
@james-munson
Copy link
Contributor Author

Marking as draft because we want reviews of the content, but it shouldn't be committed until tests are in place and running.

Copy link

netlify bot commented Oct 21, 2024

Deploy Preview for longhornio ready!

Name Link
🔨 Latest commit f6bb04b
🔍 Latest deploy log https://app.netlify.com/sites/longhornio/deploys/672a5e919b26c5000887f4c8
😎 Deploy Preview https://deploy-preview-1007--longhornio.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

jhkrug
jhkrug previously requested changes Oct 22, 2024
Copy link
Contributor

@jhkrug jhkrug left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small suggestions

@james-munson
Copy link
Contributor Author

Suggestions incorporated and re-pushed.

PhanLe1010
PhanLe1010 previously approved these changes Oct 25, 2024
Copy link
Contributor

@PhanLe1010 PhanLe1010 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@derekbit
Copy link
Member

@james-munson If it is ready, please change it to Ready For Review

@james-munson james-munson marked this pull request as ready for review October 28, 2024 22:34
@github-actions github-actions bot requested a review from jhkrug October 28, 2024 22:34
@james-munson
Copy link
Contributor Author

I'll propagate the content to 1.6 and 1.7 as well.

@derekbit
Copy link
Member

@james-munson Can you update the important note in the PR as well?

@james-munson
Copy link
Contributor Author

Added to "Important Notes" for 1.8.0. Also included updates to 1.6.4 and 1.7.3 docs. If it needs to be spread to earlier 1.6.x and 1.7.x, please let me know.

innobead
innobead previously approved these changes Oct 30, 2024
Copy link
Member

@innobead innobead left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM from a tech pov.

@derekbit
Copy link
Member

Added to "Important Notes" for 1.8.0. Also included updates to 1.6.4 and 1.7.3 docs. If it needs to be spread to earlier 1.6.x and 1.7.x, please let me know.

Yes, please, thank you.

@james-munson
Copy link
Contributor Author

Added to all 1.6.x and 1.7.x docs.

@james-munson james-munson dismissed jhkrug’s stale review October 31, 2024 19:52

Requested changes have been made.

@derekbit
Copy link
Member

derekbit commented Nov 4, 2024

cc @jhkrug @jillian-maroket Please help review it again. Thank you.

jhkrug
jhkrug previously approved these changes Nov 4, 2024
Copy link
Contributor

@jhkrug jhkrug left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

derekbit
derekbit previously approved these changes Nov 4, 2024
weight: 10
---

In this section, you will learn how to install Longhorn with the HelmChart controller built into RKE2 and K3S.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
In this section, you will learn how to install Longhorn with the HelmChart controller built into RKE2 and K3S.
In this section, you will learn how to install Longhorn with the HelmChart controller built into RKE2 and K3s.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Noted, for future reference. For what it is worth, even https://longhorn.io/docs/1.6.0/advanced-resources/os-distro-specific/csi-on-k3s/ uses several variations: K3s, K3S, k3s.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.


### Prerequisites

- Kubernetes cluster: Ensure that each node fulfills the [installation requirements](../#installation-requirements). Cluster should be running RKE2 or K3S.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Kubernetes cluster: Ensure that each node fulfills the [installation requirements](../#installation-requirements). Cluster should be running RKE2 or K3S.
- Kubernetes cluster: Ensure that each node fulfills the [installation requirements](../#installation-requirements). Cluster should be running RKE2 or K3s.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

Copy link
Member

@derekbit derekbit left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After fixing the comments, we can merge the PR. Thank you.

name: longhorn-install
namespace: default
spec:
version: v1.8.0
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Replace with a version variable. Same for other versions.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done, thanks.

@@ -151,6 +151,9 @@ Starting with Longhorn v1.7.0, Longhorn supports Container-Optimized OS (COS), p
### Upgrade Check Events
Longhorn performs a pre-upgrade check when upgrading with Helm or Rancher App Marketplace. If a check fails, the upgrade will stop and the reason for the check's failure will be recorded in an event. For more detail, see [Upgrading Longhorn Manager](../deploy/upgrade/longhorn-manager).

### Install/Upgrade with Helm Controller
Longhorn also supports installation or upgrade via the HelmChart controller built into RKE2 and K3S. It allows management in a CRD YAML chart of most of the options that would normally be passed to the `helm` command-line tool. For more details on how it works, see [Install with Helm Controller](../deploy/install/install-with-helm-controller).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Longhorn also supports installation or upgrade via the HelmChart controller built into RKE2 and K3S. It allows management in a CRD YAML chart of most of the options that would normally be passed to the `helm` command-line tool. For more details on how it works, see [Install with Helm Controller](../deploy/install/install-with-helm-controller).
Longhorn also supports installation or upgrade via the HelmChart controller built into RKE2 and K3s. It allows management in a CRD YAML chart of most of the options that would normally be passed to the `helm` command-line tool. For more details on how it works, see [Install with Helm Controller](../deploy/install/install-with-helm-controller).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

@derekbit derekbit merged commit 8c93fc2 into longhorn:master Nov 5, 2024
6 checks passed
@james-munson james-munson deleted the 9506-helm-controller branch November 6, 2024 15:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants