mirror of
				https://github.com/TeamPiped/Piped-Kubernetes.git
				synced 2024-08-14 23:57:15 +00:00 
			
		
		
		
	Fix chart README generation.
This commit is contained in:
		
							parent
							
								
									e84aa7b6f4
								
							
						
					
					
						commit
						60153fd456
					
				
					 3 changed files with 37 additions and 204 deletions
				
			
		
							
								
								
									
										2
									
								
								.github/scripts/gen-helm-docs.sh
									
										
									
									
										vendored
									
									
								
							
							
						
						
									
										2
									
								
								.github/scripts/gen-helm-docs.sh
									
										
									
									
										vendored
									
									
								
							|  | @ -6,7 +6,7 @@ set -eu | ||||||
| 
 | 
 | ||||||
| # require helm-docs | # require helm-docs | ||||||
| command -v helm-docs >/dev/null 2>&1 || { | command -v helm-docs >/dev/null 2>&1 || { | ||||||
|     echo >&2 "helm-docs (https://github.com/k8s-at-home/helm-docs) is not installed. Aborting." |     echo >&2 "helm-docs (https://github.com/norwoodj/helm-docs) is not installed. Aborting." | ||||||
|     exit 1 |     exit 1 | ||||||
| } | } | ||||||
| 
 | 
 | ||||||
|  |  | ||||||
|  | @ -1,11 +1,9 @@ | ||||||
| # piped | # piped | ||||||
| 
 | 
 | ||||||
|   |   | ||||||
| 
 | 
 | ||||||
| Piped is an alternative privacy-friendly YouTube frontend which is efficient by design. | Piped is an alternative privacy-friendly YouTube frontend which is efficient by design. | ||||||
| 
 | 
 | ||||||
| NOTICE: There is currently NO caching support included in the chart. |  | ||||||
| 
 |  | ||||||
| ## Source Code | ## Source Code | ||||||
| 
 | 
 | ||||||
| * <https://github.com/TeamPiped/Piped> | * <https://github.com/TeamPiped/Piped> | ||||||
|  | @ -21,58 +19,27 @@ Kubernetes: `>=1.22.0-0` | ||||||
| | Repository | Name | Version | | | Repository | Name | Version | | ||||||
| |------------|------|---------| | |------------|------|---------| | ||||||
| | https://bjw-s.github.io/helm-charts | common | 1.5.1 | | | https://bjw-s.github.io/helm-charts | common | 1.5.1 | | ||||||
| | https://charts.bitnami.com/bitnami | postgresql | 13.2.0 | | | https://charts.bitnami.com/bitnami | postgresql | 13.2.27 | | ||||||
| 
 |  | ||||||
| ## TL;DR |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm repo add TeamPiped https://helm.piped.video |  | ||||||
| helm repo update |  | ||||||
| helm install piped TeamPiped/piped |  | ||||||
| ``` |  | ||||||
| 
 | 
 | ||||||
| ## Installing the Chart | ## Installing the Chart | ||||||
| 
 | 
 | ||||||
| To install the chart with the release name `piped` | ```bash | ||||||
|  | # Add the repository | ||||||
|  | helm repo add TeamPiped https://helm.piped.video | ||||||
| 
 | 
 | ||||||
| ```console | # Update your local Helm chart repository cache | ||||||
| helm install piped TeamPiped/piped | helm repo update | ||||||
|  | 
 | ||||||
|  | # Install the chart | ||||||
|  | helm install TeamPiped piped -f values.yaml | ||||||
| ``` | ``` | ||||||
| 
 | 
 | ||||||
| ## Uninstalling the Chart |  | ||||||
| 
 |  | ||||||
| To uninstall the `piped` deployment |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm uninstall piped |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| The command removes all the Kubernetes components associated with the chart **including persistent volumes** and deletes the release. |  | ||||||
| 
 |  | ||||||
| ## Configuration |  | ||||||
| 
 |  | ||||||
| Read through the [values.yaml](./values.yaml) file. It has several commented out suggested values. |  | ||||||
| Other values may be used from the [values.yaml](https://github.com/bjw-s/helm-charts/blob/main/charts/library/common/values.yaml) from the [common library](https://github.com/bjw-s/helm-charts/tree/main/charts/library/common). |  | ||||||
| 
 |  | ||||||
| Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`. |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm install piped \ |  | ||||||
|   --set env.TZ="America/New York" \ |  | ||||||
|     TeamPiped/piped |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm install piped TeamPiped/piped -f values.yaml |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| ## Custom configuration |  | ||||||
| 
 |  | ||||||
| ## Values | ## Values | ||||||
| 
 | 
 | ||||||
| **Important**: When deploying an application Helm chart you can add more values from the common library chart [here](https://github.com/bjw-s/helm-charts/tree/main/charts/library/common) | The following table contains an overview of available values and their descriptions / default values. | ||||||
|  | 
 | ||||||
|  | <details> | ||||||
|  | <summary>Expand</summary> | ||||||
| 
 | 
 | ||||||
| | Key | Type | Default | Description | | | Key | Type | Default | Description | | ||||||
| |-----|------|---------|-------------| | |-----|------|---------|-------------| | ||||||
|  | @ -92,7 +59,7 @@ helm install piped TeamPiped/piped -f values.yaml | ||||||
| | controller.enabled | bool | `false` | enable the controller. | | | controller.enabled | bool | `false` | enable the controller. | | ||||||
| | frontend.args[0] | string | `"-c"` |  | | | frontend.args[0] | string | `"-c"` |  | | ||||||
| | frontend.args[1] | string | `"sed -i s/pipedapi.kavin.rocks/$BACKEND_HOSTNAME/g /usr/share/nginx/html/assets/* && /docker-entrypoint.sh nginx -g 'daemon off;'"` |  | | | frontend.args[1] | string | `"sed -i s/pipedapi.kavin.rocks/$BACKEND_HOSTNAME/g /usr/share/nginx/html/assets/* && /docker-entrypoint.sh nginx -g 'daemon off;'"` |  | | ||||||
| | frontend.command | string | `"/bin/ash"` |   BACKEND_HOSTNAME: pipedapi.example.org | | | frontend.command | string | `"/bin/ash"` |  | | ||||||
| | frontend.enabled | bool | `true` |  | | | frontend.enabled | bool | `true` |  | | ||||||
| | frontend.image.pullPolicy | string | `"IfNotPresent"` | image pull policy | | | frontend.image.pullPolicy | string | `"IfNotPresent"` | image pull policy | | ||||||
| | frontend.image.repository | string | `"1337kavin/piped-frontend"` | image repository | | | frontend.image.repository | string | `"1337kavin/piped-frontend"` | image repository | | ||||||
|  | @ -130,7 +97,7 @@ helm install piped TeamPiped/piped -f values.yaml | ||||||
| | postgresql.auth.username | string | `"piped"` |  | | | postgresql.auth.username | string | `"piped"` |  | | ||||||
| | postgresql.enabled | bool | `true` |  | | | postgresql.enabled | bool | `true` |  | | ||||||
| | postgresql.image.tag | string | `"13.12.0-debian-11-r58"` |  | | | postgresql.image.tag | string | `"13.12.0-debian-11-r58"` |  | | ||||||
| | probes | object | See below | Probe configuration -- [[ref]](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | | | probes | object | See below | [[ref]](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | | ||||||
| | probes.liveness | object | See below | Liveness probe configuration | | | probes.liveness | object | See below | Liveness probe configuration | | ||||||
| | probes.liveness.custom | bool | `false` | Set this to `true` if you wish to specify your own livenessProbe | | | probes.liveness.custom | bool | `false` | Set this to `true` if you wish to specify your own livenessProbe | | ||||||
| | probes.liveness.enabled | bool | `true` | Enable the liveness probe | | | probes.liveness.enabled | bool | `true` | Enable the liveness probe | | ||||||
|  | @ -158,25 +125,7 @@ helm install piped TeamPiped/piped -f values.yaml | ||||||
| | ytproxy.service.main.primary | bool | `true` |  | | | ytproxy.service.main.primary | bool | `true` |  | | ||||||
| | ytproxy.service.main.type | string | `"ClusterIP"` |  | | | ytproxy.service.main.type | string | `"ClusterIP"` |  | | ||||||
| 
 | 
 | ||||||
| ## Changelog | </details> | ||||||
| 
 |  | ||||||
| ### Version 4.1.0 |  | ||||||
| 
 |  | ||||||
| #### Added |  | ||||||
| 
 |  | ||||||
| N/A |  | ||||||
| 
 |  | ||||||
| #### Changed |  | ||||||
| 
 |  | ||||||
| * Upgraded `postgresql` chart dependency to version 13.2.0 |  | ||||||
| 
 |  | ||||||
| #### Fixed |  | ||||||
| 
 |  | ||||||
| N/A |  | ||||||
| 
 |  | ||||||
| ## Support |  | ||||||
| 
 |  | ||||||
| - Open an [issue](https://github.com/TeamPiped/Piped-Kubernetes/issues/new/choose) |  | ||||||
| 
 | 
 | ||||||
| ---------------------------------------------- | ---------------------------------------------- | ||||||
| Autogenerated from chart metadata using [helm-docs v0.1.1](https://github.com/k8s-at-home/helm-docs/releases/v0.1.1) | Autogenerated from chart metadata using [helm-docs v1.12.0](https://github.com/norwoodj/helm-docs/releases/v1.12.0) | ||||||
|  |  | ||||||
|  | @ -14,157 +14,41 @@ https://helm.piped.video | ||||||
| {{ template "custom.repository.organization" . }}/{{ template "chart.name" . }} | {{ template "custom.repository.organization" . }}/{{ template "chart.name" . }} | ||||||
| {{- end -}} | {{- end -}} | ||||||
| 
 | 
 | ||||||
| {{- define "custom.notes" -}} |  | ||||||
| 
 |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.requirements" -}} |  | ||||||
| ## Requirements |  | ||||||
| 
 |  | ||||||
| {{ template "chart.kubeVersionLine" . }} |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.dependencies" -}} |  | ||||||
| ## Dependencies |  | ||||||
| 
 |  | ||||||
| {{ template "chart.requirementsTable" . }} |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.install.tldr" -}} |  | ||||||
| ## TL;DR |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm repo add {{ template "custom.repository.organization" . }} {{ template "custom.helm.url" . }} |  | ||||||
| helm repo update |  | ||||||
| helm install {{ template "chart.name" . }} {{ template "custom.helm.path" . }} |  | ||||||
| ``` |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.install" -}} |  | ||||||
| ## Installing the Chart |  | ||||||
| 
 |  | ||||||
| To install the chart with the release name `{{ template "chart.name" . }}` |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm install {{ template "chart.name" . }} {{ template "custom.helm.path" . }} |  | ||||||
| ``` |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.uninstall" -}} |  | ||||||
| ## Uninstalling the Chart |  | ||||||
| 
 |  | ||||||
| To uninstall the `{{ template "chart.name" . }}` deployment |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm uninstall {{ template "chart.name" . }} |  | ||||||
| ``` |  | ||||||
| 
 |  | ||||||
| The command removes all the Kubernetes components associated with the chart **including persistent volumes** and deletes the release. |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.configuration.header" -}} |  | ||||||
| ## Configuration |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.configuration.readValues" -}} |  | ||||||
| Read through the [values.yaml](./values.yaml) file. It has several commented out suggested values. |  | ||||||
| Other values may be used from the [values.yaml](https://github.com/bjw-s/helm-charts/blob/main/charts/library/common/values.yaml) from the [common library](https://github.com/bjw-s/helm-charts/tree/main/charts/library/common). |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.configuration.example.set" -}} |  | ||||||
| Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`. |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm install {{ template "chart.name" . }} \ |  | ||||||
|   --set env.TZ="America/New York" \ |  | ||||||
|     {{ template "custom.helm.path" . }} |  | ||||||
| ``` |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.configuration.example.file" -}} |  | ||||||
| Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. |  | ||||||
| 
 |  | ||||||
| ```console |  | ||||||
| helm install {{ template "chart.name" . }} {{ template "custom.helm.path" . }} -f values.yaml |  | ||||||
| ``` |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.valuesSection" -}} |  | ||||||
| ## Values |  | ||||||
| 
 |  | ||||||
| **Important**: When deploying an application Helm chart you can add more values from the common library chart [here](https://github.com/bjw-s/helm-charts/tree/main/charts/library/common) |  | ||||||
| 
 |  | ||||||
| {{ template "chart.valuesTable" . }} |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.support" -}} |  | ||||||
| ## Support |  | ||||||
| 
 |  | ||||||
| - Open an [issue](https://github.com/TeamPiped/Piped-Kubernetes/issues/new/choose) |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{- define "custom.changelog" -}} |  | ||||||
| {{ $changeTypes := list "added" "changed" "fixed" }} |  | ||||||
| ## Changelog |  | ||||||
| 
 |  | ||||||
| ### Version {{ template "chart.version" . }} |  | ||||||
| 
 |  | ||||||
| {{ range $changeType := $changeTypes }} |  | ||||||
|   {{- with (index $.Annotations "artifacthub.io/changes") }} |  | ||||||
|     {{- print "#### " ($changeType | title)  | nindent 0  }} |  | ||||||
|     {{- print "" | nindent 0  }} |  | ||||||
|     {{- $changesFound := false }} |  | ||||||
|     {{- $changes := ((print "changes:\n" .) | fromYaml).changes }} |  | ||||||
|     {{- range $changes }} |  | ||||||
|       {{- if eq .kind $changeType }} |  | ||||||
|         {{- print "* " .description  | nindent 0 }} |  | ||||||
|         {{- $changesFound = true }} |  | ||||||
|       {{- end }} |  | ||||||
|     {{- end }} |  | ||||||
|     {{- if not $changesFound }} |  | ||||||
|       {{- print "N/A" | nindent 0 }} |  | ||||||
|     {{- end }} |  | ||||||
|     {{- print "" | nindent 0  }} |  | ||||||
|   {{- end }} |  | ||||||
| {{- end }} |  | ||||||
| 
 |  | ||||||
| {{- end -}} |  | ||||||
| 
 |  | ||||||
| {{ template "chart.header" . }} | {{ template "chart.header" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "chart.versionBadge" . }}{{ template "chart.typeBadge" . }}{{ template "chart.appVersionBadge" . }} | {{ template "chart.versionBadge" . }}{{ template "chart.typeBadge" . }}{{ template "chart.appVersionBadge" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "chart.description" . }} | {{ template "chart.description" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "custom.notes" . }} |  | ||||||
| 
 |  | ||||||
| {{ template "chart.sourcesSection" . }} | {{ template "chart.sourcesSection" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "custom.requirements" . }} | ## Requirements | ||||||
| 
 | 
 | ||||||
| {{ template "custom.dependencies" . }} | {{ template "chart.kubeVersionLine" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "custom.install.tldr" . }} | ## Dependencies | ||||||
| 
 | 
 | ||||||
| {{ template "custom.install" . }} | {{ template "chart.requirementsTable" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "custom.uninstall" . }} | ## Installing the Chart | ||||||
| 
 | 
 | ||||||
| {{ template "custom.configuration.header" . }} | ```bash | ||||||
|  | # Add the repository | ||||||
|  | helm repo add {{ template "custom.repository.organization" }} {{template "custom.helm.url"}} | ||||||
| 
 | 
 | ||||||
| {{ template "custom.configuration.readValues" . }} | # Install the chart | ||||||
|  | helm install {{ template "custom.repository.organization" }} piped -f values.yaml | ||||||
|  | ``` | ||||||
| 
 | 
 | ||||||
| {{ template "custom.configuration.example.set" . }} | ## Values | ||||||
| 
 | 
 | ||||||
| {{ template "custom.configuration.example.file" . }} | The following table contains an overview of available values and their descriptions / default values. | ||||||
| 
 | 
 | ||||||
| {{ template "custom.custom.configuration" . }} | <details> | ||||||
|  | <summary>Expand</summary> | ||||||
| 
 | 
 | ||||||
| {{ template "custom.valuesSection" . }} | {{ template "chart.valuesTable" . }} | ||||||
| 
 | 
 | ||||||
| {{ template "custom.changelog" . }} | </details> | ||||||
| 
 |  | ||||||
| {{ template "custom.support" . }} |  | ||||||
| 
 | 
 | ||||||
| {{ template "helm-docs.versionFooter" . }} | {{ template "helm-docs.versionFooter" . }} | ||||||
| {{ "" }} |  | ||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue