Merge pull request #91968 from k37y/jkns-faq

JKNS-630: Support Matrix for OpenShift Jenkins releases

Author: ShaunaDiaz

modules/relocation-of-openshift-jenkins-images.adoc

@@ -17,17 +17,17 @@
 
 .What changes in the support matrix of the OpenShift Jenkins image?
 
-Each new image in the `ocp-tools-4` repository in the `registry.redhat.io` registry supports multiple versions of {product-title}. When Red Hat updates one of these new images, it is simultaneously available for all versions. This availability is ideal when Red Hat updates an image in response to a security advisory. Initially, this change applies to {product-title} 4.11 and later. It is planned that this change will eventually apply to {product-title} 4.9 and later.
+Each new image in the `ocp-tools-4` repository in the `registry.redhat.io` registry supports multiple versions of {product-title}. When Red{nbsp}Hat updates one of these new images, it is simultaneously available for all versions. This availability is ideal when Red{nbsp}Hat updates an image in response to a security advisory. Initially, this change applies to {product-title} 4.11 and later. It is planned that this change will eventually apply to {product-title} 4.9 and later.
 
-Previously, each Jenkins image supported only one version of {product-title} and Red Hat might update those images sequentially over time.
+Previously, each Jenkins image supported only one version of {product-title} and Red{nbsp}Hat might update those images sequentially over time.
 
 .What additions are there with the OpenShift Jenkins and Jenkins Agent Base ImageStream and ImageStreamTag objects?
 
-By moving from an in-payload image stream to an image stream that references non-payload images, {product-title} can define additional image stream tags. Red Hat has created a series of new image stream tags to go along with the existing `"value": "jenkins:2"` and `"value": "image-registry.openshift-image-registry.svc:5000/openshift/jenkins-agent-base-rhel8:latest"` image stream tags present in {product-title} 4.10 and earlier. These new image stream tags address some requests to improve how the Jenkins-related image streams are maintained.
+By moving from an in-payload image stream to an image stream that references non-payload images, {product-title} can define additional image stream tags. Red{nbsp}Hat has created a series of new image stream tags to go along with the existing `"value": "jenkins:2"` and `"value": "image-registry.openshift-image-registry.svc:5000/openshift/jenkins-agent-base-rhel8:latest"` image stream tags present in {product-title} 4.10 and earlier. These new image stream tags address some requests to improve how the Jenkins-related image streams are maintained.
 
 About the new image stream tags:
 
-`ocp-upgrade-redeploy`:: To update your Jenkins image when you upgrade {product-title}, use this image stream tag in your Jenkins deployment configuration. This image stream tag corresponds to the existing `2` image stream tag of the `jenkins` image stream and the `latest` image stream tag of the `jenkins-agent-base-rhel8` image stream. It employs an image tag specific to only one SHA or image digest. When the `ocp-tools-4` image changes, such as for Jenkins security advisories, Red Hat Engineering updates the Cluster Samples Operator payload.
+`ocp-upgrade-redeploy`:: To update your Jenkins image when you upgrade {product-title}, use this image stream tag in your Jenkins deployment configuration. This image stream tag corresponds to the existing `2` image stream tag of the `jenkins` image stream and the `latest` image stream tag of the `jenkins-agent-base-rhel8` image stream. It employs an image tag specific to only one SHA or image digest. When the `ocp-tools-4` image changes, such as for Jenkins security advisories, Red{nbsp}Hat Engineering updates the Cluster Samples Operator payload.
 
 `user-maintained-upgrade-redeploy`:: To manually redeploy Jenkins after you upgrade {product-title}, use this image stream tag in your Jenkins deployment configuration. This image stream tag uses the least specific image version indicator available. When you redeploy Jenkins, run the following command: `$ oc import-image jenkins:user-maintained-upgrade-redeploy -n openshift`. When you issue this command, the {product-title} `ImageStream` controller accesses the `registry.redhat.io` image registry and stores any updated images in the {product-registry}'s slot for that Jenkins `ImageStreamTag` object. Otherwise, if you do not run this command, your Jenkins deployment configuration does not trigger a redeployment.
 
@@ -49,3 +49,44 @@ $ oc import-image jenkins-agent-nodejs -n openshift
 ----
 $ oc import-image jenkins-agent-maven -n openshift
 ----
+
+.What {product-title} architectures and versions does OpenShift Jenkins support?
+
+Jenkins supports the following architectures across {product-title} releases:
+
+- `amd64`
+- `arm64`
+- `ppc64le`
+- `s390x`
+
+However, for {product-title} Extended Update Support (EUS) releases, only the `amd64` architecture is officially supported. As a result, OpenShift Jenkins images are shipped exclusively for `amd64` on these releases. This is because the {product-title} platform itself supports only the `amd64` architecture for EUS releases. For more information, see link:https://access.redhat.com/articles/7115356[Support Matrix for OpenShift Jenkins releases].
+
+.When Red{nbsp}Hat updates Jenkins container images, are they available for all {product-title} versions simultaneously?
+
+Yes, Jenkins container images are updated on a quarterly basis, and the updates are made available for all supported Jenkins images across all supported {product-title} releases.
+
+.How long are the released Jenkins images supported?
+
+Red{nbsp}Hat supports only the latest Long-Term Support (LTS) version of the Jenkins core, as provided in our latest container images. We do not support multiple core versions. Our policy is to align with the latest Jenkins LTS version released by the upstream community.
+
+.Does the Jenkins release align with {product-title} versions?
+
+Yes. Our goal is to maintain platform alignment. This means that Jenkins controller and agent images are built and tested for each supported {product-title} releases.
+
+.Are Jenkins release timelines aligned with {product-title} release cycles?
+
+Jenkins is no longer part of the {product-title} core payload. Releases are managed separately. However, our intent is to publish updated OpenShift Jenkins images for newly released {product-title} releases within a few weeks of the {product-title} GA release.
+
+.Does Red{nbsp}Hat follow the upstream Jenkins lifecycle and LTS versions?
+
+Yes. We align with the Jenkins upstream lifecycle and follow the LTS version. Red{nbsp}Hat typically ships OpenShift Jenkins image updates quarterly unless a critical fix requires an out-of-cycle release.
+
+To verify the current Jenkins LTS version:
+- Navigate to the Jenkins Catalog -> Packages section
+- Search for “Jenkins”
+- The result will show two packages, one of which is the Jenkins LTS package.
+
+.What is not supported?
+- Jenkins versions older than the current OpenShift Jenkins LTS are not supported.
+- Running Jenkins outside of {product-title} is not supported.
+- Multiple core versions of Jenkins are not supported. Plugins bundled with our OpenShift Jenkins images follow the same versioning across all supported {product-title} releases.