Generic Template Reporting for the A2CPS program

Docker container of Dash App to display A2CPS trial Generic Template reporting metrics.

Version History

Version	Date	Description
0.0.1	date	Status

Development Previews

Development previews are built upon commits to the master branch. If you wish to preview the latest build, you may use the docker-compose.yml file. On your local machine with Docker, run:

docker-compose up --force-recreate

Then browse to localhost:8050 in your web browser.

Automatic Container Build information from parent repository.

This repository was forked from the TACC dash-container repo.

Configuring your repository for automatic container builds (text from original repo)

Github Actions workflows

This repository comes with two Github Action workflows that automatically build Docker containers:

build-pr builds commit sha tagged images upon pull requests
build-main builds a commit sha tagged and :latest tagged image upon pushes to main (such as when merging a pull request)

Both require specific Github repo configuration.

Setting up a Dockerhub token

You will need to create a token for the account that will be used to push your repo.

On Dockerhub go to your account's security settings.
Click the New Access Token button and type in a description
You will see a UUID value - this is your access token. Copy it immediately, as these can only be read upon creation. You will not see this token again.

Setting up a Github Actions environment

You will need to create a build environment with secrets to contain Dockerhub settings.

In your Github repo, click on Settings. Then click on Environments
Click on the New Environment button and name this environment docker. (You can change the environment value in the workflows if you wish to call it something else or keep multiple environments)
At the bottom of the screen you will see Environment Secrets. Click the Add Secret button to create secrets.
Create a secret called DOCKERHUB_TOKEN and paste your Dockerhub token here
Create a secret called DOCKERHUB_USERNAME and put the name of the corresponding user here
Create a secret called DOCKERHUB_REPO and put your Docker repository name here. For example, this Github repo autobuilds images at jchuahtacc/dash-container, so that is the value that is used for DOCKERHUB_REPO.

Test it out

Upon pull requests and pushes to main, you will see the workflows perform autobuilds. You can view the Action results by going to the Actions tag of your repo. You can also go to your Dockerhub page and make sure images are properly getting tagged and pushed

TACC / a2cps-report-template