Read this in other languages: **.
rotisserie takes the concept of the red zone in American football and applies it to the popular online battle royale game PLAYERUNKNOWN'S BATTLEGROUNDS. The idea is to always be viewing the most popular PUBG twitch stream with the least amount of people alive in-game.
The following pieces of software are required to run rotisserie locally:
You can install these dependencies with one of the two following commands, depending on your os:
- Ubuntu:
$ sudo apt-get install tesseract-ocr ffmpeg imagemagick
$ pip install livestreamer
- macOS:
$ brew install tesseract ffmpeg imagemagick
$ pip install livestreamer
Create a Kubernetes cluster with either Minikube for local testing, or with IBM Bluemix Container Service to deploy in cloud. The code here is regularly tested against Kubernetes Cluster from Bluemix Container Service using Travis.
- Get an OAuth Token for livestreamer
- Setting up Environment Variables
- Build the images
- Deploy locally
- Deploy using Docker
- Deploy using Kubernetes
- On a machine with a browser installed, run the following:
$ livestreamer --twitch-oauth-authenticate
-
A browser window will open, and prompt you to authorize livestreamer to use your twitch account. Click
Authorize
. -
Your browser will refresh, and a page saying "SORRY, this page does not exist yet" will appear. Ignore this. In your address bar, there will be a callback URL with
access_token=<TOKEN>
. This is your OAuth token, copy it down and proceed to the next section.
- Create an environment variable for your docker username.
$ export docker_username="YOUR_DOCKER_USERNAME"
- Create an enviornment variable for your token you retrieved in the previous step.
$ export token="YOUR_OAUTH_TOKEN"
- Create an environment variable for your clientID.
You must create an app in your Twitch account using the developer mode (https://dev.twitch.tv/) to retrieve the clientID
$ export clientID="YOUR_CLIENT_ID"
- Create an environment variable for the ROTISSERIE_OCR_SERVICE_HOST and ROTISSERIE_OCR_SERVICE_PORT. This can be set to
localhost
and3001
if running locally, or the IP address and port of a remote OCR host if running in containers. Mimic the environment variables exported by kubernetes.
$ export ROTISSERIE_OCR_SERVICE_HOST="localhost"
$ export ROTISSERIE_OCR_SERVICE_PORT="3001"
- Clone the repo.
$ git clone https://github.com/IBM/rotisserie.git
$ cd rotisserie
- Build and Push the Docker Image. You would need to push it if you want to deploy the application in Kubernetes.
$ docker build -t $docker_username/rotisserie-ocr -f deploy/images/ocr.Dockerfile .
$ docker build -t $docker_username/rotisserie-app -f deploy/images/app.Dockerfile .
$ docker push $docker_username/rotisserie-ocr
$ docker push $docker_username/rotisserie-app
- Install with npm.
$ npm install .
- Navigate to the
rotisserie
dir if you aren't there already, and start the app:
$ node ocr.js 2>&1 >/dev/null &
$ node app.js
Now you can open a browser and navigate to http://localhost:3000
to watch
rotisserie.
You can also run rotisserie in a docker container.
- Start up the containers:
$ docker run -d -p 3001:3001 --name rotisserie-ocr $docker_username/rotisserie-ocr
$ docker run -d -p 3000:3000 --name rotisserie-app -e ROTISSERIE_OCR_SERVICE_HOST=$ROTISSERIE_OCR_SERVICE_HOST -e ROTISSERIE_OCR_SERVICE_PORT=$ROTISSERIE_OCR_SERVICE_PORT -e token=$token -e clientID=$clientID $docker_username/rotisserie-app
Now you can open a browser and navigate to http://localhost:3000
to watch
rotisserie.
note: Ensure your $OCR_HOST
environment variable is set to the cluster_public_ip:3001
.
- Create a Kubernetes Secret for your OAuth token. You will need to encode the data you want in Base64 for the Kubernetes Secret.
$ echo -n "YOUR_OAUTH_TOKEN" | base64
- Modify the rotisserie-secrets.yaml file to use your token
...
data:
token: YOUR_OAUTH_TOKEN_IN_BASE64
- Finally, create the Kubernetes Secret.
$ kubectl create -f rotisserie-secrets.yaml
- Modify the
rotisserie-app.yaml
androtisserie-ocr.yaml
yaml files to use your image.
...
containers:
- name: rotisserie-app
image: <docker_username>/rotisserie-app
- Deploy the OCR service then the main application.
$ kubectl apply -f rotisserie-ocr.yaml
$ kubectl apply -f rotisserie-app.yaml
- To access your application. You would need the public IP address of your cluster. If you don't have a load balancer, you can use the Node Port.
# For clusters provisioned with Bluemix
$ bx cs workers YOUR_CLUSTER_NAME
# For Minikube
$ minikube ip
- Now you can go to
http://IP_ADDRESS:30080
The production version of rotisserie has slightly different operational procedures. The production kubernetes manifest is located in the deploy directory. It is typically interacted with via the provided Makefile. Major differences between the production rotisserie and the one used in the developer journey are use of ingress controllers in kuberenetes and adding Letsencrypt.
There are a few commands we can use to work with the deployment.
To deploy without letsencrypt use make roll
make roll
To deploy with letsencrypt use make full-roll
make full-roll
To redeploy the deployments, without removing svc/ing/other, use make redeploy
make redeploy
To delete the entire deployment we can use make purge
make purge
Note: this depends on you deploying with a unique sha. See the 'make-rev' rule in the Makefile. In most cases git pull; make roll
should work. In cases where a roll failed or the app failed for reasons not connected to the code, a dummy commit might need to be added before re-rolling. Please only roll from master.
To allowlist simply set an environment variable called ROTISSERIE_ALLOWLIST
to a string with space separated usernames. Same with blocklisting, but with the environment variable ROTISSERIE_BLOCKLIST
.
This code pattern is licensed under the Apache Software License, Version 2. Separate third party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 (DCO) and the Apache Software License, Version 2.