Skip to content

Commit f146b0d

Browse files
authored
Add more details to release process (#3031)
Add more details to release process.
1 parent 50ebdb9 commit f146b0d

File tree

2 files changed

+5
-5
lines changed

2 files changed

+5
-5
lines changed

docs/developer/release-process.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,9 @@ To create a new release, follow these steps:
4242
3. Create a release branch following the `release-X.Y` naming convention.
4343
4. Once the release branch pipeline completes, run tests using the `release-X.X-rc` images that are pushed to Github (for example, `release-1.3-rc`).
4444
1. Kick off the [longevity tests](https://github.com/nginx/nginx-gateway-fabric/blob/main/tests/README.md#longevity-testing) for both OSS and Plus. You'll need to create two clusters and VMs for this. Before running, update your `vars.env` file with the proper image tag and prefixes. NGF and nginx images will be available from `ghcr.io`, and nginx plus will be available in GCP (`us-docker.pkg.dev/<GCP_PROJECT_ID>/nginx-gateway-fabric/nginx-plus`). These tests need to run for 4 days before releasing. The results should be committed to the main branch and then cherry-picked to the release branch.
45-
2. Kick off the [NFR workflow](https://github.com/nginx/nginx-gateway-fabric/actions/workflows/nfr.yml) in the browser. For `image_tag`, use `release-X.X-rc`, and for `version`, use the upcoming `X.Y.Z` NGF version. This will run all of the NFR tests which are automated and open a PR with the results files when it is complete. Review this PR and make any necessary changes before merging. Once merged, be sure to cherry-pick the commit to the main branch as well (the original PR targets the release branch).
45+
2. Kick off the [NFR workflow](https://github.com/nginx/nginx-gateway-fabric/actions/workflows/nfr.yml) in the browser. For `image_tag`, use `release-X.X-rc`, and for `version`, use the upcoming `X.Y.Z` NGF version. Run the workflow on the new release branch. This will run all of the NFR tests which are automated and open a PR with the results files when it is complete. Review this PR and make any necessary changes before merging. Once merged, be sure to cherry-pick the commit to the main branch as well (the original PR targets the release branch).
4646
5. Run the [Release PR](https://github.com/nginx/nginx-gateway-fabric/actions/workflows/release-pr.yml) workflow to update the repo files for the release. Then there are a few manual steps to complete:
47-
1. Update the version tag used in the [provisioner manifest](/tests/conformance/provisioner/provisioner.yaml) and [getting started guide](/site/content/get-started).
47+
1. Update the version tag used in the [provisioner manifest](/tests/conformance/provisioner/provisioner.yaml) and [getting started guide](/site/content/get-started.md).
4848
2. Update the [README](/README.md) to include information about the release.
4949
3. Update the [changelog](/CHANGELOG.md). There is going to be a new blank section generated by the automation that needs to be adjusted accordingly.
5050
- At the top there will be a list of all PRs that are labeled with `release-notes`.
@@ -53,9 +53,9 @@ To create a new release, follow these steps:
5353
step. As a starting point, copy the important features, bug fixes, and dependencies from the autogenerated
5454
draft of the full changelog. This draft can be found under
5555
the [GitHub releases](https://github.com/nginx/nginx-gateway-fabric/releases) after the release branch is
56-
created.
56+
created. If included, use the Release Notes specified in a PR.
5757
- If the supported Gateway API minor version has changed since the last release, add a note to the release notes explaining if the previous version is no longer supported.
58-
6. Create and push the release tag in the format `vX.Y.Z`. As a result, the CI/CD pipeline will:
58+
6. Ensure you are on the latest version of the release branch and are up-to-date on all commits, then create and push the release tag in the format `vX.Y.Z`. As a result, the CI/CD pipeline will:
5959
- Build NGF, NGINX and NGINX Plus container images with the release tag `X.Y.Z` and push them to the registries.
6060
- Package and publish the Helm chart to the registry.
6161
- Create a GitHub release with an autogenerated changelog and attached release artifacts.

tests/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -318,7 +318,7 @@ make nfr-test
318318
This test is run on its own (and also not in a pipeline) due to its long-running nature. It will run for 4 days before
319319
the tester must collect the results and complete the test.
320320

321-
To start the longevity test, set up your VM (`create-and-setup-vm`) and run
321+
To start the longevity test, set up your VM (`create-and-setup-vm`), router (`create-gke-router`), and run
322322

323323
```makefile
324324
make start-longevity-test

0 commit comments

Comments
 (0)