Metabase Setup instructions, a Spring Boot Quick Start Guide, Metabase Showcase app, Dashboard Viewer app, PostgreSQL Database
This repository is no longer maintained. Please visit https://github.com/bcgov/nr-showcase-devops-tools/tree/master/tools/metabase for maintained documentation on deploying and managing a Metabase instance on Openshift.
This repository includes 2 pieces that were used to set up a prrof-of-concept application that would display Metabase dashboards to authorized IDIR users.
The Viewer is an application that is meant to display existing Metabase dashboard embeds in a secured web app. It will require an existing Metabase instance with dashboards set up and ready to be embedded.
If you do not already have a Metabase instance set up, the quickstart guide here may be of use: https://github.com/bcgov/nr-metabase-showcase/blob/master/docs/metabase.md
The developent machine must have Java 8 and Maven installed. An IDE such as IntelliJ or Eclipse can be used, but the app can be started from the command line as well.
A Keycloak realm with an Client configured for this app to use must be available.
See the https://github.com/bcgov/nr-metabase-showcase/blob/master/src/main/resources/application.properties file for a list of environment variables that will be pulled in as configuration.
You can set up the environment variables as named in that file, or use the pattern of having a local configuration file (application-local.properties) and starting the app with a spring profile of local (-Dspring.profiles.active=local).
If you do not require sending emails via the Contact controller in this app, then the CHES properties are not required.
Start the Spring Boot web app up with
mvn spring-boot:run