Deployment

Deployment Guide

This page outlines the steps required for deploying the Better Fleet project, including the backend and configuring NGINX as a reverse proxy.

Deploy Backend

To deploy the Better Fleet backend, use the following Docker command:

docker run -d -p 8301:8080 zelytra/better-fleet-backend:latest

NGINX Configuration

Below is a sample NGINX configuration to set up a reverse proxy for your Better Fleet application. This configuration directs traffic to the backend service and handles API requests appropriately.

server {
    server_name betterfleet.fr;

    location / {
        proxy_pass http://127.0.0.1:8300;
    }

    location /api {
        rewrite /api/(.*) /$1  break;
        proxy_pass http://127.0.0.1:8301;
        proxy_redirect     off;
        proxy_set_header   Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_hide_header 'Access-Control-Allow-Origin';
        proxy_http_version 1.1;
        proxy_connect_timeout 3h;
        proxy_send_timeout 3h;
        proxy_read_timeout 3h;
    }

    listen [::]:80;
    listen 80;
}

Auth configuration

• run keycloak
• import realm
• setup idp microsoft with client id and secret
• Go to azure and register new app to have those is say previously
• Add permission to API, openid, userInfo, Directory.READ
• To have XBox permission unlock in the azure portal you have to link your app to Microsoft partner Center

App Release Process

To create an app release, you must include 'release' in your commit message to the master branch. This keyword triggers the automated release process. And update the app version number to match the tag name in those files :

• webapp/package.json
• webapp/src-tauri/Cargo.toml
• webapp/src-tauri/tauri.conf.json
• backend/src/ressources/application.properties
• website/package.json