henine
/
wubloader
mirror of https://github.com/ekimekim/wubloader
1
0
Fork 0
Code Issues Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
852 Commits
34 Branches
0 Tags
19 MiB
Python 63.5%
JavaScript 18.8%
Jsonnet 8.4%
HTML 3.8%
Dockerfile 1.7%
Other 3.8%
 
 
 
 
 
 
thrimbletrimmer-solid
HubbeKing-multiplatform-builds
bus-progress-ui
master
bus-post-processing
chrusher/bus_synthesizer
mike/faster-chat-merge
mike/chat-no-end-time
chrusher-playlist-thumbnails
chrusher-thumbnail-frontend
mike/prizebot
condor-scripts
mike/chat-subs
mike/bad-segment-hack
mike/backfill-extras
mike/cropping
mike/shorts
mike/download-frame-2
mike/debug-playlists
chrusher/backfiller_error_handler
sheet-updates
mike/generate-videos
suspect-segments
mike/testing
gunner/thrimbletrimmer-improvements
mike/render-dashboard
mike/database/initial
downloader/follow-game
mike/downloader/conn-pooling
mike/common/split-up
mike/backdoor
mike/downloader/handle-404
mike/non-restreamer-stats
archive/original-v2.1
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '1add3c5c22'
${ noResults }
Go to file
Mike Lang 1add3c5c22 Implement tombstoning to allow for segment deletion 
Rarely, we find ourselves needing to explicitly delete some data, eg. something that shouldn't
have been public and should be removed from all records.

It would also be nice if we could "clean up" bad versions of the same segment,
which occasionally come up when downloaders have issues.

With our distributed segment database, this is actually rather difficult as deleting the data
from any one server would cause it to be restored from the others. It was only possible
by stopping all backfill, deleting the data on all servers, then starting backfill again.

Here we introduce a more practical approach. An operator creates an empty flag file
with the same name as the segment to be deleted, but with a `.tombstone` extension.
eg. to delete a file `/segments/desertbus/source/2019-11-13T02/45:51.608000-2.0-full-7IS92rssMzoSBQDIevHStbTNy-URRV3Vw-jzZ6pwOZM.ts`,
you would create a tombstone `/segments/desertbus/source/2019-11-13T02/45:51.608000-2.0-full-7IS92rssMzoSBQDIevHStbTNy-URRV3Vw-jzZ6pwOZM.tombstone`.

These tombstone files do two important things:
* They hide the segment from being listed, which both means:
  * It can't be restreamed or put into a video
  * It can't be backfilled to other nodes
* The tombstone files themselves do get backfilled to other nodes, so you only need to mark them on one server.

Once the tombstone has propagated to all nodes, the segment file can be deleted independently on each one.

We chose not to have a tombstone automatically trigger a segment deletion for safety reasons.
 		2 years ago
.github/workflows Set ghcr.io username to user triggering the build 3 years ago
api_ping Link images to github repo by adding a LABEL 3 years ago
backfiller Implement tombstoning to allow for segment deletion 2 years ago
common Implement tombstoning to allow for segment deletion 2 years ago
cutter Fix a bug when reporting errors claiming candidates 3 years ago
db_scripts use a UTC timestamp 5 years ago
downloader Implement tombstoning to allow for segment deletion 2 years ago
monitoring monitoring: only request for services matching role 3 years ago
nginx Link images to github repo by adding a LABEL 3 years ago
playlist_manager playlist manager: serialize insert requests 3 years ago
postgres Fix typo in postgres schema 3 years ago
restreamer Implement tombstoning to allow for segment deletion 2 years ago
segment_coverage Implement tombstoning to allow for segment deletion 2 years ago
sheetsync Read dynamic playlist manager config from sheet 3 years ago
thrimbletrimmer When padding video in editor, maintain video playback position in the same spot when possible 3 years ago
thrimshim Improve WSGIServer graceful shutdown handling 3 years ago
.gitignore Add some existing scripts for setting up prometheus 6 years ago
.prettierrc.yaml Auto-format JS files with prettier 3 years ago
.travis.yml Add ability to explicitly pull and re-use layers from other commits when building 5 years ago
DATABASE.md Set up plumbing for multi-range videos and implement no-transition fast cut videos only 3 years ago
INSTALL.md Add playlist manager to all the various other places 4 years ago
LICENSE Update LICENSE 5 years ago
README.md Add playlist manager to all the various other places 4 years ago
SecurityModel.md Update SecurityModel.md 5 years ago
build switch from quay.io to ghcr.io for image registry 3 years ago
docker-compose.jsonnet Read dynamic playlist manager config from sheet 3 years ago
generate-docker-compose replace readlink -f with realpath in build scripts 5 years ago
generate-flamegraph generate-flamegraph: Script to create a flamegraph by querying prometheus 6 years ago
get-build-tag replace readlink -f with realpath in build scripts 5 years ago
initial-design-doc.pdf Add initial design doc 6 years ago
k8s.jsonnet Fix default k8s.jsonnet PVC capacity 3 years ago

README.md

Wubloader is a system for saving, re-serving and cutting into videos of a target twitch (or probably other HLS, but some twitch specifics are assumed) stream.

It was designed to serve the needs of the Video Strike Team as part of Desert Bus For Hope.

A full design doc can be read at initial-design-doc.pdf, but a brief overview of the components:

  • downloader grabs segments from twitch and saves them to disk
  • restreamer serves segments from disk as well as playlist files allowing them to be streamed
  • backfiller queries restreamers of other servers in order to pick up segments this server doesn't have already, ie. it replicates missing segments.
  • cutter interacts with a database to perform cutting jobs
  • sheetsync syncs specifc database columns to a google doc which is the primary operator interface.
  • thrimshim acts as an interface between the thrimbletrimmer editor and the database.
  • thrimbletrimmer is a browser based video editor.
  • segment_coverage regularly checks whether there is complete segment coverage for each hour.
  • playlist_manager adds videos to youtube playlists depending on tags.
  • database hosts a Postgres database to store events to be edited.
  • nginx provides a webserver through which the other components are exposed to the outside world.
  • common provides code shared between the other components.
  • monitoring provides dashboards to allow the wubloader to be monitored.

Usage

All components are built as docker images. Components which access the disk expect a shared directory mounted at /mnt.

A docker-compose file is provided to run all components. See docker-compose.jsonnet to set configuration options, then generate the compose file with ./generate-docker-compose. Then run docker-compose up.

There is also a kubernetes-based option, but it is less configurable and only supports replication nodes. See k8s.jsonnet for details.

Further details of installing and configuring the backfiller are provided in INSTALL.md.