tasknote/tools/tools.md

Tools

All kind of tools and useful links and commands can be found here!

Links

• GitHub Container Registry: https://ghcr.io/
• Time tracking: https://track.toggl.com/timer

Building locally

Client - Frontend Web App:

Before building, you need define some env vars:

export VERSION=<branch-name-and-PR-number>

Then you can call the install and build scripts (from the client folder):

npm ci --ignore-scripts --no-update-notifier --omit=dev \
 && npm run build \
 && rm -rf node_modules

That's it!

Server - Backend REST API:

For the backend there's a Dockerfile ready, just run (from the project root):

docker build -t server ./server

That's it!

Deploying manually

1. Connect into the server via SSH
2. Run deploy scripts

Here are a few steps:

export SERVER_IP=
export SERVER_ADDRRESS=

npm ci --ignore-scripts --no-update-notifier --omit=dev
export VITE_BACKEND_SERVER=$SERVER_ADDRRESS/server
npm run build
zip -r "client_$VERSION.zip" dist/
scp "client_$VERSION.zip" root@$SERVER_IP:/root/

Runing with Docker

DB:

docker run -d --rm \
  --name db \
  --network=host \
  -e POSTGRES_DB=$POSTGRES_DB \
  -e POSTGRES_USER=$POSTGRES_USER \
  -e POSTGRES_PASSWORD=$POSTGRES_PASSWORD \
  -e PGDATA=/tmp \
  -v ./data:/tmp \
  postgres:15.8-bookworm

Server:

docker run -d --rm \
  --name server \
  --network=host \
  -e POSTGRES_DB=$POSTGRES_DB \
  -e POSTGRES_USER=$POSTGRES_USER \
  -e POSTGRES_PASSWORD=$POSTGRES_PASSWORD \
  -e POSTGRES_PORT=$POSTGRES_PORT \
  -e POSTGRES_HOST=$POSTGRES_HOST \
  -e CORS_ALLOWED_ORIGINS=$CORS_ALLOWED_ORIGINS \
  ghcr.io/ricardo-campos-org/react-typescript-todolist/server:<PR-Number>

Client:

The frontend app will run on Nginx.

Interacting with GitHub Package and Container Registry

Login in:

export CR_PAT=YOUR_TOKEN
echo $CR_PAT | docker login ghcr.io -u RMCampos --password-stdin

Pulling images:

docker pull ghcr.io/ricardo-campos-org/react-typescript-todolist/client:50
docker pull ghcr.io/ricardo-campos-org/react-typescript-todolist/server:50

• Get container IP docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' db