adshares.adservice
Adshares / Adservice Ansible role
Report a bug · Request a feature · Documentation
Adshares Adservice
This software installs and sets up the Adshares adserver with all the needed components.
Requirements
- You need a domain with 3 subdomains for AdServer, AdPanel, and AdUser (default
app.
,panel.
, andau.
) directed to the server.
Role Variables
service_name: Required. Choose from these services:
adserver
,adpanel
,adselect
,aduser
,adpay
,adcontroller
.setup: Set to false by default. Change to true to enable the installation of necessary libraries and packages for the service.
deploy: Set to false by default. Change to true for deploying or updating the service.
server_domain: Default is localhost. Set the domain for public services (like example.com).
adserver_prefix: Default is
app
. Set the AdServer module domain prefix (like app.example.com).adpanel_prefix: Default is
panel
. Set the AdPanel module domain prefix (like panel.example.com).aduser_prefix: Default is
au
. Set the AdUser module domain prefix (like au.example.com).use_certbot: Set to true by default. This enables the use of certbot (for Let's Encrypt).
vendor_dir: Default is
/opt/adshares
. This is where the service will be installed.log_dir: Default is
/var/log/adshares
. This is where the service logs will be stored.service_user: Default is
adshares
. This is the user for installing the service.repo_version: Default is
master
. This is the version of the service code.clean_after_days: Default is 7. This sets how many days to keep old version files.
Dependencies
Example Playbook
To install all modules:
- hosts: servers
roles:
- role: adshares.adservice
vars:
service_name: "{{ item }}"
server_domain: example.com
setup: true
deploy: true
loop:
- adserver
- adpanel
- adselect
- aduser
- adpay
- adcontroller
To update all modules:
- hosts: servers
roles:
- role: adshares.adservice
vars:
service_name: "{{ item }}"
deploy: true
loop:
- adserver
- adpanel
- adselect
- aduser
- adpay
- adcontroller
Contributing
Please follow our Contributing Guidelines
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Authors
- Maciej Pilarczyk - Developer
- Paweł Podkalicki - Developer
Check the list of contributors who helped with this project.
Related projects
License
This is free software: you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
The software is distributed with the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for details.
You should have received a copy of the License with this software. If not, see https://www.gnu.org/licenses/gpl.html.