Release Engineering: Sztab 1.10.0 (SZ-124)
rk@tigase.net opened 4 weeks ago

Summary

Release preparation and validation for Sztab 1.10.0.

This work covers version alignment, image build and deployment, staging validation, regression testing, and release documentation finalization.


Scope of Work

1. Version Alignment

  • Updated root pom.xml to 1.10.0

  • Aligned all module versions (backend, query-dsl, query-cli)

  • Resolved parent POM mismatch causing reactor build inconsistency

  • Verified build integrity:

    mvn clean package -DskipTests


2. Docker Image Build & Push

  • Built and pushed backend image:

    docker buildx build
    --platform linux/amd64
    -f backend/docker/Dockerfile
    -t tigase.dev/sztab/sztab-backend:1.10.0
    --push
    .

  • Verified image availability in registry

  • Resolved staging ImagePullBackOff due to missing image


3. Staging Deployment (Helm)

  • Restarted backend deployment:

    kubectl rollout restart deployment sztab-backend -n sztab-staging

  • Verified:

    • Rolling update completion
    • Pod readiness
    • Correct image tag in running containers

4. Regression Testing

Manual validation performed on core workflows:

  • User management (create, update, password change)
  • Issue lifecycle (create, filter via GUI and DSL)
  • Pull request flows:
    • Regular merge
    • Rebase merge
    • Fast-forward merge
    • Squash merge
    • Retry after failure (SZ-111)
  • PAT handling (refresh behavior, SZ-110)

All flows validated successfully on the release image.


5. Release Documentation

  • Prepared release documentation under docs/release/1.10.0
  • Updated:
    • ReleaseNotes.md
    • README_FIRST.md
  • Validated links and image references
  • Extracted sztabctl documentation to docs/tools/sztabctl.md
  • Preserved historical release structure

6. Cleanup and Finalization

  • Removed tracked binary artifact (sztabina executable)

  • Verified clean working tree prior to release

  • Tagged release:

    v1.10.0

  • Confirmed tag alignment with release commit


Lessons Learned

  • Module version alignment is critical for multi-module Maven builds
  • Images must be pushed before deployment to avoid ImagePullBackOff
  • mvn versions:set ensures consistent version updates across modules
  • Build verification should precede deployment and announcement

Outcome

  • Staging successfully upgraded to 1.10.0
  • Release artifacts validated and aligned
  • Core workflows verified via regression testing

Release declared stable.

  • rk@tigase.net commented 4 weeks ago

    working on mainline: wolsonc

  • rk@tigase.net changed state to 'In Progress' 4 weeks ago
    Previous Value Current Value
    Open
    In Progress
  • rk@tigase.net commented 4 weeks ago
    rksuma@Ramakrishnans-MacBook-Pro sztab % git checkout -b release/1.10.0
    Switched to a new branch 'release/1.10.0'
    rksuma@Ramakrishnans-MacBook-Pro sztab % 
    
  • rk@tigase.net commented 3 weeks ago

    Actual time spent: 16h (not 24h). Estimated was 8h. Overage due to second-round regression testing uncovering SZ-133, SZ-134, SZ-137 which required fixes, rebuilds, and re-verification. UI inadvertently logged 24h — actual is 16h.

  • rk@tigase.net commented 3 weeks ago

    Merged into wolnosc - release note sent

  • rk@tigase.net changed state to 'Closed' 3 weeks ago
    Previous Value Current Value
    In Progress
    Closed
issue 1 of 1
Type
Task
Priority
Normal
Assignee
Version
1.10.0
Sprints
n/a
Customer
n/a
Issue Votes (0)
Watchers (3)
Reference
SZ-124
Please wait...
Page is in error, reload to recover