Release Version v3.42.0-gitlab
Changes
3.42.0 (2022-05-18)
Bug Fixes
- restore manifest push (by tag) and tag delete webhook notifications (e6a7984)
Features
- storage: improve clarity of offline garbage collection log output (8b6129a)
Tasks
All tasks must be completed (in order) for the release to be considered workflowproduction.
1. Prepare
-
Set the milestone of this issue to the target GitLab release. -
Set the due date of this issue to the 12th of the release month.
Instructions
The due date is set to the 12th of each month to create a buffer of 5 days before the merge deadline on the 17th. See Product Development Timeline for more information about the GitLab release timings.2. Release
Generate a new release (documentation).
3. Update
-
Version bump in CNG: -
Update GITLAB_CONTAINER_REGISTRY_VERSION
inci_files/variables.yml
-
Update REGISTRY_VERSION
ingitlab-container-registry/Dockerfile
-
Update REGISTRY_VERSION
ingitlab-container-registry/Dockerfile.build.ubi8
-
Label merge request with: /label ~"group::distribution" ~"devops::enablement" ~"workflow::ready for review" ~"type::maintenance"
-
-
Version bumps for specific distribution paths: -
Version bump in Omnibus: -
Update version
inconfig/software/registry.rb
and use theChangelog: changed
commit trailer in the commit message -
Label merge request with: /label ~"workflow::ready for review" ~"type::maintenance"
-
Copy the changelog description from https://gitlab.com/gitlab-org/container-registry/-/blob/master/CHANGELOG.md since the last upgrade to the MR description.
-
-
Version bump in Charts. If the change is not time sensitive and we are not close to the monthly GitLab release date (more than a week before), you may wait for the Gitlab Dependency Bot to create a version bump MR (example). You should then associate that MR with this release issue for visibility. Otherwise, please proceed as follows: -
Update appVersion
incharts/registry/Chart.yaml
-
Update image.tag
incharts/registry/values.yaml
-
Update image.tag
indoc/charts/registry/index.md
, under the Configuration, Installation command line options and Configuring theimage
sections -
Add Changelog: changed
as commit trailer in the commit message -
Label merge request with: /label ~"group::distribution" ~"devops::enablement" ~"workflow::ready for review" ~"type::maintenance"
-
Copy the changelog description from https://gitlab.com/gitlab-org/container-registry/-/blob/master/CHANGELOG.md since the last upgrade to the MR description.
-
-
Version bump in K8s Workloads. This requires two separate MRs, one for pre-production and staging and another for production, which need to be created and merged in this order. Allow enough time between the two to confirm that everything is working as expected in pre-production and staging. For all environments, update registry_version
under the respective stanza for each environment inbases/environments.yaml
:-
Pre-production and staging -
Update registry_version
underpre
andgstg
-
Label with: /label ~"Service::Container Registry" ~"team::delivery" ~"workflow::ready for review"
-
Copy the changelog description from https://gitlab.com/gitlab-org/container-registry/-/blob/master/CHANGELOG.md since the last upgrade to the MR description. -
Assign to a reviewer
-
-
Production -
Update registry_version
undergprd
-
Label with: /label ~"Service::Container Registry" ~"team::delivery" ~"workflow::ready for review"
-
Copy the changelog description from https://gitlab.com/gitlab-org/container-registry/-/blob/master/CHANGELOG.md since the last upgrade to the MR description. -
Assign to a reviewer
-
-
-
-
Version bump for GDK: -
Update "${registry_image:-registry.gitlab.com/gitlab-org/build/cng/gitlab-container-registry:vX.Y.Z-gitlab}"
, which is passed to thedocker run
command in support/docker-registry -
Label with: /label ~"workflow::ready for review" ~"group::package" ~"devops::package"
-
Copy the changelog description from https://gitlab.com/gitlab-org/container-registry/-/blob/master/CHANGELOG.md since the last upgrade to the MR description. -
Assign to the reviewer suggested by reviewer roulette
-
Instructions
Bump the Container Registry version used in CNG, Omnibus, Charts and K8s Workloads.
The CNG image is the pre-requisite for the remaining version bumps which may be merged independently from each other. Only CNG and K8s Workloads version bumps are required for a GitLab.com deployment. The deployment is then completed as documented here. Charts and Omnibus version bumps are required for self-managed releases.
Create a merge request for each project. Mark parent tasks as completed once the corresponding merge requests are merged.
Version bump merge requests should appear automatically in the Related merge requests
section of this issue.
Note: According to the Distribution Team Merge Request Handling documentation, we should not assign merge requests to an individual.
Merge Request Template
For consistency, please use the following template for these merge requests:
Branch Name
bump-container-registry-vX-Y-Z-gitlab
Commit Message
Bump Container Registry to vX.Y.Z-gitlab
Changelog: changed
Title
Bump Container Registry to vX.Y.Z-gitlab
Description
Repeat the version subsection for multiple versions. As an example, to bump to v2.7.7 in a project where the current version is v2.7.5, create an entry for v2.7.6 and v2.7.7.
## vX.Y.Z-gitlab
[Changelog](https://gitlab.com/gitlab-org/container-registry/blob/release/X.Y-gitlab/CHANGELOG.md#vXYZ-gitlab-YYYY-MM-DD)
Related to <!-- link to this release issue -->.
4. Complete
-
Assign label workflowverification once all changes have been merged. -
Assign label workflowproduction once all changes have been deployed. -
Update all related issues, informing that the deploy is complete. -
Close this issue.