173 lines
4.1 KiB
Markdown
173 lines
4.1 KiB
Markdown
# Run ffplayout in container
|
|
|
|
The image is build with a default user/pass `admin/admin`.
|
|
|
|
You can take a look at the [Dockerfile](Dockerfile)
|
|
|
|
### /!\ as ffmpeg is compiled with `--enable-nonfree` don't push it to a public registry nor distribute the image /!\
|
|
|
|
## Storage
|
|
|
|
There are some folders/files that are important for ffplayout to work well such as:
|
|
- **/usr/share/ffplayout/db** => where all the data are stored (user/pass etc)
|
|
- **/var/lib/ffplayout/tv-media** => where the media are stored by default (configurable)
|
|
- **/var/lib/ffplayout/playlists** => where playlists are stored (configurable)
|
|
|
|
It may be useful to create/link volume for those folders/files.
|
|
|
|
## Docker
|
|
|
|
How to build the image:\
|
|
```BASH
|
|
# build default
|
|
docker build -t ffplayout-image .
|
|
|
|
# build with shared storage (same storage for all channels)
|
|
docker build --build-arg SHARED_STORAGE=true .
|
|
|
|
# build from root folder, to copy local *.rpm package
|
|
docker build -f docker/Dockerfile -t ffplayout-image .
|
|
|
|
# build ffmpeg from source
|
|
docker build -f ffmpeg.Dockerfile -t ffmpeg-build .
|
|
docker build -f nonfree.Dockerfile -t ffplayout-image:nonfree .
|
|
|
|
# build with nvidia image for hardware support
|
|
docker build -f nvidia.Dockerfile -t ffplayout-image:nvidia .
|
|
```
|
|
|
|
example of command to start the container:
|
|
|
|
```BASH
|
|
docker run -it -v /path/to/db:/db -v /path/to/storage:/tv-media -v /path/to/playlists:/playlists -v /path/to/public:/public -v /path/to/logging:/logging --name ffplayout -p 8787:8787 ffplayout-image
|
|
|
|
# run in daemon mode
|
|
docker run -d --name ffplayout -p 8787:8787 ffplayout-image
|
|
|
|
# run with docker-compose
|
|
docker-compose up -d
|
|
```
|
|
|
|
#### Note from CentOS docker hub page
|
|
There have been reports that if you're using an Ubuntu host, you will need to add `-v /tmp/$(mktemp -d):/run` to the mount.
|
|
|
|
## Kubernetes
|
|
|
|
basic example to run the service in k8s:
|
|
```
|
|
---
|
|
apiVersion: apps/v1
|
|
kind: Deployment
|
|
metadata:
|
|
labels:
|
|
app: ffplayout
|
|
name: ffplayout
|
|
namespace: ffplayout
|
|
spec:
|
|
replicas: 1
|
|
selector:
|
|
matchLabels:
|
|
app: ffplayout
|
|
strategy:
|
|
type: Recreate
|
|
template:
|
|
metadata:
|
|
labels:
|
|
app: ffplayout
|
|
spec:
|
|
containers:
|
|
- name: ffplayout
|
|
securityContext:
|
|
allowPrivilegeEscalation: true
|
|
capabilities:
|
|
add:
|
|
- SYS_ADMIN
|
|
image: ffplayout-image:latest
|
|
ports:
|
|
- containerPort: 8787
|
|
name: web
|
|
protocol: TCP
|
|
volumeMounts:
|
|
- name: cgroup
|
|
mountPath: /sys/fs/cgroup
|
|
readOnly: true
|
|
- name: database-volume
|
|
mountPath: /usr/share/ffplayout/db
|
|
restartPolicy: Always
|
|
volumes:
|
|
- name: cgroup
|
|
hostPath:
|
|
path: '/sys/fs/cgroup'
|
|
type: Directory
|
|
- name: database-volume
|
|
ephemeral:
|
|
volumeClaimTemplate:
|
|
metadata:
|
|
labels:
|
|
type: my-database-volume
|
|
spec:
|
|
accessModes: [ "ReadWriteOnce" ]
|
|
storageClassName: "database-storage-class"
|
|
resources:
|
|
requests:
|
|
storage: 1Gi
|
|
```
|
|
|
|
|
|
|
|
### Use with traefik
|
|
|
|
If you are using traefik here is a sample config
|
|
```
|
|
---
|
|
kind: Service
|
|
apiVersion: v1
|
|
metadata:
|
|
name: ffplayout
|
|
namespace: ffplayout
|
|
spec:
|
|
ports:
|
|
- port: 8787
|
|
name: web
|
|
protocol: TCP
|
|
selector:
|
|
app: ffplayout
|
|
---
|
|
apiVersion: traefik.containo.us/v1alpha1
|
|
kind: IngressRoute
|
|
metadata:
|
|
name: ffplayout-http
|
|
namespace: ffplayout
|
|
spec:
|
|
entryPoints:
|
|
- web
|
|
routes:
|
|
- match: Host(`ffplayout.example.com`) && PathPrefix(`/`)
|
|
kind: Rule
|
|
middlewares:
|
|
- name: redirect-https
|
|
namespace: default
|
|
services:
|
|
- name: ffplayout
|
|
namespace: ffplayout
|
|
port: 8787
|
|
---
|
|
apiVersion: traefik.containo.us/v1alpha1
|
|
kind: IngressRoute
|
|
metadata:
|
|
name: ffplayout-https
|
|
namespace: ffplayout
|
|
spec:
|
|
entryPoints:
|
|
- websecure
|
|
routes:
|
|
- match: Host(`ffplayout.example.com`) && PathPrefix(`/`)
|
|
kind: Rule
|
|
services:
|
|
- name: ffplayout
|
|
namespace: ffplayout
|
|
port: 8787
|
|
tls:
|
|
certResolver: yourCert
|
|
```
|