openvidu
Version information
This version is compatible with:
- Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2016.4.x
- Puppet >= 4.10.0 < 7.0.0
- ,
Start using this module
Add this module to your Puppetfile:
mod 'alisio-openvidu', '0.1.9'
Learn more about managing modules with a PuppetfileDocumentation
Openvidu Server
Table of Contents
Description
This module allows you to install Openvidu-server and its dependencies. You will be able to deploy an OpenVidu based video conference server.
For more info on OpenVidu, please refer to the project documents website. This module as loosely based on the "Deploying OpenVidu on Ubuntu" document
Setup
What openvidu affects
The following package and dependencies are installed:
- kurento-media-server
- coturn
- redis-server
- openjdk-8-jre
- unzip
- Docker (service is needed for video recording and it is installed)
Beginning with openvidu
To install an openvidu server:
class {'openvidu':
public_ip => '192.168.33.10',
network_interfaces => 'eth0',
secret => 'MY_SECRET',
}
Usage
Reference
Parameters
public_ip
- The public IP address of your server. No defaultpublic_url
- The public url address of your server (string). Default is the public ipnetwork_interfaces
- The network interfaces listening (csv list). Default 'eth0'docker_repo_install
- Control docker installation (true). Use it according yo your needs. Default 'trueinstall_path
- The OpenVidu install path (string). Default '/opt/openviduserver'jks_path
- Path for using custom JKS certificatejks_alias
- Alias for the custom JKSPassword for the custom JKSjks_store_password
- Password for the custom JKSkms_repo_install
- Control kms repo install (boolean). Default to trueopenvidu_version
- The version of the Kurento-media-server (string). Default '2.12.0'kms_version
- The version of the Kurento-media-server (string). Default '6.13.0'kms_uris
- KMS URL's to which OpenVidu Server will try to connect. They are tested in order until a valid one is found (array). Default Value ''logfile
- The OpenVidu logfile path (string). Default '/var/log/openvidu.log'logfile_error
- The OpenVidu error logfile path (string). Default '/var/log/openvidu_error.log'recording
- Enable or disable video recording (boolean). Default truerecording_autostop
- Time in seconds to stop recording a finalized conference (integer). Default '0'recording_path
- Path where the video files are recorded (string). Default '/opt/openviduserver/recording'secret
- Openvidu APP Secret (string). Default 'MY_SECRET'turnserver_enabled
- Enable or disable the included COTURN serverwebhook
- set it to true (boolean) to enable webhook service. Default falsewebhook_endpoint
- configure the HTTP endpoint where OpenVidu Server will send the POST messages with session events. Default 'http://localhost:8080/api/webhook/recordingStatusChanged'webhook_headers
- an array of HTTP headers that OpenVidu Server will append to each POST message. Default '["recording-path: /opt/openvidu/recording"]'webhook_events
- an array with the type of events you want OpenVidu Server to send to your webhook. Default '["recordingStatusChanged"]'
Limitations
This module is tested on the following platforms:
- Ubuntu 18.04
Development
Project URL: https://github.com/alisio/alisio-openvidu
Copyright 2019 Antonio Alisio de Meneses Cordeiro
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Changelog
All notable changes to this project will be documented in this file.
Release 0.1.9
Bugfixes
- Fix issue that prevented webhook config
Release 0.1.8
Bugfixes
- Change webhook parameter type to boolean instead of string
Release 0.1.7
Bugfixes
- Fix bug preventing install if kms or docker repo set to false
Release 0.1.6
Features
- add Webhook service config
- Add openvidu version parameter
Bugfixes
- Potential resource ordering issues
- Fix parameters description (README)
Release 0.1.5
Features
- Add option to set openvidu version
Release 0.1.4
Features
- add option to enable/disable kms repo install
- add option do enable/disable docker install
- Docker module is no longer needed
Bugfixes
Known Issues
Release 0.1.3
Features
- change default openvidu install folder
- add public_url variable
- remove hardcoded install_path
- Restart openvidu service when config file changes
- Add option to set your own certificate through java key store
- Separate error log using variable logfile_error
Bugfixes
Known Issues
Release 0.1.2
Features
- Add a parameter for setting the kurento media server uri.
Bugfixes
- Fix ordering issues
Known Issues
Release 0.1.1
Features
Bugfixes
- Declare dependencies in metadata.json
Known Issues
- There are ordering issues that cause dependencies problems. You should run puppet again to fix the issue
Release 0.1.0
First version
Features
Bugfixes
Known Issues
- There are ordering issues that cause dependencies problems. You should run puppet again to fix the issue
Dependencies
- puppetlabs-apt (>= 7.4.1 < 8.0.0)
- puppet-archive (>= 4.0.0 < 5.0.0)
- puppet-logrotate (>= 5.0.0 < 6.0.0)