183 lines
8.3 KiB
Markdown
183 lines
8.3 KiB
Markdown
# piped
|
|
|
|
 
|
|
|
|
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
|
|
|
|
* <https://github.com/TeamPiped/Piped>
|
|
* <https://github.com/TeamPiped/Piped-Backend>
|
|
* <https://github.com/TeamPiped/piped-proxy>
|
|
|
|
## Requirements
|
|
|
|
Kubernetes: `>=1.22.0-0`
|
|
|
|
## Dependencies
|
|
|
|
| Repository | Name | Version |
|
|
|------------|------|---------|
|
|
| https://bjw-s.github.io/helm-charts | common | 1.3.2 |
|
|
| https://charts.bitnami.com/bitnami | postgresql | 12.2.0 |
|
|
|
|
## TL;DR
|
|
|
|
```console
|
|
helm repo add TeamPiped https://helm.piped.video
|
|
helm repo update
|
|
helm install piped TeamPiped/piped
|
|
```
|
|
|
|
## Installing the Chart
|
|
|
|
To install the chart with the release name `piped`
|
|
|
|
```console
|
|
helm install piped TeamPiped/piped
|
|
```
|
|
|
|
## 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
|
|
|
|
**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)
|
|
|
|
| Key | Type | Default | Description |
|
|
|-----|------|---------|-------------|
|
|
| backend.config.HTTP_WORKERS | int | `2` | |
|
|
| backend.config.PORT | int | `8080` | |
|
|
| backend.enabled | bool | `true` | |
|
|
| backend.image.pullPolicy | string | `"IfNotPresent"` | image pull policy |
|
|
| backend.image.repository | string | `"1337kavin/piped"` | image repository |
|
|
| backend.image.tag | string | `nil` | image tag @chart.appVersion |
|
|
| backend.service.main.enabled | bool | `true` | |
|
|
| backend.service.main.ports.http.enabled | bool | `true` | |
|
|
| backend.service.main.ports.http.port | int | `8080` | |
|
|
| backend.service.main.ports.http.primary | bool | `true` | |
|
|
| backend.service.main.ports.http.protocol | string | `"HTTP"` | |
|
|
| backend.service.main.primary | bool | `true` | |
|
|
| backend.service.main.type | string | `"ClusterIP"` | |
|
|
| controller.enabled | bool | `false` | enable the controller. |
|
|
| 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.command | string | `"/bin/ash"` | BACKEND_HOSTNAME: pipedapi.example.org |
|
|
| frontend.enabled | bool | `true` | |
|
|
| frontend.image.pullPolicy | string | `"IfNotPresent"` | image pull policy |
|
|
| frontend.image.repository | string | `"1337kavin/piped-frontend"` | image repository |
|
|
| frontend.image.tag | string | `nil` | image tag @chart.appVersion |
|
|
| frontend.service.main.enabled | bool | `true` | |
|
|
| frontend.service.main.ports.http.enabled | bool | `true` | |
|
|
| frontend.service.main.ports.http.port | int | `80` | |
|
|
| frontend.service.main.ports.http.primary | bool | `true` | |
|
|
| frontend.service.main.ports.http.protocol | string | `"HTTP"` | |
|
|
| frontend.service.main.primary | bool | `true` | |
|
|
| frontend.service.main.type | string | `"ClusterIP"` | |
|
|
| global.annotations | object | `{}` | Set additional global annotations. Helm templates can be used. |
|
|
| global.fullnameOverride | string | `nil` | Set the entire name definition |
|
|
| global.labels | object | `{}` | Set additional global labels. Helm templates can be used. |
|
|
| global.nameOverride | string | `nil` | Set an override for the prefix of the fullname |
|
|
| ingress.backend.enabled | bool | `true` | |
|
|
| ingress.backend.hosts[0].host | string | `"pipedapi.piped.video"` | |
|
|
| ingress.backend.hosts[0].paths[0].path | string | `"/"` | |
|
|
| ingress.backend.ingressClassName | string | `"nginx"` | |
|
|
| ingress.backend.primary | bool | `false` | |
|
|
| ingress.backend.tls | list | `[]` | |
|
|
| ingress.main.enabled | bool | `true` | |
|
|
| ingress.main.hosts[0].host | string | `"piped.video"` | |
|
|
| ingress.main.hosts[0].paths[0].path | string | `"/"` | |
|
|
| ingress.main.primary | bool | `true` | |
|
|
| ingress.main.tls | list | `[]` | |
|
|
| ingress.ytproxy.enabled | bool | `true` | |
|
|
| ingress.ytproxy.hosts[0].host | string | `"ytproxy.piped.video"` | |
|
|
| ingress.ytproxy.hosts[0].paths[0].path | string | `"/"` | |
|
|
| ingress.ytproxy.ingressClassName | string | `"nginx"` | |
|
|
| ingress.ytproxy.primary | bool | `false` | |
|
|
| ingress.ytproxy.tls | list | `[]` | |
|
|
| postgresql.auth.database | string | `"piped"` | |
|
|
| postgresql.auth.password | string | `"changemepiped"` | |
|
|
| postgresql.auth.username | string | `"piped"` | |
|
|
| postgresql.enabled | bool | `true` | |
|
|
| postgresql.image.tag | string | `"11.19.0-debian-11-r4"` | |
|
|
| probes | object | See below | Probe configuration -- [[ref]](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) |
|
|
| 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.enabled | bool | `true` | Enable the liveness probe |
|
|
| probes.liveness.spec | object | See below | The spec field contains the values for the default livenessProbe. If you selected `custom: true`, this field holds the definition of the livenessProbe. |
|
|
| probes.readiness | object | See below | Redainess probe configuration |
|
|
| probes.readiness.custom | bool | `false` | Set this to `true` if you wish to specify your own readinessProbe |
|
|
| probes.readiness.enabled | bool | `true` | Enable the readiness probe |
|
|
| probes.readiness.spec | object | See below | The spec field contains the values for the default readinessProbe. If you selected `custom: true`, this field holds the definition of the readinessProbe. |
|
|
| probes.startup | object | See below | Startup probe configuration |
|
|
| probes.startup.custom | bool | `false` | Set this to `true` if you wish to specify your own startupProbe |
|
|
| probes.startup.enabled | bool | `true` | Enable the startup probe |
|
|
| probes.startup.spec | object | See below | The spec field contains the values for the default startupProbe. If you selected `custom: true`, this field holds the definition of the startupProbe. |
|
|
| serviceAccount.create | bool | `false` | |
|
|
| termination.gracePeriodSeconds | string | `nil` | |
|
|
| ytproxy.command | string | `"/app/piped-proxy"` | |
|
|
| ytproxy.enabled | bool | `true` | |
|
|
| ytproxy.image.pullPolicy | string | `"IfNotPresent"` | image pull policy |
|
|
| ytproxy.image.repository | string | `"1337kavin/piped-proxy"` | image repository |
|
|
| ytproxy.image.tag | string | `nil` | image tag @chart.appVersion |
|
|
| ytproxy.service.main.enabled | bool | `true` | |
|
|
| ytproxy.service.main.ports.http.enabled | bool | `true` | |
|
|
| ytproxy.service.main.ports.http.port | int | `8080` | |
|
|
| ytproxy.service.main.ports.http.primary | bool | `true` | |
|
|
| ytproxy.service.main.ports.http.protocol | string | `"HTTP"` | |
|
|
| ytproxy.service.main.primary | bool | `true` | |
|
|
| ytproxy.service.main.type | string | `"ClusterIP"` | |
|
|
|
|
## Changelog
|
|
|
|
### Version 2.0.1
|
|
|
|
#### Added
|
|
|
|
N/A
|
|
|
|
#### Changed
|
|
|
|
N/A
|
|
|
|
#### Fixed
|
|
|
|
- The backend configmap generation (GH issue: https://github.com/TeamPiped/Piped-Kubernetes/issues/2)
|
|
|
|
## 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)
|