Simple weather application

The application is up and running on: https://weather-app-kgebkmlmyq-ew.a.run.app

---

Local development

Prerequisites

1. Linux-based system with POSIX compliant shell (required for the scripts to work)
2. Docker engine & docker-compose plugin preferably the latest version, otherwise you may encounter errors
3. Make sure the scripts have execute permissions, e.g:

chmod +x ./scripts/start.sh ./scripts/remove.sh

4. Make sure to add an .env file to the scripts folder with the API_KEY

---

Recommended (Will work without them):

1. NVM - Node Version Manager
2. Node LTS version

Notes:

• ONLY run the application using the start/remove scripts, not directly via the docker. (Unless you are sure you know what you're doing)
• For any issue(s), contact a maintainer/contributor in any way you see fit

---

Run locally

1. Use this to start the local environment:

./scripts/start.sh

2. Use this to stop the local environment:

./scripts/remove.sh

---

Troubleshooting

• If you encounter any permission related errors from the docker(s), follow these steps:

1. Stop the docker using: yes | ./scripts/remove.sh
2. Remove the following folders: rm -rf ./db-dev-data ./be/node_modules ./fe/node_modules ./scripts/cache
3. Make sure you have the latest docker and docker-compose versions (follow step 2 in the perquisites)
4. Run yes | ./scripts/start.sh and hope for the best
5. If the problem persists, contact a maintainer/contributor in any way you see fit

---

Deployment

Currently the application is deployed on google cloud.
To deploy a new version, first make sure you have the following (once per machine):

1. gcloud cli
2. Run: gcloud init
3. Run: gcloud auth configure-docker europe-west10-docker.pkg.dev

Then do as follows: (On every version update)

1. Run docker-compose -f docker-compose-prod.yml up --build -d and check the application works via http://localhost:8080
2. Tag the created image with the following format: docker tag <BUILT_IMAGE> europe-west10-docker.pkg.dev/weather-application-418809/personal/<IMAGE_NAME>
3. Push the image: docker push europe-west10-docker.pkg.dev/weather-application-418809/personal/<IMAGE_NAME>
4. Stop the running docker-compose: docker-compose -f docker-compose-prod.yml down

TODO Make a CI/CD to make this automatic