Add live version to web interface from git tags via Makefile by Copilot · Pull Request #61 · maxi07/ScanSync

Copilot · 2026-05-24T10:02:49Z

Replace hard-coded version string with dynamic version derived from git describe --tags --always --dirty, passed through the Docker build pipeline as an environment variable.

Makefile

New Makefile with start, stop, build, restart, clean, test targets
Resolves version via git describe and exports as APP_VERSION

Docker build pipeline

docker-compose.yml / docker-compose.test.yml: pass APP_VERSION as build arg to all services (default: dev)
All service Dockerfiles: accept ARG APP_VERSION=dev, set ENV APP_VERSION

Web service

inject_config() reads os.environ.get("APP_VERSION") with fallback to config.json
Logs version at boot

Usage:

make start        # builds and runs with version from git tag
make build        # build only
APP_VERSION=v1.2.3 make start  # manual override

- Create Makefile that reads git tag version via `git describe` - Pass APP_VERSION as Docker build arg through docker-compose.yml - Update all Dockerfiles to accept APP_VERSION build arg and set as env var - Read APP_VERSION env var in web service instead of hard-coded config value - Log app version at web service boot - Fall back to config.json version if env var not set Agent-Logs-Url: https://github.com/maxi07/ScanSync/sessions/1ae7444f-19ab-4386-b174-a6292ff5885d Co-authored-by: maxi07 <7480270+maxi07@users.noreply.github.com>

Copilot

Pull request overview

This PR replaces the web UI’s hard-coded version with a dynamic version derived from git describe, propagated through Docker build args into container environment variables, and surfaced via the Flask template context.

Changes:

Add a repository Makefile intended to compute/export APP_VERSION from git describe and provide common docker compose targets.
Pass APP_VERSION as a Docker build arg in docker-compose.yml / docker-compose.test.yml and set it as an image env var via ARG/ENV in multiple service Dockerfiles.
Update the web service to log and inject APP_VERSION (with a config fallback) into templates.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
web_service/src/main.py	Logs and injects `APP_VERSION` into the Flask template context for display in the UI.
web_service/Dockerfile	Accepts `APP_VERSION` as a build arg and sets it as an image env var.
upload_service/Dockerfile	Accepts `APP_VERSION` as a build arg and sets it as an image env var.
ocr_service/Dockerfile	Accepts `APP_VERSION` as a build arg and sets it as an image env var.
metadata_service/Dockerfile	Accepts `APP_VERSION` as a build arg and sets it as an image env var.
file_naming_service/Dockerfile	Accepts `APP_VERSION` as a build arg and sets it as an image env var.
detection_service/Dockerfile	Accepts `APP_VERSION` as a build arg and sets it as an image env var.
docker-compose.yml	Wires `APP_VERSION` through build args for most built services.
docker-compose.test.yml	Wires `APP_VERSION` through build args for the web-service test build.
Makefile	Adds `git describe`-based version resolution and common lifecycle/test targets.

Copilot · 2026-06-30T10:01:29Z

+start:
+	@echo "Starting ScanSync (Version: $(GIT_VERSION))..."
+	APP_VERSION=$(GIT_VERSION) $(DOCKER_COMPOSE) up --build -d
+


Fixed. Removed the inline APP_VERSION=$(GIT_VERSION) override from the start recipe — the exported $(APP_VERSION) variable is now passed implicitly.

Copilot · 2026-06-30T10:01:29Z

+.PHONY: build
+build:
+	@echo "Building ScanSync (Version: $(GIT_VERSION))..."
+	APP_VERSION=$(GIT_VERSION) $(DOCKER_COMPOSE) build
+


Fixed. Same as start — removed the inline APP_VERSION=$(GIT_VERSION) from the build recipe so the exported variable is used consistently.

Copilot · 2026-06-30T10:01:31Z

    return dict(
        failed_document_count=failed_document_count,
-        version=config.get("version", "Unknown"),
+        version=os.environ.get("APP_VERSION", config.get("version", "Unknown")),
        onedrive_token_error=is_token_expired(),


Fixed. Changed to os.environ.get("APP_VERSION") or config.get("version", "Unknown") so an empty-string APP_VERSION correctly falls back to the config value.

Copilot · 2026-06-30T10:01:29Z

      context: .
      dockerfile: ocr_service/Dockerfile
+      args:
+        - APP_VERSION=${APP_VERSION:-dev}
    restart: unless-stopped


Fixed. Converted smb_service to the long build syntax with APP_VERSION=${APP_VERSION:-dev} build arg, and added ARG APP_VERSION=dev / ENV APP_VERSION=${APP_VERSION} to its Dockerfile.

Copilot · 2026-06-30T10:01:29Z

    build:
      context: .
      dockerfile: web_service/Dockerfile
+      args:
+        - APP_VERSION=${APP_VERSION:-dev}


Fixed. Added APP_VERSION=${APP_VERSION:-dev} build arg to test_service in docker-compose.test.yml and the corresponding ARG/ENV instructions to test_service/Dockerfile.

…ervice build args

* Initial plan * Add dynamic version from git tags via Makefile and Docker build args - Create Makefile that reads git tag version via `git describe` - Pass APP_VERSION as Docker build arg through docker-compose.yml - Update all Dockerfiles to accept APP_VERSION build arg and set as env var - Read APP_VERSION env var in web service instead of hard-coded config value - Log app version at web service boot - Fall back to config.json version if env var not set Agent-Logs-Url: https://github.com/maxi07/ScanSync/sessions/1ae7444f-19ab-4386-b174-a6292ff5885d * Fix review comments: APP_VERSION override, fallback logic, smb/test service build args --------- Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com> Co-authored-by: maxi07 <7480270+maxi07@users.noreply.github.com>

Initial plan

923a365

Copilot AI assigned Copilot and maxi07 May 24, 2026

Copilot started work on behalf of maxi07 May 24, 2026 10:02 View session

Copilot AI linked an issue May 24, 2026 that may be closed by this pull request

Add live version to web interface instead of hard coding #60

Closed

Copilot AI changed the title ~~[WIP] Add live version to web interface instead of hard coding~~ Add live version to web interface from git tags via Makefile May 24, 2026

Copilot finished work on behalf of maxi07 May 24, 2026 10:05

Copilot AI requested a review from maxi07 May 24, 2026 10:05

maxi07 requested a review from Copilot June 30, 2026 09:25

Copilot started reviewing on behalf of maxi07 June 30, 2026 09:25 View session

Copilot AI reviewed Jun 30, 2026

View reviewed changes

Copilot started work on behalf of maxi07 June 30, 2026 09:58 View session

maxi07 linked an issue Jun 30, 2026 that may be closed by this pull request

Add Makefile for easier control of containers #59

Closed

Fix review comments: APP_VERSION override, fallback logic, smb/test s…

e3a44d8

…ervice build args

Copilot finished work on behalf of maxi07 June 30, 2026 10:01

maxi07 marked this pull request as ready for review June 30, 2026 10:13

maxi07 approved these changes Jun 30, 2026

View reviewed changes

maxi07 merged commit cf472eb into main Jun 30, 2026
3 checks passed

maxi07 deleted the copilot/add-live-version-display branch June 30, 2026 10:22

Navigation Menu

Repository navigation

Add live version to web interface from git tags via Makefile - #61

Add live version to web interface from git tags via Makefile#61
maxi07 merged 3 commits into
mainfrom
copilot/add-live-version-display

Copilot AI commented May 24, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Jun 30, 2026

Uh oh!

Copilot AI Jun 30, 2026

Uh oh!

Uh oh!

Copilot AI Jun 30, 2026

Uh oh!

Copilot AI Jun 30, 2026

Uh oh!

Copilot AI Jun 30, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Copilot AI commented May 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Makefile

Docker build pipeline

Web service

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 30, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented May 24, 2026 •

edited

Loading