Skip to content

Latest commit

 

History

History
37 lines (32 loc) · 2.42 KB

README.md

File metadata and controls

37 lines (32 loc) · 2.42 KB

RTMP Streaming with Ansible

A quick Sunday project using Vagrant / Ansible to provision an Ubuntu 14.04 server with nginx, RTMP, and a front-end to view the stream from.

Requirements

Usage

  • Clone the repository and cd to it
  • Run vagrant up
  • Watch the Vagrant and Ansible output fly up your terminal
  • Be patient when you hit the last task (Download sample video to host over RTMP)
  • If all tasks are successful, navigate to http://192.168.50.1:8080/ in your browser
  • Watch the stream
  • To remove the VM, run vagrant -f destroy

Notes

  • Since this was a one-day project, there are no guarantees that it will work for you. However, if you run into problems, feel free to open an issue and I'd be happy to help you resolve it.
  • The nginx role is heavily inspired by this repo
  • I referenced this Ansible quickstart tutorial to refresh and get started
  • The RTMP setup is based on this tutorial that I worked through a few weeks ago
  • The front-end uses an Adobe Flash-based plugin called FlowPlayer
  • I purposely included the video download task so that the server is actually streaming the video file locally
    • In the future, I would include the video file in the repository using GitHub's new LFS system. And if I felt like paying money, Amazon S3 would be way more convenient for a project like this

Troubleshooting

  • I went to http://192.168.50.1:8080/ and nothing came up
    • It's possible that Vagrant did something different for the VirtualBox interface.
    • Run ifconfig | grep 192 and try navigating to port 8080 on that interface instead
  • Vagrant gave me this message: "Vagrant cannot forward the specified ports on this VM..."
    • The current Vagrantfile configures port forwarding for ports 8080 (web) and 1935 (rtmp)
    • You may have another Vagrant instance running on this interface that is occupying one of those ports
    • Open VirtualBox and see if any other VMs running conflict with this
  • I hate that you chose the Toy Story 3 trailer for the demo video
    • There is no hope for you