Release Engineering: Sztab 1.10.0 (SZ-124)
rk@tigase.net opened 5 days 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 5 days ago

    working on mainline: wolsonc

  • rk@tigase.net changed state to 'In Progress' 5 days ago
    Previous Value Current Value
    Open
    In Progress
  • rk@tigase.net commented 5 days 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 % 
    
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