Initial mumble server commit
This commit is contained in:
Kyle Stapp
commit
659e8eeef7
14
LICENSE
Normal file
14
LICENSE
Normal file
@ -0,0 +1,14 @@
|
||||
Copyright (c) 2013-2014 Salt Stack Formulas
|
||||
|
||||
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.
|
||||
|
||||
27
README.rst
Normal file
27
README.rst
Normal file
@ -0,0 +1,27 @@
|
||||
mumble-server
|
||||
=======
|
||||
Install and configure a mumble-server instance.
|
||||
|
||||
.. note::
|
||||
|
||||
See the full `Salt Formulas installation and usage instructions
|
||||
<http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
|
||||
|
||||
Available states
|
||||
================
|
||||
|
||||
.. contents::
|
||||
:local:
|
||||
|
||||
``mumble-server``
|
||||
-----------
|
||||
|
||||
Installs the ``mumble-server`` server package and service.
|
||||
|
||||
``mumble-server.config``
|
||||
------------------
|
||||
|
||||
Installs the mumble-server configuration file included in this formula
|
||||
(under "mumble-server/files"). This configuration file is populated
|
||||
by values from pillar. ``pillar.example`` results in the generation
|
||||
of the default ``mumble-server.ini`` file on Ubuntu 14.04 Trusty Tahr .
|
||||
15
mumble-server/config.sls
Normal file
15
mumble-server/config.sls
Normal file
@ -0,0 +1,15 @@
|
||||
{% from "vsftpd/map.jinja" import vsftpd with context %}
|
||||
|
||||
include:
|
||||
- vsftpd
|
||||
|
||||
vsftpd_config:
|
||||
file.managed:
|
||||
- name: {{ vsftpd.vsftpd_config }}
|
||||
- source: {{ vsftpd.vsftpd_config_src }}
|
||||
- template: jinja
|
||||
- user: root
|
||||
- mode: 644
|
||||
- watch_in:
|
||||
- service: {{ vsftpd.service }}
|
||||
|
||||
230
mumble-server/files/mumble-server.ini
Normal file
230
mumble-server/files/mumble-server.ini
Normal file
@ -0,0 +1,230 @@
|
||||
{%- set mumbleserver_config = pillar.get('mumbleserver_config', {}) -%}
|
||||
{#- present in mumbleserver_config and known in actual file options -#}
|
||||
{%- set processed_options = [] -%}
|
||||
|
||||
{#- generic renderer used for mumbleserver known options, -#}
|
||||
{#- and unknown options -#}
|
||||
{%- macro render_option(keyword, default, config_dict=mumbleserver_config) -%}
|
||||
{%- set value = config_dict.get(keyword, default) -%}
|
||||
{%- if value is string or value is number -%}
|
||||
{{ keyword }}={{ value }}
|
||||
{%- else -%}
|
||||
{%- for single_value in value -%}
|
||||
{{ keyword }}={{ single_value }}
|
||||
{% endfor -%}
|
||||
{%- endif -%}
|
||||
{%- endmacro -%}
|
||||
|
||||
{#- macros for render option according to present -#}
|
||||
{%- macro option_impl(keyword, default, present) -%}
|
||||
{%- if present -%}
|
||||
{%- do processed_options.append(keyword) -%}
|
||||
{%- set prefix='' -%}
|
||||
{%- else -%}
|
||||
{%- set prefix='#' -%}
|
||||
{%- endif -%}
|
||||
{#- add prefix to keyword -#}
|
||||
{%- set keyword = prefix ~ keyword -%}
|
||||
{{ render_option(keyword, default) }}
|
||||
{%- endmacro -%}
|
||||
|
||||
{#- macros for render option commented by default -#}
|
||||
{%- macro option(keyword, default, present) -%}
|
||||
{{ option_impl(keyword, default, keyword in mumbleserver_config) }}
|
||||
{%- endmacro -%}
|
||||
|
||||
{#- macros for render option uncommented by default -#}
|
||||
{%- macro option_default_uncommented(keyword, default, present) -%}
|
||||
{{ option_impl(keyword, default, True) }}
|
||||
{%- endmacro -%}
|
||||
#
|
||||
# This file is managed by salt. Manual changes risk being overwritten.
|
||||
# Murmur configuration file.
|
||||
#
|
||||
# General notes:
|
||||
# * Settings in this file are default settings and many of them can be overridden
|
||||
# with virtual server specific configuration via the Ice or DBus interface.
|
||||
# * Due to the way this configuration file is read some rules have to be
|
||||
# followed when specifying variable values (as in variable = value):
|
||||
# * Make sure to quote the value when using commas in strings or passwords.
|
||||
# NOT variable = super,secret BUT variable = "super,secret"
|
||||
# * Make sure to escape special characters like '\' or '"' correctly
|
||||
# NOT variable = """ BUT variable = "\""
|
||||
# NOT regex = \w* BUT regex = \\w*
|
||||
|
||||
# Path to database. If blank, will search for
|
||||
# murmur.sqlite in default locations or create it if not found.
|
||||
{{ option_default_uncommented('database', '/var/lib/mumble-server/mumble-server.sqlite') }}
|
||||
|
||||
# If you wish to use something other than SQLite, you'll need to set the name
|
||||
# of the database above, and also uncomment the below.
|
||||
# Sticking with SQLite is strongly recommended, as it's the most well tested
|
||||
# and by far the fastest solution.
|
||||
#
|
||||
{{ option('dbDriver', '') }}
|
||||
{{ option('dbUsername', '') }}
|
||||
{{ option('dbPassword', '') }}
|
||||
{{ option('dbHost', '') }}
|
||||
{{ option('dbPort', '') }}
|
||||
{{ option('dbPrefix', 'murmur_') }}
|
||||
{{ option('dbOpts', '') }}
|
||||
|
||||
# Murmur defaults to not using D-Bus. If you wish to use dbus, which is one of the
|
||||
# RPC methods available in Murmur, please specify so here.
|
||||
#
|
||||
{{ option_default_uncommented('dbus', 'system') }}
|
||||
|
||||
# Alternate D-Bus service name. Only use if you are running distinct
|
||||
# murmurd processes connected to the same D-Bus daemon.
|
||||
{{ option('dbusservice', 'net.sourceforge.mumble.murmur') }}
|
||||
|
||||
# If you want to use ZeroC Ice to communicate with Murmur, you need
|
||||
# to specify the endpoint to use. Since there is no authentication
|
||||
# with ICE, you should only use it if you trust all the users who have
|
||||
# shell access to your machine.
|
||||
# Please see the ICE documentation on how to specify endpoints.
|
||||
{{ option_default_uncommented('ice', '"tcp -h 127.0.0.1 -p 6502"') }}
|
||||
|
||||
# Ice primarily uses local sockets. This means anyone who has a
|
||||
# user account on your machine can connect to the Ice services.
|
||||
# You can set a plaintext "secret" on the Ice connection, and
|
||||
# any script attempting to access must then have this secret
|
||||
# (as context with name "secret").
|
||||
# Access is split in read (look only) and write (modify)
|
||||
# operations. Write access always includes read access,
|
||||
# unless read is explicitly denied (see note below).
|
||||
#
|
||||
# Note that if this is uncommented and with empty content,
|
||||
# access will be denied.
|
||||
|
||||
{{ option('icesecretread', '') }}
|
||||
{{ option_default_uncommented('icesecretwrite', '') }}
|
||||
|
||||
# How many login attempts do we tolerate from one IP
|
||||
# inside a given timeframe before we ban the connection?
|
||||
# Note that this is global (shared between all virtual servers), and that
|
||||
# it counts both successfull and unsuccessfull connection attempts.
|
||||
# Set either Attempts or Timeframe to 0 to disable.
|
||||
{{ option('autobanAttempts', '10') }}
|
||||
{{ option('autobanTimeframe', '120') }}
|
||||
{{ option('autobanTime', '300') }}
|
||||
|
||||
# Specifies the file Murmur should log to. By default, Murmur
|
||||
# logs to the file 'murmur.log'. If you leave this field blank
|
||||
# on Unix-like systems, Murmur will force itself into foreground
|
||||
# mode which logs to the console.
|
||||
{{ option_default_uncommented('logfile', '/var/log/mumble-server/mumble-server.log') }}
|
||||
|
||||
# If set, Murmur will write its process ID to this file
|
||||
# when running in daemon mode (when the -fg flag is not
|
||||
# specified on the command line). Only available on
|
||||
# Unix-like systems.
|
||||
{{ option_default_uncommented('pidfile', '/var/run/mumble-server/mumble-server.pid') }}
|
||||
|
||||
# The below will be used as defaults for new configured servers.
|
||||
# If you're just running one server (the default), it's easier to
|
||||
# configure it here than through D-Bus or Ice.
|
||||
#
|
||||
# Welcome message sent to clients when they connect.
|
||||
{{ option_default_uncommented('welcometext', '"<br />Welcome to this server running <b>Murmur</b>.<br />Enjoy your stay!<br />"') }}
|
||||
|
||||
# Port to bind TCP and UDP sockets to.
|
||||
{{ option_default_uncommented('port', '64738') }}
|
||||
|
||||
# Specific IP or hostname to bind to.
|
||||
# If this is left blank (default), Murmur will bind to all available addresses.
|
||||
{{ option('host', '') }}
|
||||
|
||||
# Password to join server.
|
||||
{{ option_default_uncommented('serverpassword', '') }}
|
||||
|
||||
# Maximum bandwidth (in bits per second) clients are allowed
|
||||
# to send speech at.
|
||||
{{ option_default_uncommented('bandwidth', '72000') }}
|
||||
|
||||
# Maximum number of concurrent clients allowed.
|
||||
{{ option_default_uncommented('users', '100') }}
|
||||
|
||||
# Amount of users with Opus support needed to force Opus usage, in percent.
|
||||
# 0 = Always enable Opus, 100 = enable Opus if it's supported by all clients.
|
||||
{{ option('opusthreshold', '100') }}
|
||||
|
||||
# Maximum depth of channel nesting. Note that some databases like MySQL using
|
||||
# InnoDB will fail when operating on deeply nested channels.
|
||||
{{ option('channelnestinglimit', '10') }}
|
||||
|
||||
# Regular expression used to validate channel names.
|
||||
# (Note that you have to escape backslashes with \ )
|
||||
{{ option('channelname', '[ \\-=\\w\\#\\[\\]\\{\\}\\(\\)\\@\\|]+') }}
|
||||
|
||||
# Regular expression used to validate user names.
|
||||
# (Note that you have to escape backslashes with \ )
|
||||
{{ option('username', '[-=\\w\\[\\]\\{\\}\\(\\)\\@\\|\\.]+') }}
|
||||
|
||||
# Maximum length of text messages in characters. 0 for no limit.
|
||||
{{ option('textmessagelength', '5000') }}
|
||||
|
||||
# Maximum length of text messages in characters, with image data. 0 for no limit.
|
||||
{{ option('imagemessagelength', '131072') }}
|
||||
|
||||
# Allow clients to use HTML in messages, user comments and channel descriptions?
|
||||
{{ option('allowhtml', 'true') }}
|
||||
|
||||
# Murmur retains the per-server log entries in an internal database which
|
||||
# allows it to be accessed over D-Bus/ICE.
|
||||
# How many days should such entries be kept?
|
||||
# Set to 0 to keep forever, or -1 to disable logging to the DB.
|
||||
{{ option('logdays', '31') }}
|
||||
|
||||
# To enable public server registration, the serverpassword must be blank, and
|
||||
# this must all be filled out.
|
||||
# The password here is used to create a registry for the server name; subsequent
|
||||
# updates will need the same password. Don't lose your password.
|
||||
# The URL is your own website, and only set the registerHostname for static IP
|
||||
# addresses.
|
||||
# Only uncomment the 'registerName' parameter if you wish to give your "Root" channel a custom name.
|
||||
#
|
||||
{{ option('registerName', 'Mumble Server') }}
|
||||
{{ option('registerPassword', 'secret') }}
|
||||
{{ option('registerUrl', 'http://mumble.sourceforge.net/') }}
|
||||
{{ option('registerHostname', '') }}
|
||||
|
||||
# If this option is enabled, the server will announce its presence via the
|
||||
# bonjour service discovery protocol. To change the name announced by bonjour
|
||||
# adjust the registerName variable.
|
||||
# See http://developer.apple.com/networking/bonjour/index.html for more information
|
||||
# about bonjour.
|
||||
{{ option('bonjour', 'True') }}
|
||||
|
||||
# If you have a proper SSL certificate, you can provide the filenames here.
|
||||
# Otherwise, Murmur will create it's own certificate automatically.
|
||||
{{ option('sslCert', '') }}
|
||||
{{ option('sslKey', '') }}
|
||||
|
||||
# If Murmur is started as root, which user should it switch to?
|
||||
# This option is ignored if Murmur isn't started with root privileges.
|
||||
{{ option_default_uncommented('uname', 'mumble-server') }}
|
||||
|
||||
# If this options is enabled, only clients which have a certificate are allowed
|
||||
# to connect.
|
||||
{{ option('certrequired', 'False') }}
|
||||
|
||||
# If enabled, clients are sent information about the servers version and operating
|
||||
# system.
|
||||
{{ option('sendversion', 'True') }}
|
||||
|
||||
# You can configure any of the configuration options for Ice here. We recommend
|
||||
# leave the defaults as they are.
|
||||
# Please note that this section has to be last in the configuration file.
|
||||
#
|
||||
[Ice]
|
||||
{{ option_default_uncommented('Ice.Warn.UnknownProperties', '1') }}
|
||||
{{ option_default_uncommented('Ice.MessageSizeMax', '65536') }}
|
||||
|
||||
{# Handling unknown in salt template options #}
|
||||
{%- for keyword in mumbleserver_config.keys() %}
|
||||
{%- if not keyword in processed_options -%}
|
||||
{#- send a blank default as it doesn't matter #}
|
||||
{{ render_option(keyword, '') }}
|
||||
{%- endif -%}
|
||||
{%- endfor %}
|
||||
14
mumble-server/init.sls
Normal file
14
mumble-server/init.sls
Normal file
@ -0,0 +1,14 @@
|
||||
{% from "mumbleserver/map.jinja" import mumbleserver with context %}
|
||||
|
||||
mumbleserver:
|
||||
{% if mumbleserver.server is defined %}
|
||||
pkg.installed:
|
||||
- name: {{ mumbleserver.server }}
|
||||
{% endif %}
|
||||
service.running:
|
||||
- enable: True
|
||||
- name: {{ mumbleserver.service }}
|
||||
{% if mumbleserver.server is defined %}
|
||||
- require:
|
||||
- pkg: {{ mumbleserver.server }}
|
||||
{% endif %}
|
||||
8
mumble-server/map.jinja
Normal file
8
mumble-server/map.jinja
Normal file
@ -0,0 +1,8 @@
|
||||
{% set mumbleserver = salt['grains.filter_by']({
|
||||
'Debian': {
|
||||
'server': 'mumble-server',
|
||||
'service': 'mumble-server',
|
||||
'mumbleserver_config': '/etc/mumble-server.ini',
|
||||
'mumbleserver_config_src': 'salt://mumble-server/files/mumble-server.ini',
|
||||
},
|
||||
}, merge=salt['pillar.get']('mumbleserver:lookup')) %}
|
||||
15
pillar.example
Normal file
15
pillar.example
Normal file
@ -0,0 +1,15 @@
|
||||
mumbleserver_config:
|
||||
database: '/var/lib/mumble-server/mumble-server.sqlite'
|
||||
dbus: 'system'
|
||||
ice: '"tcp -h 127.0.0.1 -p 6502"'
|
||||
icesecretwrite: ''
|
||||
logfile: '/var/log/mumble-server/mumble-server.log'
|
||||
pidfile: '/var/run/mumble-server/mumble-server.pid'
|
||||
welcometext: '"<br />Welcome to this server running <b>Murmur</b>.<br />Enjoy your stay!<br />"'
|
||||
port: '64738'
|
||||
serverpassword: ''
|
||||
bandwidth: '72000'
|
||||
users: '100'
|
||||
uname: 'mumble-server'
|
||||
Ice.Warn.UnknownProperties: '1'
|
||||
Ice.MessageSizeMax: '65536'
|
||||
Loading…
Reference in New Issue
Block a user