diff --git a/README.Rmd b/README.Rmd index c55034c..4a6f321 100644 --- a/README.Rmd +++ b/README.Rmd @@ -49,6 +49,21 @@ installation you choose should have synapseclient installed. Because dccvalidator uses reticulate, it is not compatible with the [synapser](https://r-docs.synapse.org/) package. +## Dockerize the App +### Authentication +The dccmonitor can be authorized to log in to Synapse using Synapse Authentication (OAuth) client. Please view instructions [here](https://help.synapse.org/docs/Using-Synapse-as-an-OAuth-Server.2048327904.html#UsingSynapseasanOAuthServer-RegisteringandLinkinganOAuth2.0Client) to learn how to request a client. Our OAuth clients were created using Synapse service accounts in order to enable multiple Sage employees to maintain the applications. In the Shared-SysBio LastPass folder, credentials for each client are recorded. In the notes section of the credentials (click on the entry > Edit to see notes), the service account used to create the client is noted. + +### Build a docker image using Dockerfile +``` +docker build -t dccvalidator_pec -f Dockerfile . +``` + +### Create a container from the docker image +``` +docker run --rm -it -p 8100:3838 -e APP_REDIRECT_URL= -e R_CONFIG_ACTIVE=pec -e client_id= -e client_name= -e client_secret= --name dccvalidator_pec +``` +Once the container is created, you can head to the APP_REDIRECT_URL you specified to enter the app. + ## Check data dccvalidator provides functions for checking the following common data quality diff --git a/README.md b/README.md index 29fe0e2..a6b9a1e 100644 --- a/README.md +++ b/README.md @@ -45,10 +45,14 @@ The dccmonitor can be authorized to log in to Synapse using Synapse Authenticati ``` docker build -t dccvalidator_1kd -f Dockerfile . ``` +### Pull docker image from GitHub Container Registry +``` +docker pull ghcr.io/sage-bionetworks/dccvalidator_1kd:v1.0.0 +``` ### Create a container from the docker image ``` -docker run --rm -it -p 8100:3838 -e APP_REDIRECT_URL= -e R_CONFIG_ACTIVE=1kD -e client_id= -e client_name= -e client_secret= --name dccvalidator_1kd +docker run --rm -it -p 8100:3838 -e APP_REDIRECT_URL= -e R_CONFIG_ACTIVE=1kD -e client_id= -e client_name= -e client_secret= --name ``` Once the container is created, you can head to the APP_REDIRECT_URL you specified to enter the app.