guacamole-compose 0.0.9

Easy deployment of Apache Guacamole.

guacamole-compose

docker-compose script for running apache guacamole.

Overview

This set of scripts and templates automates the deployment process for guacamole.

• Generates the docker-compose script.
• Generates the mysql initialization script, to configure a new mysql database.
• Generates an nginx configuration.
• Has parameter options and templates, so you should just have to change a single parameter file for each deployment.
• Adds users to mysql from ldap.
• Configures connections from ldap.
• Configures additional manual connections from the paramters.yaml file.

Requirements

• docker
• docker-compose
• python3 (3.9)
• pip

Python Packages

• guacamole-compose

• Note, guacamole-compose will install the following packages:

  • sqlalchemy
  • docker
  • ldap3
  • pymysql
  • dnspython (v2.0.0)
  • pyyaml
  • cryptography
  • yamlarg

Usage

sudo python3.9 -m pip install --upgrade guacamole-compose
sudo guacamole-compose --init
sudo guacamole-compose --deploy --ldap

% guacamole-compose --help
usage: guacamole-compose [-h] [--init] [--clean] [--deploy] [--nginx] [--ldap]

optional arguments:
  -h, --help  show this help message and exit
  --init      Initialize the directory and files required.
  --clean     Clean the directories automatically created during deployment.
  --deploy    Generate configurations and deploy guacamole using docker-compose.
  --nginx     Generate the nginx.conf file located at./nginx/conf/nginx.conf.
  --ldap      Used to create/update connections, groups, and permissions using ldap.

Cleanup of shared directory, and periodic user sync.

Note: Check your python executable path, and modify for the cron entry below. Or just use 'python3.9' in the cron job, instead of the full path.

python3.9

import sys
print(sys.executable)

crontab -e

0 0 * * * find /root/guacamole-compose/shared/* -mtime +6 -type f -delete
*/5 * * * * cd /root/guacamole-compose && /usr/local/bin/python3.8 ./guac-deploy.py --create_users