Piped-Kubernetes/charts/apps/piped/README.md

183 lines
8.2 KiB
Markdown
Raw Normal View History

2023-03-02 02:00:25 +00:00
# piped
![Version: 2.6.1](https://img.shields.io/badge/Version-2.6.1-informational?style=flat-square) ![AppVersion: latest](https://img.shields.io/badge/AppVersion-latest-informational?style=flat-square)
2023-03-02 02:00:25 +00:00
Piped is an alternative privacy-friendly YouTube frontend which is efficient by design.
2023-03-03 23:52:18 +00:00
NOTICE: There is currently NO caching support included in the chart.
2023-03-02 02:00:25 +00:00
## Source Code
* <https://github.com/TeamPiped/Piped>
* <https://github.com/TeamPiped/Piped-Backend>
* <https://github.com/TeamPiped/piped-proxy>
## Requirements
2023-03-03 23:52:18 +00:00
Kubernetes: `>=1.22.0-0`
## Dependencies
2023-03-02 02:00:25 +00:00
| Repository | Name | Version |
|------------|------|---------|
| https://bjw-s.github.io/helm-charts | common | 1.5.1 |
| https://charts.bitnami.com/bitnami | postgresql | 12.5.6 |
2023-03-02 02:00:25 +00:00
2023-03-03 23:52:18 +00:00
## 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
2023-03-02 02:00:25 +00:00
## Values
2023-03-03 23:52:18 +00:00
**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)
2023-03-02 02:00:25 +00:00
| Key | Type | Default | Description |
|-----|------|---------|-------------|
2023-03-03 23:52:18 +00:00
| backend.config.HTTP_WORKERS | int | `2` | |
| backend.config.PORT | int | `8080` | |
2023-03-02 02:00:25 +00:00
| 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 | `"/"` | |
2023-03-03 23:52:18 +00:00
| ingress.main.primary | bool | `true` | |
2023-03-02 02:00:25 +00:00
| 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 |
2023-03-03 23:52:18 +00:00
| probes.liveness.enabled | bool | `true` | Enable the liveness probe |
2023-03-02 02:00:25 +00:00
| 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 |
2023-03-03 23:52:18 +00:00
| probes.readiness.enabled | bool | `true` | Enable the readiness probe |
2023-03-02 02:00:25 +00:00
| 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 |
2023-03-03 23:52:18 +00:00
| probes.startup.enabled | bool | `true` | Enable the startup probe |
2023-03-02 02:00:25 +00:00
| 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"` | |
2023-03-03 23:52:18 +00:00
## Changelog
### Version 2.6.1
2023-03-03 23:52:18 +00:00
#### Added
N/A
2023-03-03 23:52:18 +00:00
#### Changed
* Upgraded `common` chart dependency to version 1.5.1
2023-03-03 23:52:18 +00:00
#### Fixed
N/A
2023-03-03 23:52:18 +00:00
## Support
- Open an [issue](https://github.com/TeamPiped/Piped-Kubernetes/issues/new/choose)
2023-03-02 02:00:25 +00:00
----------------------------------------------
Autogenerated from chart metadata using [helm-docs v0.1.1](https://github.com/k8s-at-home/helm-docs/releases/v0.1.1)