Commit Graph
151 Commits
Author SHA1 Message Date
Joshua Hoblitt adda6b17d3 build: validate the release version before tagging and publishing
Nothing verified that the commit being tagged for a release actually
carries the intended version. Tagging a release branch before the version
update PR is merged publishes images and manifests that reference the
previous release. Add build/release/validate-tag.sh to check that the tree
is clean and that deploy/examples/images.txt and the helm chart values
match the tag, run it from the release build workflow before any artifact
is published, and document it in the tagging steps. Alpha tags are exempt
as they only mark the creation of a release branch.

Signed-off-by: Joshua Hoblitt <josh@hoblitt.com>
2026-07-28 13:47:54 -07:00
Joshua Hoblitt 8b2bedfa9a build: retry the docs deploy when the gh-pages push is rejected
Publishing docs runs mike deploy against the rook.github.io gh-pages
branch. When two builds run close together, the branch can advance
between one build's fetch and its push, and the push is rejected as
non-fast-forward, failing the whole push-image-to-container-registry
job even though the images were already published (most recently on the
2026-07-06 master push burst). Reset the local gh-pages branch to the
remote tip and retry the deploy up to three times, so a lost race
redeploys onto the new tip instead of failing the build.

Signed-off-by: Joshua Hoblitt <josh@hoblitt.com>
2026-07-06 13:02:30 -07:00
Joshua Hoblitt 9e35153876 docs: note the support matrix update in the release process
Add a step to the release process, when creating a new release branch,
to add a row for the new release series to the support matrix in the
Maintenance and Support page. This keeps the matrix current as new
minor versions are released.

Signed-off-by: Joshua Hoblitt <josh@hoblitt.com>
2026-07-01 08:18:20 -07:00
Prabhala Tara Aasrita f699960a31 build: remove v prefix from helm chart version tag
Removed the leading v from the Helm OCI chart version tag so that helm pull can auto-resolve the latest version without specifying the tag explicitly.

Signed-off-by: Prabhala Tara Aasrita <taraasrita@ibm.com>
2026-06-29 11:25:14 +05:30
parth-gr dbc8d2a541 external: update the external cluster to make use of csi op
updated the external cluster doc, and helm and manifest
install to make use of csi operator as it is the default
offering now

Signed-off-by: parth-gr <partharora1010@gmail.com>
2026-06-11 19:10:30 +05:30
subhamkrai c3e06c4cef docs: update csi-driver value.yaml reference link
this commit update the link which refere the csi-driver
chart value.yaml to update it dynamically when release
is done from master to release or release to release tag.

Signed-off-by: subhamkrai <srai@redhat.com>
2026-06-09 10:03:00 +05:30
Prabhala Tara Aasrita d591037b4d ci: upgrade checkout action to v6.0.2
actions/checkout v6 changed how credentials are persisted. Instead of writing GITHUB_TOKEN as an extraheader in .git/config, it now stores a pointer to a credential helper file in $RUNNER_TEMP. The Makefile's `git config --unset http.https://github.com/.extraheader` no longer clears the token, so the cross-repo push to rook.github.io was failing.

I have updated the checkout action to v6.0.2, set the persist-credentials field to false and removed the unset line from releases/Makefile.

Signed-off-by: Prabhala Tara Aasrita <taraasrita@ibm.com>
2026-04-07 21:48:16 +05:30
subhamkrai 0dab47d408 build: use buildx instead of manifest-tool
instead of using of using manifest-tool and updating
it's version, we can use docker buildx which works like
manifest-tool only and based on manifest-tool working.

Signed-off-by: subhamkrai <srai@redhat.com>
2026-02-17 15:01:50 +05:30
Travis Nielsen 9a23e7c91b Revert "build: fix docs publish from extraheader error"
This reverts commit 4a03715386.
2025-11-25 15:30:32 -07:00
Travis Nielsen beac8244ae Revert "build: use proper github token for docs publish"
This reverts commit 09e7952600.
2025-11-25 15:27:36 -07:00
Travis Nielsen 09e7952600 build: use proper github token for docs publish
The docs publish requires a token with write access to
the docs repo, so override the default rook repo
github token.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2025-11-25 14:18:41 -07:00
Travis Nielsen 4a03715386 build: fix docs publish from extraheader error
Removing the .extraheader config is failing with
error 5. Attempt to remove this call to attempt
to get the docs publishing successfully again.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2025-11-25 11:37:59 -07:00
subhamkrai 7dd21a0468 build: use cosign to sign the images/helm charts
this commit added changes to use cosign to sign the
docker images and the helm charts being published to
different the oci repos. This will enhance software supply
chain security by enabling signing and verification of
container images, ensuring their authenticity and integrity

Signed-off-by: subhamkrai <srai@redhat.com>
2025-09-19 12:05:28 +05:30
Michael AdamandTravis Nielsen 987e9c8bb5 build: merge helm indexes instead of recreating for every release (really)
A new helm repo index was created from scratch for every new release
    which meant that the release timestamps in the index were basically all
    identical.

    This change intends to fix that by merging the new index with the
    existing one

The first attempt to fix this (PR #16033) did not work properly.
This change is intended to fix the issue for good by closing the gap the
previuous PR has left.

    Fixes: #15604

Co-Authored-By: Travis Nielsen <tnielsen@redhat.com>
Signed-off-by: Michael Adam <obnox@samba.org>
2025-06-23 16:57:33 +02:00
Michael Adam 2704f23ea7 build: merge helm indexes instead of recreating for every release
A new helm repo index was created from scratch for every new release
which meant that the release timestamps in the index were basically all
identical.

This change intends to fix that by merging the new index with the
existing one

Fixes: #15604

Signed-off-by: Michael Adam <obnox@samba.org>
2025-06-19 22:24:07 +02:00
Travis Nielsen 0f0b3b2df8 Revert "ci: only publish docs in master and tagged releases"
This reverts commit 28fa387dff.
2025-05-08 12:19:13 -06:00
subham rai 3be9c92f1a Merge pull request #15830 from travisn/docs-publish
ci: Only publish docs in master and tagged releases
2025-05-06 11:08:17 +05:30
Travis Nielsen 28fa387dff ci: only publish docs in master and tagged releases
Until now, docs have been published for every master and
release branch build. This can lead to confusion if a new
feature is backported to the release branch and the docs
are published to the website, even though the feature will
not be available until the next tagged release.

This does have the effect that small doc-only fixes will
not be in the latest release docs until we actually tag
a release.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2025-05-05 13:44:07 -06:00
Michael Adam d7f2a4b4d8 build: move se-release-ver script to better place
The script sel-release-ver.sh was added in a somewhat unnatural place
tests/scripts .
This moves it to a more natural location build/release .

Signed-off-by: Michael Adam <obnox@samba.org>
2025-05-05 17:02:39 +02:00
a1b941f969 build: add a script for setting the release version in examples,docs, and charts
This script updates examples and docs for a new release.

Invocation in principle: set-release-ver.sh  NEW_VER
For example: set-release-ver.sh v1.16.8

Fixes: #15749

Signed-off-by: Michael Adam <obnox@samba.org>
Co-authored-by: Travis Nielsen <tnielsen@redhat.com>
Co-authored-by: Blaine Gardner <b.blaine.gardner@gmail.com>
2025-05-01 10:36:26 -06:00
Michael Adam 47a3ec3466 docs: slightly improve wording in release guide
Reading the release process documentation, I found the description
of steps in one place to not quite match the intended effect of the
actual command steps due to a slight imprecision in used terminology.

This change improves and clarifies the corresponding wording to hopefully
prevent others from facing the same confusion.

Signed-off-by: Michael Adam <obnox@samba.org>
2025-04-23 12:25:53 +02:00
Travis Nielsen 63e13868ea build: push arch specific images to the registries
The arch specific images were not be pushed since the make
target was missing.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2025-04-21 14:37:19 -06:00
Travis Nielsen 7d908d0a5e build: stop publishing charts in master branch
The helm charts will now only be published when it is
an officially tagged release build.

The images will only be published to all repos for
dockerhub, quay, and ghcr when it is a tagged release.

The images will be published only to dockerhub for all
master and interim release branch builds.

Remove obsolete makefile option for images.
Ceph is the only image Rook ever expects to build.
Simplify the makefile by removing the legacy option
to select which image to build.

Also included are other small improvements to clean up
the release scripts.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2025-04-18 10:40:29 -06:00
Allen Conlon 1291045c7f ci: fix push version mismatch
Signed-off-by: Allen Conlon <software@conlon.dev>
2025-03-25 17:04:48 -04:00
Allen Conlon 2cbcbffd52 ci: fix version of chart not existing
Signed-off-by: Allen Conlon <software@conlon.dev>
2025-03-25 15:50:13 -04:00
Allen Conlon fa2e499727 ci: publish helm charts to oci repos
Signed-off-by: Allen Conlon <software@conlon.dev>
2025-03-21 20:15:59 -04:00
subhamkrai df3c757141 ci: push rook image to other oci like quay,ghcr
currently rook images are only available in docker,
let's start pushing rook images to quay.io and ghcr.io as well.

Signed-off-by: subhamkrai <srai@redhat.com>
2025-02-27 09:44:29 +05:30
subhamkrai ea159ad9b7 ci: remove extra comma from platforms
The last pr missed removing the extra comma after the platform
so, instead of ` linux/amd64,linux/arm64,` it should be
` linux/amd64,linux/arm64`.

Signed-off-by: subhamkrai <srai@redhat.com>
2024-05-16 14:47:51 +05:30
subhamkrai f89540c4ef ci: push image ci failing in ubuntu 22.04
since we moved to ubuntu 22.04, ci push image build is failing
due wrong parameter `--platforms linux/amd64 linux/arm64,` it should
be instead `--platforms linux/amd64, linux/arm64`.

Signed-off-by: subhamkrai <srai@redhat.com>
2024-05-15 22:09:16 +05:30
Scott Miller e28c107a76 build: fix bad quotation in make help
Signed-off-by: Scott Miller <smiller1@coreweave.com>
2024-01-25 13:01:01 +00:00
Blaine Gardner b2d6459f2a doc: update release doc
Update the release doc to include the latest process used to create the
new 1.13 release branch.

Make a few minor changes to the patch update process to keep formatting
the same between new-release-branch and new-patch processes.

Signed-off-by: Blaine Gardner <blaine.gardner@ibm.com>
2023-12-06 09:43:44 -07:00
Travis Nielsen 96b24097c2 Merge pull request #13150 from koor-tech/fix_mike_deploy
ci: fix mike deploy flags
2023-11-03 10:11:43 -06:00
Alexander Trost 4a48c14861 ci: fix mike deploy flags
This fixes the docs deploy issues caused by the mike 2.0.0 release that
removed/renamed some flags, see
https://github.com/jimporter/mike/releases/tag/v2.0.0

Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2023-11-03 17:03:08 +01:00
subhamkrai b186150e1c ci: fix mkdocs deprecated imports
migrate to using mkdocs-material's material.extensions.emoji.twemoji
and material.extensions.emoji.to_svg in place of the respective
materialx.emoji.twemoji and materialx.emoji.to_svg. Also, this requires
latest version of mkdocs-material.

Signed-off-by: subhamkrai <srai@redhat.com>
2023-10-18 15:54:46 +05:30
Alexander Trost ecb6ba7383 build: allow overriding variables from a dot env file
This helps forks build custom rook releases more easily by allowing
certain Makefile vars to be overwriten using a `.env` file.
In addition this introduces the `DOCKERCMD` var to the
`build/release/Makefile`.

Signed-off-by: Alexander Trost <galexrt@googlemail.com>
Signed-off-by: Deepika Upadhyay <deepika@koor.tech>
Signed-off-by: Zuhair AlSader <zuhair@koor.tech>
2023-03-31 11:34:07 -04:00
Alexander Trost b12569c423 docs: add release instructions
Thanks to @travisn for providing his release procedure notes!

Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2023-01-19 19:01:45 +01:00
Alexander Trost 1724cdcb92 build: use script to reliably determine latest released release branch
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-09-20 23:38:45 +02:00
Travis Nielsen c4304e4b92 docs: update the latest-release docs to 1.10
With the v1.10.0 release out, the latest-release docs need
to point to the 1.10 release. With each release we will
update to the next release branch when we have shipped.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2022-09-01 12:45:25 -06:00
Alexander Trost a0cb255f90 build: fix working dir for docs building
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-06-28 09:34:56 +02:00
Alexander Trost 158c6187e0 docs: use exclude plugin to ignore the readme.md file
Right now te Documentation/README.md file is read and rendered but due
its location reports broken links as we link it into the
Documentation/Getting-Started/intro.md.

Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-06-27 13:30:08 +02:00
Alexander Trost de28a21879 build: add separate docs build and preview targets
This adds two new make target for building and previewing the current
state of the documentation locally.

Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-06-27 13:29:25 +02:00
Alexander Trost de5777cde0 build: remove extraheader from git config
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-24 19:41:55 +02:00
Alexander Trost 46fa71c720 docs: build docs from repo root
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-24 17:01:09 +02:00
Alexander Trost 2f75104238 docs: don't cd during docs publish
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-24 16:11:49 +02:00
Alexander Trost a156dc3ae7 docs: fix docs_dir build issue
Resolves #10282

Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-24 11:55:21 +02:00
Travis Nielsen c375bbd6f4 ci: mkdocs.yml must be in the release build folder
The docs failed to publish with the mkdocs.yml in the root
folder instead of where the docs are being built.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2022-05-19 15:12:30 -06:00
Travis Nielsen 03a091e741 ci: fix the doc build generation script
The doc build generation script is failing to install
the needed dependencies for mkddocs.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2022-05-19 14:05:18 -06:00
Alexander Trost 0d815c0ffc docs: fix docs publish repo target
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-19 13:27:07 +02:00
Travis Nielsen 557feb2f49 build: move the help doc requirements to release folder
The requirements_docs.txt is expected by the build.docs
build target in build/release. Since the txt file was at
the root of the repo, the build was failing to be pubished
when it didn't find the file in build/release.

Signed-off-by: Travis Nielsen <tnielsen@redhat.com>
2022-05-18 15:52:07 -06:00
Alexander Trost 74431443e3 docs: use mkdocs and restructure docs
Signed-off-by: Alexander Trost <galexrt@googlemail.com>
2022-05-18 16:06:22 +02:00