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 thehelm-docs
tool. To installhelm-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
Generate 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.