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

Update helm chart version and clarify helm-related docs #1378

Merged
merged 3 commits into from
Oct 17, 2024

Conversation

joshuabaird
Copy link
Collaborator

What this PR does / why we need it:

This repo has a "development" copy of Fluent Operator's helm chart that should be published to fluent/helm-charts during each release. There are a few related issues:

  • Our docs (see README) instruct folks to install the Helm chart from a local source, not from the published chart in fluent/helm-charts
  • Our release docs (see RELEASE) don't instruct developers that they need to rev the Chart version and sync/publish the chart to fluent/helm-chart.

This PR bumps the chart version to v3.2.0 which was accidentally forgotten during the v3.2.0 release and attempts to clarify documentation around installing the Helm chart (as a user) and updating the Helm chart (as a developer).

In the future, we should probably introduce automation around publishing the Helm chart, or consider getting rid of the local copy of the chart in this repo all together.

Does this PR introduced a user-facing change?

N/A

Additional documentation, usage docs, etc.:

Signed-off-by: Josh Baird <[email protected]>

```shell
helm install fluent-operator --create-namespace -n fluent https://github.com/fluent/fluent-operator/releases/download/< version >/fluent-operator.tgz
helm repo add fluent https://fluent.github.io/helm-charts
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Use the fluent/helm-charts repo as a source for the Helm chart installation rather than a local copy of the chart.

# follow Semantic Versioning. They should reflect the version the application is using.
appVersion: 3.1.0

description: Fluent Operator provides great flexibility in building a logging layer based on Fluent Bit and Fluentd.
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

- fluent-bit
- fluentd
- operator
version: 3.2.0
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Bumped version here.

@joshuabaird
Copy link
Collaborator Author

@benjaminhuo @wenchajun @cw-Guo Attempted to clarify some of the Helm related confusion in this PR. Please provide suggestions and/or comments.

Signed-off-by: Josh Baird <[email protected]>

> Note: During the upgrade process, if a CRD was previously created using the create operation, an error will occur during the apply operation. Using apply here allows the CRD to be replaced and created in its entirety in a single operation.

To replace the CRDs pull the current helm chart:
```
wget https://github.com/fluent/fluent-operator/releases/download/<version>/fluent-operator.tgz
Copy link
Collaborator

Choose a reason for hiding this comment

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

should we change here to the helm chart repo too?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Honestly, I think ultimately we should split the CRDs out into their own chart (eg, fluent-operator-crds) and include the CRDs as "templates" so that they can be upgraded just by doing a helm upgrade --install fluent fluent-operator-crds). This is a workaround that others are using to manage CRD updates/upgrades using Helm.

@benjaminhuo benjaminhuo requested a review from wanjunlei October 17, 2024 08:48
@benjaminhuo
Copy link
Member

@joshuabaird Thank you very much!

@benjaminhuo benjaminhuo merged commit 09cfed2 into fluent:master Oct 17, 2024
2 checks passed
@benjaminhuo
Copy link
Member

@joshuabaird would you help to sync the new helm chart to https://github.com/fluent/helm-charts/tree/main/charts/fluent-operator ?

@joshuabaird
Copy link
Collaborator Author

@benjaminhuo
Copy link
Member

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.

3 participants