This is an automated email from the ASF dual-hosted git repository.
tiagobento pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/incubator-kie-website.git
The following commit(s) were added to refs/heads/main by this push:
new 2770e6f [incubator-kie-website#77]: Release procedure document for
10.3.x+ (#62)
2770e6f is described below
commit 2770e6f6309517907fd56d7bc0750be039df27d5
Author: Kusuma04-dev <[email protected]>
AuthorDate: Wed Nov 11 20:00:29 2026 +0530
[incubator-kie-website#77]: Release procedure document for 10.3.x+ (#62)
* release doc for 10.3.x
* release doc for 10.3.x
* fix(docs): fix canonical URL path to release-procedure and verify doc
* updated doc
* updaetd files
* updated doc
* updated readme
* updated doc
* updated doc
* updated doc
* updated docs
updated docs
updated docs
updated docs
* fixed documentation
* Updated doc
* updated doc
* updated docs
* simplified doc
* simplified doc
* updated links
* removed links
---------
Co-authored-by: Kusuma <[email protected]>
Co-authored-by: Kusuma04-dev <[email protected]>
---
.github/workflows/deploy.yml | 10 +-
docs/community/community.md | 4 +
docs/community/devs/_category_.json | 2 +-
docs/community/devs/build-10.3.0.md | 123 ++++++++
docs/community/devs/release-procedure.md | 477 +++++++++++++++++++++++++++++++
docs/community/devs/verify.md | 41 ++-
src/pages/community/build.tsx | 2 +-
7 files changed, 638 insertions(+), 21 deletions(-)
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index ca5162e..0297831 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -34,8 +34,8 @@ jobs:
- name: Build Drools documentation
run: |
- cd drools/drools-docs
- mvn -B clean install
+ cd drools
+ mvn -B clean install -pl :drools-bom,drools-docs -am -Dfull -Dquickly
- name: Checkout Kogito documentation repository
uses: actions/checkout@v4
@@ -58,8 +58,8 @@ jobs:
- name: Build OptaPlanner documentation
run: |
- cd optaplanner/optaplanner-docs
- mvn -B clean install
+ cd optaplanner
+ mvn -B clean install -pl optaplanner-docs -am -Dfull -Dquickly
- name: Collect built docs
run: |
@@ -236,4 +236,4 @@ jobs:
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: incubator-kie-website/build
- publish_branch: deploy
+ publish_branch: deploy
\ No newline at end of file
diff --git a/docs/community/community.md b/docs/community/community.md
index 9c73f27..664bd0c 100644
--- a/docs/community/community.md
+++ b/docs/community/community.md
@@ -85,6 +85,10 @@ To report a new vulnerability you have discovered please
follow the [ASF vulnera
Enhancements or new feature proposals are also welcome. The more concrete and
rationale the proposal is, the greater the
chance it will be incorporated into future releases.
+## Release Procedure
+
+The full release process — repository matrix, branching strategy, RC
generation, SVN staging, voting, and publication — is documented in the
[Release Procedure](/community/devs/release-procedure) page.
+
## Source code
* KIE
[repositories](https://github.com/orgs/apache/repositories?q=visibility%3Apublic+archived%3Afalse+incubator-kie)
diff --git a/docs/community/devs/_category_.json
b/docs/community/devs/_category_.json
index 62c6b33..f17e7d5 100644
--- a/docs/community/devs/_category_.json
+++ b/docs/community/devs/_category_.json
@@ -1,5 +1,5 @@
{
- "label": "—",
+ "label": "Release & Development",
"collapsible": false,
"collapsed": false,
"position": 100
diff --git a/docs/community/devs/build-10.3.0.md
b/docs/community/devs/build-10.3.0.md
new file mode 100644
index 0000000..5b08d84
--- /dev/null
+++ b/docs/community/devs/build-10.3.0.md
@@ -0,0 +1,123 @@
+---
+id: build-10.3
+title: Build from source - 10.3.0 RCs
+sidebar_position: 99
+---
+
+Starting with 10.3.0 the Java code lives in a single repository
(`incubator-kie`) and the tooling in `incubator-kie-tools`. There is no longer
a separate build for Drools, OptaPlanner, Kogito Runtimes and Kogito Apps as in
10.2.
+
+### Environment requirements
+
+| Tool | Version | Needed for |
+|---|---|---|
+| Temurin JDK | 17 (21 also works) | Java and Tools |
+| Maven | 3.9.x (CI uses 3.9.16) | Java and Tools |
+| Docker | 26.1.4+ | Container images, some integration tests |
+| Node | 24+ | Tools |
+| PNPM | 10.34.4 | Tools |
+| Go | 1.26.x | Tools (upload service) |
+| Helm | 3.x | Tools (Helm charts) |
+| Python 3, Make, Git | any recent | Tools |
+
+:::note
+The exact versions used by the project are pinned in `devbox.json` of each
repository. If in doubt, use those.
+:::
+
+:::note
+
+If you're using a different engine for the Docker API, Cekit and other tools
will require `DOCKER_HOST` to be properly set up.
+
+If using colima:
+ ```bash
+ export DOCKER_HOST=unix://${HOME}/.colima/default/docker.sock
+ ```
+
+If using rancher:
+
+ ```bash
+ export DOCKER_HOST=unix://$HOME/.rd/docker.sock
+ ```
+
+If using podman:
+
+ ```bash
+ export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/podman/podman.sock
+ ```
+
+:::
+
+### 1. Obtain the source code
+
+Release candidates are published in the Apache dev SVN, one folder per RC:
+
+```
+https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-${rc_version}/
+```
+
+The SVN folder contains only the Tools source archive (`incubator-kie-tools`).
Download it (replace `rc1` with the RC you want to build):
+
+```bash
+BASE=https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-rc1
+curl -O $BASE/apache-kie-10.3.0-incubating-sources.zip # Tools
(incubator-kie-tools)
+unzip apache-kie-10.3.0-incubating-sources.zip
+```
+
+The Java code (`incubator-kie`) is not published as a source archive. Check
out the RC tag instead:
+
+```bash
+git clone --branch 10.3.0-rc1 --depth 1
https://github.com/apache/incubator-kie.git
+```
+
+
+:::tip
+Before building, verify signatures and checksums as described in [How to
verify a release candidate](/community/devs/verify).
+:::
+
+### 2. Build
+
+:::note
+It's recommended to clean the local `~/.m2` repository first, because its
content is incorporated in some container images during the build.
+:::
+
+### 2.1. Java (Drools, Kogito, OptaPlanner, apps)
+
+**Environment requirements:** Temurin JDK, Maven, Docker.
+
+**Build commands:**
+```bash
+cd incubator-kie
+mvn clean install -DskipTests -Dfull
+```
+
+:::note
+If you're using Podman as the Docker API, also pass:
+
+ ```bash
+ -Djib.dockerClient.executable=$(which podman)
+ ```
+:::
+
+**Produced artifacts:** JARs are installed to the local Maven repository.
+
+### 2.2. KIE Tools
+
+**Environment requirements:** Temurin JDK, Maven, Node, PNPM, Go, Python,
Helm, Docker, Make.
+
+**Build commands:**
+```bash
+cd apache-kie-10.3.0-incubating
+git init .
+git config user.name "Your Name"
+git config user.email "[email protected]"
+git add . && git commit -m "."
+pnpm bootstrap && KIE_TOOLS_BUILD__runTests=false
KIE_TOOLS_BUILD__buildExamples=true KIE_TOOLS_BUILD__buildContainerImages=true
pnpm -r --workspace-concurrency=1 build:prod && echo 'BUILD SUCCESS! 🎉' || echo
'BUILD FAILURE ❌'
+```
+
+**Produced artifacts:**
+- JARs are installed to the local Maven repository
+- Images are created in the local container registry
+- Binaries and final artifacts are in:
+ - `packages/*/dist`
+ - `examples/*/dist`
+
+New in 10.3: the **DRL VS Code extension** is built from
`packages/drl-vscode-extension`. Its `.vsix` ends up in
`packages/drl-vscode-extension/dist`.
\ No newline at end of file
diff --git a/docs/community/devs/release-procedure.md
b/docs/community/devs/release-procedure.md
new file mode 100644
index 0000000..198ba3f
--- /dev/null
+++ b/docs/community/devs/release-procedure.md
@@ -0,0 +1,477 @@
+---
+id: release-procedure
+title: Release Procedure
+sidebar_position: 1
+---
+
+How to perform an Apache KIE release, from the first Release Candidate (RC) to
the final release.
+
+> Since **10.3**, all Java components (Drools, OptaPlanner, jBPM, Kogito
Runtimes, Kogito Apps) are released from a single repository:
+>
+> - `apache/incubator-kie`
+>
+> KIE tools and extensions are released from:
+>
+> - `apache/incubator-kie-tools`
+>
+> A complete release now involves **two repositories** and one release job per
repository.
+
+---
+
+## Overview
+
+Releases are executed using Jenkins jobs in:
+
+- [`apache/incubator-kie`](https://github.com/apache/incubator-kie)
+- [`apache/incubator-kie-tools`](https://github.com/apache/incubator-kie-tools)
+
+The only manual steps are:
+
+- Closing and releasing the Nexus staging repository
+- Running the community votes
+- Sending release announcements
+
+### Release flow
+
+1. Prepare a new minor release stream (minor releases only)
+2. Build and stage a Release Candidate
+3. Verify and vote
+4. Promote the approved RC
+5. Publish artifacts
+6. Announce the release
+
+---
+
+## 1. Prepare a new minor release stream
+
+> Only required before the first RC of a new minor series (for example
`10.3.0-rc1`).
+
+Skip this step for patch releases (`10.3.1`, `10.3.2`, etc.).
+
+### 1.1 Create Jenkins folders
+
+In Jenkins, create the stream folder (e.g. [`10.3.x+
stream`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/)) by
copying the jobs from `main`.
+
+### 1.2 Build CI images
+
+- **`incubator-kie`**: Trigger
[`kie-ci-image-build`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-ci-image-build/)
with `IMAGE_TAG={STREAM_NAME}-latest` (e.g. `10.3.x-latest`). Verify the tag
on [Docker
Hub](https://hub.docker.com/r/apache/incubator-kie-kogito-ci-build/tags).
+- **`incubator-kie-tools`**: If `.ci/incubator-kie-tools-ci-build.Dockerfile`
changed on `main`, trigger
[`kie-tools-ci-image-build`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-tools-ci-image-build/)
with `IMAGE_TAG=main`.
+
+---
+
+## 2. Build and stage a release candidate
+
+### Parameters
+
+#### First RC (e.g. `10.3.0-rc1`)
+
+```text
+RELEASE_VERSION=10.3.0
+TAG_NAME=10.3.0-rc1
+CREATE_STREAM_BRANCH=true
+```
+
+*Additional parameter for `incubator-kie-tools`:* `UPDATE_STREAM_VERSION=true`
+
+#### Later RCs and patch releases (e.g. `10.3.0-rc2`, `10.3.1-rc1`)
+
+```text
+RELEASE_VERSION=<version>
+TAG_NAME=<tag>
+CREATE_STREAM_BRANCH=false
+```
+
+### 2.1 Run `incubator-kie` release candidate
+
+Trigger [`apache/incubator-kie ::
release-candidate`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-release-candidate/)
with the parameters above.
+
+#### After completion
+
+1. Open [repository.apache.org](https://repository.apache.org)
+2. Navigate to **Staging Repositories**
+3. Locate the generated repository: `orgapachekie-XXXX`
+4. Click **Close**
+5. Save the staging repository URL for the vote email
+
+---
+
+### 2.2 Run `incubator-kie-tools` release candidate
+
+Trigger [`apache/incubator-kie-tools ::
release-candidate`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-tools-release-candidate/)
with the parameters above.
+
+Artifacts and their `.asc` signatures and `.sha512` checksums are uploaded to
[Apache SVN Dev Dist](https://dist.apache.org/repos/dist/dev/incubator/kie/):
+
+```text
+https://dist.apache.org/repos/dist/dev/incubator/kie/<rc-version>/
+```
+
+<details>
+<summary><b>Full artifact list staged in SVN (click to expand)</b></summary>
+
+**VS Code extensions (`.vsix`)**
+- `apache-kie-10.3.0-incubating-bpmn-vscode-extension.vsix`
+-
`apache-kie-10.3.0-incubating-business-automation-bundle-vscode-extension.vsix`
+- `apache-kie-10.3.0-incubating-dmn-vscode-extension.vsix`
+- `apache-kie-10.3.0-incubating-drl-vscode-extension.vsix`
+- `apache-kie-10.3.0-incubating-extended-services-vscode-extension.vsix`
+- `apache-kie-10.3.0-incubating-kogito-bundle-vscode-extension.vsix`
+- `apache-kie-10.3.0-incubating-pmml-vscode-extension.vsix`
+
+**Chrome extensions (`.zip`)**
+- `apache-kie-10.3.0-incubating-business-automation-chrome-extension.zip`
+-
`apache-kie-10.3.0-incubating-business-automation-chrome-extension-editors.zip`
+
+**Web apps, accelerators, npm packages, and sources (`.zip`)**
+- `apache-kie-10.3.0-incubating-sandbox-webapp.zip`
+- `apache-kie-10.3.0-incubating-sandbox-accelerator-quarkus.zip`
+- `apache-kie-10.3.0-incubating-tools-npm-packages.zip`
+- `apache-kie-10.3.0-incubating-sources.zip`
+
+**Helm charts (`.tar.gz`)**
+- `apache-kie-10.3.0-incubating-sandbox-helm-chart.tar.gz`
+- `apache-kie-10.3.0-incubating-runtime-tools-console-helm-chart.tar.gz`
+
+**Container images (`.tar.gz`)**
+- `apache-kie-10.3.0-incubating-cors-proxy-image.tar.gz`
+- `apache-kie-10.3.0-incubating-kogito-management-console-image.tar.gz`
+- `apache-kie-10.3.0-incubating-sandbox-dev-deployment-base-image.tar.gz`
+-
`apache-kie-10.3.0-incubating-sandbox-dev-deployment-dmn-form-webapp-image.tar.gz`
+-
`apache-kie-10.3.0-incubating-sandbox-dev-deployment-quarkus-blank-app-image.tar.gz`
+- `apache-kie-10.3.0-incubating-sandbox-extended-services-image.tar.gz`
+- `apache-kie-10.3.0-incubating-sandbox-webapp-image.tar.gz`
+
+**Upload service binaries (`.tar.gz`)**
+-
`apache-kie-10.3.0-incubating-sandbox-dev-deployment-upload-service-linux-x86.tar.gz`
+-
`apache-kie-10.3.0-incubating-sandbox-dev-deployment-upload-service-macOS-arm64.tar.gz`
+-
`apache-kie-10.3.0-incubating-sandbox-dev-deployment-upload-service-macOS-x86.tar.gz`
+-
`apache-kie-10.3.0-incubating-sandbox-dev-deployment-upload-service-windows-x86.tar.gz`
+
+Each file is accompanied by a `.asc` PGP signature and a `.sha512` checksum.
+
+</details>
+
+---
+
+## 3. Verify and vote
+
+### 3.1 Verify the RC
+
+Before opening any vote, verify checksums, signatures, licenses, and source
builds following the [verification guide](/community/devs/verify).
+
+---
+
+### 3.2 PPMC vote
+
+Send a vote email to: `[email protected]`
+
+Requirements:
+- Vote open for at least **72 hours**
+- Minimum **3 binding +1 votes** from PPMC members
+
+Archives:
+- [`[email protected]`
archive](https://lists.apache.org/[email protected])
+- [Example KIE vote
thread](https://lists.apache.org/thread.html/1hy6nb6511lpxp9f3dkcj3gb8rsfbr13)
+
+---
+
+### 3.3 IPMC vote
+
+After the PPMC vote passes:
+1. Send `[RESULT][VOTE]` to `[email protected]`
+2. Start the IPMC vote by sending a vote email to
`[email protected]`
+
+Requirements:
+- Vote open for at least **72 hours**
+- Minimum **3 binding +1 votes** from IPMC members
+
+Archives:
+- [`[email protected]`
archive](https://lists.apache.org/[email protected])
+- [Previous IPMC vote
threads](https://lists.apache.org/[email protected]:lte=1M:%5BVOTE%5D%20Apache%20KIE)
+
+#### If the vote fails
+
+1. Fix issues on the stream branch (`10.3.x`)
+2. Create a new RC (`rc2`, `rc3`, ...)
+3. Repeat Step 2 and Step 3
+
+---
+
+## 4. Promote the approved release
+
+Run promotion jobs only after the IPMC vote passes.
+
+---
+
+### 4.1 Promote `incubator-kie`
+
+Trigger [`apache/incubator-kie ::
release-promote`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-release-promote/)
with:
+
+```text
+PROJECT_VERSION=10.3.0
+GIT_TAG=10.3.0-rc1
+BUILD_BRANCH_NAME=10.3.x
+```
+
+---
+
+### 4.2 Promote `incubator-kie-tools`
+
+Trigger [`apache/incubator-kie-tools ::
release-promote`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-tools-release-promote/)
with:
+
+```text
+RELEASE_VERSION=10.3.0
+BASE_REF=10.3.0-rc1
+```
+
+---
+
+### Promotion verification
+
+Verify final release creation:
+
+- **GitHub releases**: Check [`apache/incubator-kie`
releases](https://github.com/apache/incubator-kie/releases) and
[`apache/incubator-kie-tools`
releases](https://github.com/apache/incubator-kie-tools/releases)
+- **Apache Release Dist**: Check
[dist.apache.org/repos/dist/release/incubator/kie/](https://dist.apache.org/repos/dist/release/incubator/kie/)
to verify `10.3.0/` exists
+- **Apache Dev Dist**: Check
[dist.apache.org/repos/dist/dev/incubator/kie/](https://dist.apache.org/repos/dist/dev/incubator/kie/)
to verify temporary RC folders are removed
+
+---
+
+## 5. Publish artifacts
+
+### 5.1 Release Nexus staging repository
+
+1. Open [repository.apache.org](https://repository.apache.org)
+2. Navigate to **Staging Repositories**
+3. Select `orgapachekie-XXXX`
+4. Click **Release**
+
+Artifacts will sync to [Maven
Central](https://central.sonatype.com/search?q=org.apache.kie).
+
+---
+
+### 5.2 Publish KIE Tools artifacts
+
+Trigger [`apache/incubator-kie-tools ::
release-publish`](https://ci-builds.apache.org/job/KIE/job/10.3.x+%20stream/job/10.3.x/job/kie-tools-release-publish/)
with:
+
+```text
+BASE_REF=10.3.0-rc1
+RELEASE_VERSION=10.3.0
+GITHUB_RELEASE_TAG=10.3.0
+```
+
+#### Published destinations
+
+| Artifact type | Destination |
+|---------------|-------------|
+| npm packages | [npm Registry
(`@kie-tools`)](https://www.npmjs.com/search?q=%40kie-tools) |
+| VS Code extensions | [Visual Studio Marketplace
(`kie-group`)](https://marketplace.visualstudio.com/publishers/kie-group) |
+| Chrome extensions | [Chrome Web
Store](https://chromewebstore.google.com/search/KIE) |
+| Container images | [Docker Hub
(`apache/incubator-kie-*`)](https://hub.docker.com/u/apache) |
+| Helm charts | [Docker Hub OCI Registry](https://hub.docker.com/u/apache) |
+| Web applications | [GitHub
Pages](https://apache.github.io/incubator-kie-tools/) |
+
+---
+
+## 6. Announce the release
+
+Send announcement emails to:
+
+- `[email protected]`
+- `[email protected]`
+
+Example announcement thread: [[email protected] announcement
archive](https://lists.apache.org/thread.html/mz6coxgc5p0hhkotmzjrc7jv1kbvfb5p)
+
+<details>
+<summary><b>Announcement email template (click to expand)</b></summary>
+
+```text
+Subject: [ANNOUNCE] Apache KIE (Incubating) 10.3.0 released
+
+We are pleased to announce the release of Apache KIE (Incubating) 10.3.0!
+
+Apache KIE (Incubating) is a collection of projects including Drools,
+jBPM, OptaPlanner, and Kogito. This release builds on the foundation
+of previous releases and brings several improvements and fixes across the
stack.
+
+Download:
+https://kie.apache.org/docs/start/download
+
+Announcement and New & Noteworthy:
+https://kie.apache.org/blog/
+
+We encourage all users to upgrade to this latest version. Thank you to
+all contributors and community members who made this release possible!
+
+–
+Apache KIE PPMC
+```
+
+</details>
+
+---
+
+## Steps to run locally
+
+> For development, testing, and exceptional cases. Official releases should be
executed via the Jenkins automation jobs above.
+
+Ensure your environment has the required credentials (GPG signing key, ASF SVN
credentials, Maven `settings.xml`, and GitHub CLI `gh`).
+
+### Build and stage a release candidate locally
+
+#### incubator-kie
+
+```bash
+git checkout 10.3.x && git pull
+
+# Dry run (builds locally, no remote changes)
+./script/release/release-all.sh --version 10.3.0 --tag 10.3.0-rc1 --skip-tests
+
+# Real run (creates RC commit, pushes tag, and deploys to Nexus staging)
+MAVEN_SETTINGS=/path/to/settings.xml \
+MAVEN_GPG_PASSPHRASE="<your-gpg-passphrase>" \
+./script/release/release-all.sh --version 10.3.0 --tag 10.3.0-rc1 --skip-tests
--deploy --push-tag
+```
+
+#### incubator-kie-tools
+
+```bash
+git checkout 10.3.x && git pull
+pnpm bootstrap
+
+# 1. Build all RC artifacts into release-artifacts/
+./scripts/release/release-all.sh 10.3.0 --rc
+
+# 2. Sign each artifact
+cd release-artifacts
+for f in *; do
+ gpg --no-tty --batch --pinentry-mode loopback --output "${f}.asc"
--detach-sig "${f}"
+ sha512sum "${f}" > "${f}.sha512"
+done
+
+# 3. Upload to Apache SVN Dev Dist
+svn import . https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-rc1 \
+ -m "Apache KIE 10.3.0-rc1 artifacts"
+```
+
+---
+
+### Promote an approved release locally
+
+#### incubator-kie
+
+```bash
+# Fetch the approved RC tag
+git fetch origin "refs/tags/10.3.0-rc1:refs/tags/10.3.0-rc1"
+
+# Create and push final release tag
+./script/release/05-tag-release.sh --rc-tag 10.3.0-rc1 --push
+
+# Create GitHub Release
+gh release create 10.3.0 \
+ --repo apache/incubator-kie \
+ --target 10.3.x \
+ --title "10.3.0" \
+ --generate-notes
+```
+
+#### incubator-kie-tools
+
+```bash
+# Fetch the approved RC tag
+git fetch origin "refs/tags/10.3.0-rc1:refs/tags/10.3.0-rc1"
+
+# Create and push final release tag
+git tag -a 10.3.0 10.3.0-rc1 -m "Release 10.3.0"
+git push origin 10.3.0
+
+# Create GitHub Release
+gh release create 10.3.0 \
+ --repo apache/incubator-kie-tools \
+ --title "10.3.0" \
+ --generate-notes
+
+# Move approved RC in Apache SVN from dev to release
+svn move -m "Release Apache KIE 10.3.0" \
+ https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-rc1 \
+ https://dist.apache.org/repos/dist/release/incubator/kie/10.3.0
+
+# Delete any superseded RCs from dev
+svn delete -m "Remove superseded RC" \
+ https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-rc<N>
+```
+
+---
+
+## Quick reference
+
+### Minor release (`10.3.0`)
+
+1. Create `10.3.x` Jenkins jobs
+2. Build required CI images
+3. Run RC jobs
+4. Close Nexus staging repository
+5. Verify RC
+6. Run PPMC vote
+7. Run IPMC vote
+8. Run promote jobs
+9. Release Nexus staging repository
+10. Run publish job
+11. Send announcement
+
+---
+
+### Patch release (`10.3.1`)
+
+Skip Step 1.
+
+1. Fix issues on `10.3.x`
+2. Create RC
+3. Vote
+4. Promote
+5. Publish
+6. Announce
+
+---
+
+### Failed vote
+
+1. Fix issues
+2. Create next RC
+3. Repeat verification and voting
+4. Continue once vote passes
+
+---
+
+## Branches and tags
+
+| Type | Example |
+|--------|----------|
+| Main branch | `main` |
+| Release stream | `10.3.x` |
+| RC tag | `10.3.0-rc1` |
+| Final tag | `10.3.0` |
+
+### Versioning rules
+
+| Branch | Version |
+|----------|-----------|
+| `main` | `999-SNAPSHOT` / `0.0.0` |
+| Stream branch | `10.3.999-SNAPSHOT` / `10.3.999` |
+| Release tags | exact version (e.g. `10.3.0-rc1`, `10.3.0`) |
+
+---
+
+## Release outputs
+
+| Repository | Output |
+|------------|---------|
+| `incubator-kie` | Maven artifacts (JARs, POMs, sources, Javadocs) |
+| `incubator-kie-tools` | VS Code extensions, Chrome extensions, npm packages,
web applications, Helm charts, source archives, container images |
+
+---
+
+## Important notes
+
+- Never reuse an RC tag that has already been pushed.
+- If an RC fails after tagging, always use the next RC number (e.g.,
`10.3.0-rc2`).
+- Never move or delete a tag that has already been voted on or released.
+- Verify signatures and checksums before every vote.
\ No newline at end of file
diff --git a/docs/community/devs/verify.md b/docs/community/devs/verify.md
index d9e2835..5e36331 100644
--- a/docs/community/devs/verify.md
+++ b/docs/community/devs/verify.md
@@ -29,14 +29,16 @@ wget -r -np -nd -A "*" -e robots=off
https://dist.apache.org/repos/dist/dev/incu
The release candidate artifacts should have a checksum and signature file.
-For example, if the release candidate is `10.0.0-rc1`, the checksum and
signature file should be:
+For example, if the release candidate is `10.3.0-rc1`, the checksum and
signature file should be:
```
-https://dist.apache.org/repos/dist/dev/incubator/kie/10.0.0-rc1/incubator-kie-10.0.0-rc1-sources.zip.sha512
+https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-rc1/apache-kie-10.3.0-incubating-sources.zip.sha512
-https://dist.apache.org/repos/dist/dev/incubator/kie/10.0.0-rc1/incubator-kie-10.0.0-rc1-sources.zip.asc
+https://dist.apache.org/repos/dist/dev/incubator/kie/10.3.0-rc1/apache-kie-10.3.0-incubating-sources.zip.asc
```
+Every file in the folder (source archives, `.vsix` extensions, Chrome
extensions, web apps, Helm charts, container images, upload-service binaries)
must have its own `.asc` and `.sha512`.
+
### Verify checksums and signatures
#### GnuPG setup
@@ -95,7 +97,7 @@ for i in *.{tar.gz,zip,vsix}; do echo $i; gpg --verify $i.asc
$i; done
If something like the following appears, it means the signature is correct:
```bash
-incubator-kie-10.0.0-rc1-sources.zip
+apache-kie-10.3.0-incubating-sources.zip
gpg: Signature made Fri Sep 27 15:53:27 2024 EDT
gpg: using RSA key 1384A644F9BFA0F54C84488C3B0DD7480424A676
gpg: Good signature from "Apache KIE Automated Release Signing
<[email protected]>" [ultimate]
@@ -110,8 +112,8 @@ for i in *.{tar.gz,zip,vsix}; do echo $i; sha512sum --check
$i.sha512; done
It should output something like:
```bash
-incubator-kie-10.0.0-rc1-sources.zip
-incubator-kie-10.0.0-rc1-sources.zip: OK
+apache-kie-10.3.0-incubating-sources.zip
+apache-kie-10.3.0-incubating-sources.zip: OK
```
#### How to verify if the container images are valid
@@ -123,28 +125,39 @@ for i in *image.tar.gz; do echo $i; docker load -q -i $i
&& echo "OK" || echo "E
It should output something like:
```bash
-incubator-kie-10.0.0-rc1-serverless-logic-web-tools-swf-dev-mode-image.tar.gz
-Loaded image:
apache/incubator-kie-serverless-logic-web-tools-swf-dev-mode:10.0.0
+apache-kie-10.3.0-incubating-cors-proxy-image.tar.gz
+Loaded image: apache/incubator-kie-cors-proxy:10.3.0
OK
```
Errors would look something like:
```bash
-incubator-kie-10.0.0-rc1-sonataflow-devmode-image.tar.gz
+apache-kie-10.3.0-incubating-cors-proxy-image.tar.gz
open /var/lib/docker/tmp/docker-import-2603585138/repositories: no such file
or directory
Error
```
+## Verify the DRL VS Code extension (new in 10.3)
+
+The `apache-kie-10.3.0-incubating-drl-vscode-extension.vsix` file must be
present, signed and checksummed like the other files. Then install it and try
it:
+
+```bash
+code --install-extension apache-kie-10.3.0-incubating-drl-vscode-extension.vsix
+```
+
+Open a `.drl` file and check that syntax highlighting and code completion
work. Java 17+ and Maven must be installed.
+
## Check the file content of the source package
-Unzip `apache-kie-${release_version}-${rc_version}-sources.zip` and check the
follows:
+The SVN dev folder contains one source archive,
`apache-kie-${release_version}-incubating-sources.zip` (Tools,
`incubator-kie-tools`). The Java code (`incubator-kie`) is released through the
Nexus staging repository (JARs, POMs, sources and Javadocs), not as a source
ZIP in SVN.
+
+Unzip the archive and check the following:
-- LICENSE and NOTICE files in the root directory are correct.
+- `LICENSE`, `NOTICE` and `DISCLAIMER-WIP` files in the root directory are
correct.
- All files have ASF license headers if necessary. Apache Rat helps the
verification.
- - In the root directory of the sources package,
+ - In the root directory of the unzipped package,
- Download the jar: `curl -LO
https://repo1.maven.org/maven2/org/apache/rat/apache-rat/0.17/apache-rat-0.17.jar`
- - Run `java -jar apache-rat-0.17.jar -E .rat-excludes-combined -- . >
rat-result.txt` (It takes a few minutes. `.rat-excludes-combined` has been
introduced since 10.1.0 release candidates)
- - NOTE: If `.rat-excludes-combined` doesn't exist under the root
directory, do the steps (run apache-rat, review the result) under the
subdirectories, which have `.rat-excludes` instead.
+ - Run `java -jar apache-rat-0.17.jar -E .rat-excludes -- . >
rat-result.txt` (It takes a few minutes. The repository has a `.rat-excludes`
file in the root directory.)
- Review the `rat-result.txt`. `Files with unapproved licenses:` should be
one of the followings
- Listed in `LICENSE`
- Not a source code (e.g. test data, config file)
diff --git a/src/pages/community/build.tsx b/src/pages/community/build.tsx
index 73c7c2f..378bd71 100644
--- a/src/pages/community/build.tsx
+++ b/src/pages/community/build.tsx
@@ -2,5 +2,5 @@ import {Redirect} from '@docusaurus/router';
// Latest release — update for each new release
export default function BuildRedirect(): JSX.Element {
- return <Redirect to="/community/devs/build-10.2" />;
+ return <Redirect to="/community/devs/build-10.3" />;
}
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]