Update FIRST_RELEASE_REPORT.md with Jenkins builder option documentation
- Add --run-jenkins-builder option to Script Options Reference - Add Step 5: Generate RPM/DEB Packages Inside Docker (new feature) - Update Step 6 to Step 7: Verify Generated Packages - Update Next Steps with Option A (Inside Docker) and Option B (Direct Jenkins) - Update Known Test Exclusions: test_nglpdfwidget now passing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Entire-Checkpoint: 01M4DGMZ85QPEY1768PYQ45ZHF
This commit is contained in:
1 file changed
+59
-7
@@ -497,9 +497,42 @@ docker run --rm legatus-qt6-prebuilt:latest bash -c "apt list --installed 2>/dev
|
||||
# Output: libkf6texttemplate-dev/now 6.24.0-0ubuntu1 amd64 [installed,local]
|
||||
```
|
||||
|
||||
#### Step 5: Generate RPM/DEB Packages (Jenkins Pipeline)
|
||||
#### Step 5: Generate RPM/DEB Packages Inside Docker (New Feature)
|
||||
|
||||
For full package generation, use the Jenkins builder scripts:
|
||||
The `new_docker_build.sh` script now supports running the Jenkins builder inside the Docker container:
|
||||
|
||||
```bash
|
||||
cd /path/to/qt6-migration-pipeline/qt-migration-legatus/qt6-after/qt6-migrated-legatus
|
||||
|
||||
# Run Jenkins builder inside Docker with prebuilt image
|
||||
./new_docker_build.sh --use-prebuilt-image --run-jenkins-builder --package-output-dir ./packages-out
|
||||
```
|
||||
|
||||
**Environment Variables (with defaults):**
|
||||
- `PROJECT=guez` (project name)
|
||||
- `GUEZ_MODE=ON` (enable guez-specific build logic)
|
||||
- `LTS_VERSION=1.0` (version string for packages)
|
||||
- `BUILD_NUMBER=1` (build number)
|
||||
- `BUILD_TAG=manual-build` (build identifier)
|
||||
- `OS_VERSION` (auto-detected from /etc/os-release)
|
||||
|
||||
**Expected Results:**
|
||||
- Exit code: 0
|
||||
- DEB packages generated in `./packages-out/` directory (mounted from container)
|
||||
- Packages for: TetraIF, Z, Lts/Common components
|
||||
- Build log output in Docker container
|
||||
|
||||
**Package Output:**
|
||||
```
|
||||
./packages-out/
|
||||
├── tetraif_1.0-1_amd64.deb
|
||||
├── z-components_1.0-1_amd64.deb
|
||||
└── lts-common_1.0-1_amd64.deb
|
||||
```
|
||||
|
||||
#### Step 6: Generate RPM/DEB Packages (Jenkins Pipeline - Alternative)
|
||||
|
||||
For full package generation outside Docker, use the Jenkins builder scripts:
|
||||
|
||||
```bash
|
||||
# For openSUSE RPM packages
|
||||
@@ -514,9 +547,9 @@ cd /path/to/qt6-migration-pipeline/jenkins-ci-rme
|
||||
- RPM/DEB packages generated in `${WORKSPACE}/rpms/`
|
||||
- Packages for: TetraIF, Z, Lts/Common components
|
||||
|
||||
#### Step 6: Verify Generated Packages
|
||||
#### Step 7: Verify Generated Packages
|
||||
|
||||
After running Jenkins builder scripts, verify packages with:
|
||||
After running Jenkins builder scripts (Step 5 or Step 6), verify packages with:
|
||||
|
||||
```bash
|
||||
cd /path/to/qt6-migration-pipeline/qt-migration-legatus/qt6-after/qt6-migrated-legatus
|
||||
@@ -571,6 +604,17 @@ INFO: Package verification: SUCCESS
|
||||
|
||||
# Combine options for release build with verification
|
||||
./new_docker_build.sh --use-prebuilt-image --verify-rpm
|
||||
|
||||
# Run Jenkins builder inside Docker to generate RPM/DEB packages
|
||||
./new_docker_build.sh --use-prebuilt-image --run-jenkins-builder --package-output-dir ./packages-out
|
||||
|
||||
# Full options for Jenkins builder execution
|
||||
./new_docker_build.sh --use-prebuilt-image --run-jenkins-builder \
|
||||
--package-output-dir ./packages-out \
|
||||
--lts-version 1.0 \
|
||||
--project guez \
|
||||
--build-number 1 \
|
||||
--build-tag manual-build
|
||||
```
|
||||
|
||||
**Docker Image Details:**
|
||||
@@ -616,7 +660,14 @@ Jenkins jobs using jenkins_builder.sh or jenkins_builder_ubuntu26.sh will automa
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Full RPM Package Build:** Run Jenkins builder scripts to generate actual RPM/DEB packages:
|
||||
1. **Full RPM Package Build (Option A - Inside Docker):** Use the new `--run-jenkins-builder` option:
|
||||
```bash
|
||||
cd qt-migration-legatus/qt6-after/qt6-migrated-legatus
|
||||
./new_docker_build.sh --use-prebuilt-image --run-jenkins-builder --package-output-dir ./packages-out
|
||||
```
|
||||
Verify DEB packages are generated in `./packages-out/` directory for TetraIF, Z, and Lts/Common components.
|
||||
|
||||
2. **Full RPM Package Build (Option B - Direct Jenkins):** Run Jenkins builder scripts directly:
|
||||
```bash
|
||||
# For openSUSE
|
||||
./jenkins-ci-rme/jenkins_builder.sh
|
||||
@@ -634,11 +685,12 @@ Jenkins jobs using jenkins_builder.sh or jenkins_builder_ubuntu26.sh will automa
|
||||
4. **Documentation:** Update release notes with Qt6 migration changes
|
||||
|
||||
5. **Known Test Exclusions** (Documented - Not Blocking Release)
|
||||
- test_nglpdfwidget: Requires Poppler-Qt6 (external dependency)
|
||||
- nglcomp_test: Qt6 compression library migration issue
|
||||
- grantlee_parser_smoke: Requires KF6TextTemplate plugin (external dependency)
|
||||
- grantlee_parser_smoke: Requires KF6TextTemplate plugin (external dependency, parent target not in release scope)
|
||||
- migration_tests_NOT_BUILT: Tests from excluded modules (expected)
|
||||
|
||||
**Note:** test_nglpdfwidget is now **passing** after Poppler-Qt6 packages were added to Docker image.
|
||||
|
||||
## Notes
|
||||
|
||||
- The nested submodule `qt5-legatus-legacy` remains on `story/qt6-migration` branch (correct per release prompt requirements)
|
||||
|
||||
Reference in new issue
Block a user