masson/commons/mysql/server/configure.coffee.md

Module execution engine for cluster deployments.

# Mysql Server Configure

*   `current_password` (string)
*   `password` (string)
*   `my_cnf` (object)
    Object to be serialized into the "ini" format inside "/etc/my.cnf"
*   `root_host` (string|boolean)   
    Open root access to all host by default, set to "false" to disable it.

Note, root access is activated by default in order to let other service to 
provision their databases and user access.

## Default configuration

```
{ "mysql": { "server": {
  "current_password": "",
  "password": "{secret}",
  "my_cnf": {
    "mysqld": {
      "port": 3306
    }
  },
  "root_host": "%"
} } }
```

    export default (service) ->
      options = service.options

## Validation

      throw Error "Required Option: options.admin_password" unless options.admin_password

## Environment

      # Secure Installation
      options.current_password ?= ''
      options.root_host ?= '%'
      options.iptables ?= service.deps.iptables and service.deps.iptables.options.action is 'start'

## Identities

      # Group
      options.group ?= {}
      options.group = name: options.group if typeof options.group is 'string'
      options.group.name ?= 'mysql'
      # User
      options.user ?= {}
      options.user = name: options.user if typeof options.user is 'string'
      options.user.name ?= 'mysql'
      options.user.home ?= "/var/lib/#{options.user.name}"
      options.user.gid ?= options.group.name

## Configuration

      # Main config file
      options.my_cnf ?= {}
      options.my_cnf['mysqld'] ?= {}
      options.my_cnf['mysqld']['port'] ?= '3306'
      options.my_cnf['mysqld']['pid-file'] ?= '/var/run/mysqld/mysqld.pid'

## Repository

      options.repo ?= {}
      # options.repo.url ?= 'http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm'
      options.repo.source ?= null
      options.repo.url = null if options.repo.repo?

## Wait

      options.wait_tcp = {}
      options.wait_tcp.fqdn = service.node.fqdn
      options.wait_tcp.port = options.my_cnf['mysqld']['port']