Version Upgrades
Upgrade qqq versions in your project
Upgrading qqq Versions
Guide to upgrading qqq to newer versions.
Version Policy
qqq follows semantic versioning:
Checking Current Version
Bash
qctl version
# qqq version 1.2.3
# qctl version 1.2.3Upgrading
Using qctl
Bash
# Check for updates
qctl update --check
# Update to latest
qctl update
# Update to specific version
qctl update --version 1.3.0Manual Update
Update pom.xml:
XML
<properties>
<qqq.version>1.3.0</qqq.version>
</properties>Migration Steps
1. Read Release Notes
Check the changelog for:
2. Update Dependencies
Bash
qctl update
mvn clean install3. Run Tests
Bash
mvn test4. Fix Deprecations
Address any deprecation warnings.
5. Test Manually
Verify critical workflows in development.
Breaking Changes
For major version upgrades:
1. Create a branch for upgrade
2. Follow migration guide in release notes
3. Update deprecated APIs
4. Run full test suite
5. Deploy to staging first
Rollback
If issues occur:
1. Revert version in pom.xml
2. Restore any changed code
3. Rebuild and redeploy