Files
ansible-directadmin/README.md
hyperized 0e45d8daf0 Update README.md
Ensure become: yes is set, root access is required.
2016-07-27 01:03:43 +02:00

62 lines
1.5 KiB
Markdown

Ansible-directadmin
=========
[![Build Status](https://travis-ci.org/hyperized/ansible-directadmin.svg?branch=master)](https://travis-ci.org/hyperized/ansible-directadmin)
Deploy [DirectAdmin](https://directadmin.com/) with Ansible
Requirements
------------
- A DirectAdmin license is required.
- A clean machine is required. DirectAdmin will actively overwrite existing packages.
- A publicly reachable IP is required.
- Root access to the target machine is required. For details, read: [Step 3](https://www.directadmin.com/installguide.php)
Ansible 2.1 is highly recommended.
Role Variables
--------------
Its recommended that you use either the `group_vars` / `host_vars` to set the required variables per server:
directadmin_client_id:
directadmin_license_id:
directadmin_hostname: # Optional, will be obtained from server
directadmin_ip_address: # Optional, will be obtained from server
If you wish to use a custom custombuild configuration, please configure:
directadmin_custombuild_options_conf: http://yourdomain.com/options.conf
Dependencies
------------
As of present there are no dependent roles. (They may be added later)
Recommended to have installed on your server are:
- Firewall
- SSH protection (Fail2Ban)
- Kernel hardening
FreeBSD support may be added later.
Example Playbook
----------------
- hosts: servers
become: yes
roles:
- { role: hyperized.directadmin }
License
-------
MIT
Author Information
------------------
Gerben Geijteman <gerben@hyperized.net>