Forge Home

superset

Module for managing the installation and configuration of Apache Superset

1,166 downloads

34 latest version

3.1 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 2.0.0 (latest)
  • 1.0.0
  • 0.1.1
  • 0.1.0
released Sep 30th 2024
This version is compatible with:
  • Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2021.7.x
  • Puppet >= 7.24.0 < 9.0.0
  • ,
Tasks:
  • delete_superset_venv

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'jortencio-superset', '2.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jortencio-superset
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jortencio-superset --version 2.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

jortencio/superset — version 2.0.0 Sep 30th 2024

superset

A Puppet module that is used for installing and configuring Apache Superset which is a data exploration and visualization platform.

For more information, please visit Apache Superset.

Table of Contents

  1. Description
  2. Setup - The basics of getting started with superset
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module

Description

This Puppet module is used to do basic installation and configuration of Apache Superset.

Setup

What superset affects

Superset module installs and configures the following:

  • Superset dependencies
  • Python (Optional)
  • Creates a Python virtual environment and installs dependent Python Libraries (including superset) within it
  • Configures Firewalld on RHEL (Optional)
  • Installs and configures a basic Postgresql Database as a Superset Back-end (Optional)
  • Manages a Gunicorn web server for hosting superset (Optional)

Any of the services marked as (Optional) above can be managed seperately by setting the relevant parameters to false (See reference)

Setup Requirements

In order to use this module, make sure to have the following Puppet modules installed:

  • puppetlabs-stdlib
  • puppet-python
  • puppet-epel
  • puppetlabs-yumrepo_core
  • puppet-firewalld
  • puppetlabs-augeas_core
  • puppetlabs-postgresql
  • puppetlabs-apt
  • puppetlabs-concat

Beginning with superset

In order to get started with the superset Puppet module with a basic configuration (Basic Install of Apache Superset with Python, Gunicorn, Postgresql installed/configured)

include superset

Usage

This module supports the use of Hiera data for setting parameters. Please refer to REFERENCE.md for a list of configurable parameters

Common Usage

Setup Superset with a configured admin user

class { 'superset':
    admin_username  => '<username>',
    admin_password  => '<password>',
    admin_firstname => '<firstname>',
    admin_lastname  => '<password>',
    admin_email     => '<email>',
}

Setup Superset to manage firewalld on RedHat Linux

class { 'superset':
  manage_firewall => true,
}

Change default database in Superset config file (superset_config.py)

class { 'superset':
  manage_db                      => false,
  config_sqlalchemy_database_uri => <Database URI>,
}

Note: To see a list of supported databases and format for sqlalchemy_database_uri, please see: Installing Database URI

Note 2: When installing on another database, please also configure the superset::db_drivers to include additional database drivers. By default, the postgresql driver will already be included in this list.

Setting sensitive data

To set sensitive data such as admin the postgresql DB password, use the Sensitive in a class declaration. e.g.:

class { 'superset':
  pgsql_password => Sensitive('<password>'),
}

Alternatively, use lookup_options in hiera. e.g.:

---
lookup_options:
  superset::pgsql_password:
    convert_to: "Sensitive"

superset::pgsql_password: '<password>'

Setting a gunicorn worker class:

In class declaration:

class { 'superset':
  gunicorn_worker_class => 'tornado',
}

In Hiera:

---
superset::gunicorn_worker_class: "tornado"

Limitations

The Superset module has a number of limitations:

  • It has only been tested to work on RedHat 8, RedHat9, Ubuntu 20.04, Ubuntu 22.04
  • Superset app configuration file limited to options currently specified in the epp template
  • It is currently only to install the current latest version of the python Superset library. As at this release it is version 4.0.2 (Except for Ubuntu 20.04 install which installs 2.1.3 by default)
  • The admin parameters are limited in that any previously configured admin users will remain in Superset's DB and will need to be removed manually within the Superset
    • i.e. Log in as a user with the Admin role, click on Settings and under Security click on List User. Here you can see the previous admin user and delete the entry

Development

If you would like to contribute with the development of this module, please feel free to log development changes in the issues register for this project or submit a Pull Request.