Scripts for managing the Magistrala IoT platform. For installation instructions, refer to Magistrala Kubernetes Documentation.
The documentation for Magistrala Helm charts in charts/magistrala/README.md
is generated using helm-docs
, which extracts metadata from Chart.yaml
and values.yaml
. To update the documentation after changes, follow these steps:
Before starting, ensure the following tools are installed:
Helm
Make sure Helm is installed on your system. If not, follow the Helm installation guide to get started.
Helm Docs Tool
The documentation for the Magistrala Helm charts is autogenerated using the helm-docs
tool. To install helm-docs
, use the following command:
go install github.com/norwoodj/helm-docs/cmd/helm-docs@latest
If Go is not installed, follow the Go installation guide.
First, move to the directory where the Helm charts are stored. For this project, the command would be:
cd devops
helm-docs
CommandGenerate or update the documentation for your Helm charts by running:
helm-docs
This command will parse the charts in the charts
directory and update the charts/magistrala/README.md
file. A typical successful run looks like this:
INFO[2024-09-11T11:34:20+03:00] Found Chart directories [charts/magistrala]
INFO[2024-09-11T11:34:20+03:00] Generating README Documentation for chart charts/magistrala
After helm-docs
has updated the documentation, review the changes, and then commit and push them to your Git repository:
git add charts/magistrala/README.md
git commit -m "Update Helm chart documentation"
git push origin <your-branch>
Replace <your-branch>
with the branch you are working on.
This project is licensed under the Apache-2.0.