Extensions

Extensions are optional features that can be useful to be activated in certain cases such as when you need a reverse proxy or a database server.

MySQL

This extension deploys a MySQL server. It’s useful if you don’t have a database server available or if you are just performing a platform demo.

extra_vars.yml:

...

# enable and customize extensions
extensions:
  mysql:
    enable: true
    # docker image and version to use
    image:
      repository: mysql
      tag: 8.0.31
    # generate random passwords at launch time
    generate_passwords: true
    # use a custom seed when password generation is enabled
    # if not defined will be equal to global random_generation_seed
    # password_seed: ""
    params:
      database: meaningcloud
      user: mc-user
      password: mc-pass
      root_password: mc-rootpass
      # path of the bootstrap container where sql files to load at start are (mount a volume from the host to pass files)
      init_scripts_path: /mnt/onpremise/db/init

Disclaimer

It is your responsibility the management of the database, it is recommended to do regular backups to be protected in case of any failure.

It is also recommended to perform a backup before starting the platform update process.

Adminer

Manage the database using a WEBUI portal using adminer.

extra_vars.yml:

...

# enable and customize extensions
extensions:
  adminer:
    enable: true
    image:
      repository: adminer
      tag: latest
    params:
      # hostname or IP of the database server
      server: mydb.com

Note: The adminer extension will be accessible at http(s)://<platform_host>/dbadmin/.

Caddy

Deploy a reverse proxy to control and secure the access to the platform using caddy.

extra_vars.yml:

...

# enable and customize extensions
extensions:
  caddy:
    enable: true
    image:
      repository: caddy
      tag: 2.6.2-alpine
    params:
      http_port: 80
      # Enables HTTPS and automatic certificate generation using Let's Encrypt or ZeroSSL
      https_enable: true
      # Port used to serve HTTPS (443 is recommended)
      https_port: 443
      # MANDATORY if http_enable is true, define the reverse proxy domain or address to enroute requests (https://caddyserver.com/docs/caddyfile/concepts#addresses)
      addresses:
        - mconpremise.example.com

Monitoring

Coming soon

Enhanced Platform Monitoring

Monitor the platform with the provided platform dashboards or create your own to suit your needs. \

Get usage statistics and resources usage.

Prometheus, Grafana