Skip to content

Commit f72262f

Browse files
docs: added example output and fixed run cmd (#35)
* docs: added example output and fixed run cmd * fix: update lockfile
1 parent de3880d commit f72262f

File tree

4 files changed

+119
-2
lines changed

4 files changed

+119
-2
lines changed

.github/workflows/lintmarkdown.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ jobs:
1212
uses: docker://avtodev/markdown-lint:v1
1313
with:
1414
args: './*.md'
15-
ignore: './test/output.md ./test/custom-template-keywords.md'
15+
ignore: './test/output.md ./test/custom-template-keywords.md ./EXAMPLE_OUTPUT.md'

EXAMPLE_OUTPUT.md

+87
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# kibana
2+
![Version: 8.4.1](https://img.shields.io/badge/Version-8.4.1-informational?style=flat-square) ![Version: 8.4.1](https://img.shields.io/badge/appVersion-8.4.1-informational?style=flat-square) ![Version: v1](https://img.shields.io/badge/apiVersion-v1-informational?style=flat-square) ![Type: unknown](https://img.shields.io/badge/Type-unknown-informational?style=flat-square)
3+
4+
## Description
5+
Official Elastic helm chart for Kibana
6+
7+
## Dependencies
8+
This chart depends on the following subcharts.
9+
10+
*No dependencies found.*
11+
12+
## Templates
13+
The following templates will be deployed.
14+
15+
| Path |
16+
|---|
17+
| configmap-helm-scripts.yaml |
18+
| configmap.yaml |
19+
| deployment.yaml |
20+
| ingress.yaml |
21+
| job.yaml |
22+
| service.yaml |
23+
24+
25+
### Objects
26+
The aforementioned templates will deploy the following objects.
27+
28+
| Kind | From template |
29+
|---|---|
30+
| ConfigMap | configmap-helm-scripts.yaml |
31+
| ConfigMap | configmap.yaml |
32+
| Deployment | deployment.yaml |
33+
| Ingress | ingress.yaml |
34+
| Job | job.yaml |
35+
| Service | service.yaml |
36+
37+
38+
## Values
39+
The following values can/will be used for deployments.
40+
41+
| Name | Description | Default | Example |
42+
|---|---|---|---|
43+
| elasticsearchHosts | | <pre>elasticsearchHosts: https://elasticsearch-master:9200<br></pre> | |
44+
| elasticsearchCertificateSecret | | <pre>elasticsearchCertificateSecret: elasticsearch-master-certs<br></pre> | |
45+
| elasticsearchCertificateAuthoritiesFile | | <pre>elasticsearchCertificateAuthoritiesFile: ca.crt<br></pre> | |
46+
| elasticsearchCredentialSecret | | <pre>elasticsearchCredentialSecret: elasticsearch-master-credentials<br></pre> | |
47+
| replicas | | <pre>replicas: 1<br></pre> | |
48+
| extraEnvs | | <pre>extraEnvs:<br>- name: NODE_OPTIONS<br> value: --max-old-space-size=1800<br></pre> | |
49+
| envFrom | | <pre>envFrom: []<br></pre> | |
50+
| secretMounts | | <pre>secretMounts: []<br></pre> | |
51+
| hostAliases | | <pre>hostAliases: []<br></pre> | |
52+
| image | | <pre>image: docker.elastic.co/kibana/kibana<br></pre> | |
53+
| imageTag | | <pre>imageTag: 8.4.1<br></pre> | |
54+
| imagePullPolicy | | <pre>imagePullPolicy: IfNotPresent<br></pre> | |
55+
| labels | | <pre>labels: {}<br></pre> | |
56+
| annotations | | <pre>annotations: {}<br></pre> | |
57+
| podAnnotations | | <pre>podAnnotations: {}<br></pre> | |
58+
| resources | | <pre>resources:<br> limits:<br> cpu: 1000m<br> memory: 2Gi<br> requests:<br> cpu: 1000m<br> memory: 2Gi<br></pre> | |
59+
| protocol | | <pre>protocol: http<br></pre> | |
60+
| serverHost | | <pre>serverHost: 0.0.0.0<br></pre> | |
61+
| healthCheckPath | | <pre>healthCheckPath: /app/kibana<br></pre> | |
62+
| kibanaConfig | | <pre>kibanaConfig: {}<br></pre> | |
63+
| podSecurityContext | | <pre>podSecurityContext:<br> fsGroup: 1000<br></pre> | |
64+
| securityContext | | <pre>securityContext:<br> capabilities:<br> drop:<br> - ALL<br> runAsNonRoot: true<br> runAsUser: 1000<br></pre> | |
65+
| serviceAccount | | <pre>serviceAccount: ''<br></pre> | |
66+
| automountToken | | <pre>automountToken: true<br></pre> | |
67+
| priorityClassName | | <pre>priorityClassName: ''<br></pre> | |
68+
| httpPort | | <pre>httpPort: 5601<br></pre> | |
69+
| extraVolumes | | <pre>extraVolumes: []<br></pre> | |
70+
| extraVolumeMounts | | <pre>extraVolumeMounts: []<br></pre> | |
71+
| extraContainers | | <pre>extraContainers: []<br></pre> | |
72+
| extraInitContainers | | <pre>extraInitContainers: []<br></pre> | |
73+
| updateStrategy | | <pre>updateStrategy:<br> type: Recreate<br></pre> | |
74+
| service | | <pre>service:<br> annotations: {}<br> httpPortName: http<br> labels: {}<br> loadBalancerIP: ''<br> loadBalancerSourceRanges: []<br> nodePort: ''<br> port: 5601<br> type: ClusterIP<br></pre> | |
75+
| ingress | | <pre>ingress:<br> annotations: {}<br> className: nginx<br> enabled: false<br> hosts:<br> - host: kibana-example.local<br> paths:<br> - path: /<br> pathtype: ImplementationSpecific<br></pre> | |
76+
| readinessProbe | | <pre>readinessProbe:<br> failureThreshold: 3<br> initialDelaySeconds: 10<br> periodSeconds: 10<br> successThreshold: 3<br> timeoutSeconds: 5<br></pre> | |
77+
| imagePullSecrets | | <pre>imagePullSecrets: []<br></pre> | |
78+
| nodeSelector | | <pre>nodeSelector: {}<br></pre> | |
79+
| tolerations | | <pre>tolerations: []<br></pre> | |
80+
| affinity | | <pre>affinity: {}<br></pre> | |
81+
| nameOverride | | <pre>nameOverride: ''<br></pre> | |
82+
| fullnameOverride | | <pre>fullnameOverride: ''<br></pre> | |
83+
| lifecycle | | <pre>lifecycle: {}<br></pre> | |
84+
85+
86+
*Automatic helm documentation generated using [very-doge-wow/stella](https://github.com/very-doge-wow/stella).*
87+

Pipfile.lock

+23
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

README.md

+8-1
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,13 @@ It supports simple templating, so custom templates for output can be used as
1212
well. Will read metadata such as `Chart.yaml`, `values.yaml` or the present
1313
templates and generate a Markdown or HTML documentation from that data.
1414

15+
## Example
16+
17+
For an example output when running `stella` for the
18+
[kibana](https://github.com/elastic/helm-charts/tree/main/kibana) helm chart,
19+
follow [this](https://github.com/very-doge-wow/stella/blob/main/EXAMPLE_OUTPUT.md)
20+
link.
21+
1522
## Usage
1623

1724
### Docker Image
@@ -21,7 +28,7 @@ Using the [OCI image](https://hub.docker.com/r/suchdogewow/stella):
2128
<!-- markdownlint-disable MD013 -->
2229
```shell
2330
docker pull suchdogewow/stella:latest
24-
docker run -v ${full_path_to_host_chart_dir}:/tmp/chart stella -hcp /tmp/chart -o /tmp/chart/output.md [OPTIONS]
31+
docker run -v ${full_path_to_host_chart_dir}:/tmp/chart suchdogewow/stella -hcp /tmp/chart -o /tmp/chart/output.md [OPTIONS]
2532
```
2633
<!-- markdownlint-enable MD013 -->
2734

0 commit comments

Comments
 (0)