UBC/Alley-HSBC-Frontend
Archived
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
This repository has been archived on 2022-05-20. You can view files and clone it, but cannot push or open issues or pull requests.
170 Commits 1 Branch 0 Tags 2.2 MiB
TypeScript 95.5%
Sass 3.4%
HTML 0.4%
Dockerfile 0.3%
Shell 0.2%
Other 0.2%
725e9a7931
Go to file
CodeServer 725e9a7931 changed port number on readme
2022-03-31 20:35:23 +01:00
.husky add boilerplate (try 2) 2022-02-16 19:23:47 -08:00
docker changed port number on readme 2022-03-31 20:35:23 +01:00
env fix typo 2022-03-31 20:24:49 +01:00
public add boilerplate (try 2) 2022-02-16 19:23:47 -08:00
src added instructions 2022-03-31 19:37:46 +01:00
.dockerignore added instructions 2022-03-31 19:37:46 +01:00
.env.example add boilerplate (try 2) 2022-02-16 19:23:47 -08:00
.eslintrc.json turn off eslint linebreak-style errors 2022-03-01 01:53:35 -08:00
.gitignore add boilerplate (try 2) 2022-02-16 19:23:47 -08:00
.npmrc add boilerplate (try 2) 2022-02-16 19:23:47 -08:00
declaration.d.ts navbar completed 2022-02-28 20:21:06 -08:00
Dockerfile fix typo 2022-03-31 20:24:49 +01:00
package-lock.json Implemented Schedule Meeting and Call Group 2022-03-30 23:49:51 +01:00
package.json fix typo 2022-03-31 20:24:49 +01:00
README.md changed port number on readme 2022-03-31 20:35:23 +01:00
tsconfig.json navbar completed 2022-02-28 20:21:06 -08:00
webpack.config.ts fix typo 2022-03-31 20:24:49 +01:00

README.md

Alley-HSBC-Frontend

Build docker image from docker file

  1. cd into the root of this repository.

  2. On Windows

    • run docker build --tag <image-name> .

    On Linux

    • run DOCKER_BUILDKIT=1 docker build --tag <image-name> .

    Where <image-name> is the name you give to the image.

Deploy in docker (docker-compose)

  1. Deploy using docker-compose.

  2. Make sure both docker and docker-compose are installed.

  3. If you pull image teamalley/digital-walkaround from dockerhub

    • You need to first login to dockerhub by running docker login command. The Username and LoginToken are provided under files in docker directory

    If you built your own image

    • Please Replace the image name in "docker-compose.yml" with <image-name>

  4. cd into the direct where you store the "docker-compose.yml" file.

    • run docker-compose up -d to start the service.
    • run docker-compose down to stop the service

  6. You can access it on port 8080 by default. To change the port number, edit docker-compose.yml. Under ports, replace 8080:8080 with <the port number you want>:8080. Then stop the service and start it again.

  7. Node: you may exprience issues running the container in machines with limited ram. If the container restarts unexpectedly, try running docker-compose up without -d option to show the error messages.

Deploy directly on a Server

If You prefer installing it directly or you are expriencing some issues with the docker container. Follow the instructions bellow.

  1. Make sure you have a server with node v16.14.0 and npm 8.3.1 installed (other versions may work but not guaranteed). A linux machine with screen installed is recommended.
  2. clone the repository and cd into the root folder of the repository.
  3. If you are installing it on a linux machine with screen installed, run screen -S <name> to create a new screen. where <name> can be any name you choose.
  4. run npm run start-prod
  5. if you followed step 3, press CTRL ^A then press D while holding CTRL ^A. The screen will detach.
  6. You can then access it on port 8080

Setup Reverse Proxy

You can use Apache, Ngnix or other tools to set up a reverse proxy and connect it to a hostname. here is a guide on apache reverse proxy setup.

Enable HTTPS

You might want to enable https to secure your webapp since it includes private information (such as your username and password). here is a guide on enabling https with Let's Entrypt on a Ubuntu server with apache.