Gluesync Automator Static Repository

Gluesync Automator is a standalone executable that provides a user-friendly web interface to run the Gluesync Bootstrapper’s create_all_entities.py script without requiring Python dependencies or command-line knowledge.

Open Source This project is Open Source

Overview

The Automator packages the Bootstrapper functionality into a single executable file that launches a local web server at http://localhost:8080. It provides a graphical interface for:

  • Authenticating with Gluesync Core Hub

  • Uploading YAML configuration files

  • Configuring entity creation options

  • Monitoring live logs during execution

  • Downloading logs for troubleshooting

This makes the Bootstrapper accessible to users who prefer graphical tools over command-line interfaces, while maintaining all the underlying automation capabilities.

Key features

  • Web-based interface

    • Accessible via any web browser at localhost:8080

    • Responsive design works on desktop and mobile devices

    • Gluesync-branded interface matching documentation styling

  • Simplified authentication

    • Secure login to Core Hub with TLS options

    • Certificate verification controls

    • Token management and validation

  • Configuration management

    • Drag-and-drop YAML file uploads

    • Validation of configuration files

    • Support for all Bootstrapper YAML formats

  • Entity creation options

    • Toggle automatic table creation

    • Enable/disable scheduling for entities

    • Skip errors option for batch processing

    • Configurable chunk sizes for large deployments

  • Real-time monitoring

    • Live streaming of execution logs

    • Color-coded status indicators (idle, running, completed, failed)

    • Progress tracking for entity creation

  • Cross-platform support

    • Native executables for Windows, macOS, and Linux

    • No installation required - run from any directory

    • Self-contained with all dependencies bundled

Installation

Download

Download the latest Automator executable from the official distribution site:

Executables are available for:

  • Windows (.exe)

  • macOS (.app)

  • Linux (.bin)

System requirements

  • Windows 10+, macOS 10.14+, or Linux with glibc 2.17+

  • 2GB RAM minimum

  • 100MB disk space for the executable

  • Internet connection for Core Hub communication

Usage

Launching the Automator

  1. Download the executable for your platform

  2. Run the file (double-click on Windows/macOS, or execute in terminal on Linux)

  3. The application will start a web server and open your default browser to http://localhost:8080

On macOS, you may need to right-click the .app file and select "Open" the first time to bypass Gatekeeper restrictions.

Using the web interface

Authentication

  1. Enter your Core Hub URL (e.g., https://localhost:1717)

  2. Provide your username and password

  3. Optionally configure TLS settings:

    • Enable TLS for secure connections

    • Skip certificate verification if using self-signed certificates

  4. Click "Login" to authenticate

Configuration upload

  1. Click "Choose File" to select your YAML configuration file

  2. The interface will validate the file format

  3. Configure additional options:

    • Enable/disable automatic table creation

    • Enable/disable scheduling for created entities

    • Set chunk size for batch processing

    • Choose to skip errors during execution

Running entity creation

  1. Click "Start" to begin the entity creation process

  2. Monitor progress through the live log output

  3. The status indicator will show "Running" during execution

  4. Upon completion, the status will change to "Completed" or "Failed"

Log management

  • View real-time logs in the integrated terminal window

  • Logs are automatically scrolled to show the latest output

  • Download full logs for troubleshooting or audit purposes

Configuration options

TLS configuration

  • Enable TLS: Forces HTTPS connections to the Core Hub

  • Skip Certificate Verification: Bypasses SSL certificate validation (useful for development with self-signed certificates)

Entity creation settings

  • Create missing tables: Controls whether the Bootstrapper should generate CREATE TABLE statements for target databases

  • Enable scheduling: Automatically enables scheduled execution for created entities

  • Skip errors: Continues processing even if individual entities fail to create

  • Chunk size: Number of entities to process simultaneously (affects memory usage and performance)

Troubleshooting

Common issues

Issue Possible cause Resolution

Application won’t start

Port 8080 is already in use

Close other applications using port 8080, or the Automator will prompt for an alternative port

Authentication fails

Incorrect Core Hub URL or credentials

Verify the Core Hub is accessible and credentials are correct

Configuration upload fails

Invalid YAML format

Validate your YAML file against the Bootstrapper schema

Entity creation errors

Network connectivity or Core Hub API issues

Check Core Hub logs and network connectivity

Slow performance

Large chunk sizes or many entities

Reduce chunk size or process entities in smaller batches

Log analysis

The Automator provides detailed logging for troubleshooting:

  • DEBUG: Detailed technical information for developers

  • INFO: General progress and status updates

  • WARNING: Non-critical issues that don’t stop execution

  • ERROR: Critical issues that may require attention

Best practices

  • Store configuration files in version control alongside your infrastructure code

  • Test configurations in a development environment before production deployment

  • Keep executables updated to the latest version for security and feature improvements

  • Use consistent naming conventions for pipelines, entities, and schemas

  • Document your configuration choices for team knowledge sharing

  • Monitor Core Hub and Automator logs regularly for early issue detection

Release notes

1.0.0

Released: November 2, 2025

  • Initial release of Gluesync Automator

  • Web-based UI for Bootstrapper functionality

  • Cross-platform executables (Windows, macOS, Linux)

  • Live log streaming and monitoring

  • Drag-and-drop configuration uploads

  • TLS and authentication options

  • Responsive design with Gluesync branding

References