Skip to content

Latest commit

 

History

History
78 lines (59 loc) · 4.56 KB

README.md

File metadata and controls

78 lines (59 loc) · 4.56 KB
Raw

Frontend, using Svelte and Vite, for interacting with open3p API microservice.

Development Instructions

Clone this repo and install Node.js. From the root directory of this repo, run:

npm install
npm run build
npm run dev

Typically hosted at http://localhost:5173/.

Folder Structure

  • /src contains App.svelte
  • /src/components contains DataInput.svelte this handles file send, schema routing and documentation
  • /src/components contains DataResult.svelte this handles result and validation file downloads

Production Instructions

A docker file and github workflow is included within this repository. When a release is created, the docker container is built and submitted to dockerhub.

It is assumed you already have accounts for Dockerhub and Github, along with a Docker instance set up for the built container to run on. If any information is needed on how ecosystem2 handles hosting, please reach to us via our website or email.

Seting up dockerhub access token

  • Once logged into Dockerhub, select the downward triangle next to your username on the far right of your screen.

  • A dropdown should present itself, use this to enter your account settings

  • On the sidebar to the left, Select Security

  • To the right of the Access Tokens heading, Click on the blue New Access Token button

  • A popup should now appear in the centre of the screen, Set the appropriate description and permissions

  • Your new token should now be created, Copy the token

Setting up dockerhub credentials

  • Below the repository name, in the top left corner of the screen, there is a navigation bar; Select Settings

  • You should be presented with a page consisting with a sidbar and the repositories settings, Select Secrets and variables

  • With the sub-section expanded, Select Actions

  • This section should already have two repository secrets, DOCKER_USERNAME and DOCKER_PASSWORD

  • If this is not the case, please add them
  • Assuming both secrets are present, Select the pencil icon to edit each secret

Building docker container

  • On the left sidebar, Select Releases
  • Select Draft New Release
  • Type in a new version number into tag field and select "Create new tag on publish".
  • Set the target branch to main
  • Either type the title and descript manually or select "Generate release notes"
  • Press the green button that says "Publish release"
  • Wait for the build to complete

Feel free to use the included docker-compose file, please note that it uses Traefik in order to create routes and assign SSL certificates.

Screenshot Description
Current state of the webapp.

###TODO

  • Upload Working example
  • Upload Demonstartion video & GIF
  • Share with collaborator

Contributions

Pull requests are appreciated!