diff --git a/docs/assets/release.drawio b/docs/assets/release.drawio deleted file mode 100644 index e885e524a..000000000 --- a/docs/assets/release.drawio +++ /dev/null @@ -1,394 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/assets/release.drawio.svg b/docs/assets/release.drawio.svg new file mode 100644 index 000000000..374809b90 --- /dev/null +++ b/docs/assets/release.drawio.svg @@ -0,0 +1,4 @@ + + + +
GitHub Actions
GitHub Actions
GitHub Actions
GitHub Actions
unit tests job
unit tests job
unit tests job
unit tests job
stress tests
E2E tests jobs
stress tests...
E2E tests jobs
E2E tests jobs
GitHub repository
GitHub repository
GitHub repository
GitHub repository
Image Builder
Image Builder
Image Builder
Image Builder
Docker registry
Docker registry
Docker registry
Docker registry
Create a release
Create a release
initiate
initiate
fetch binary image, module image
fetch binary image, module image
uploads binary 
image
uploads binary...
9
9
initiate
initiate
3
3
6
6
7
7
validate release job
validate release job
bump security
 scanner config job
bump security...
initiate
initiate
2
2
returns result
returns result
returns PR to approve
returns PR to approve
initiates
initiates
1
1
approves PR
approves PR
4
4
returns result
returns result
create tag and draft release
create tag and draft release
5
5
initiate
initiate
6
6
returns result
returns result
initiate
initiate
8
8
returns result
returns result
publish release
publish release
10
10
bump security
 scanner config job
bump security...
validate release job
validate release job
returns result
returns resultText is not SVG - cannot display \ No newline at end of file diff --git a/docs/assets/release.svg b/docs/assets/release.svg deleted file mode 100644 index 78d82bc6d..000000000 --- a/docs/assets/release.svg +++ /dev/null @@ -1,4 +0,0 @@ - - - -
GitHub Actions
GitHub Actions
GitHub Actions
GitHub Actions
unit tests job
unit tests job
unit tests job
unit tests job
stress tests
E2E tests jobs
stress tests...
E2E tests jobs
E2E tests jobs
GitHub repository
GitHub repository
GitHub repository
GitHub repository
post-btp-manager-build
post-btp-manager-bui...
post-btp-manager-build
post-btp-manager-bui...
Docker registry
Docker registry
Docker registry
Docker registry
Create a release
Create a release
triggers building binary image
triggers building...
fetch binary image, module image
fetch binary image, module image
uploads binary image
uploads binary image
10
10
initiate
initiate
3
3
7
7
8
8
validate release job
validate release job
bump security
 scanner config job
bump security...
await for Prow jobs status job
await for Prow jobs...
initiate
initiate
2
2
returns result
returns result
returns PR to approve
returns PR to approve
initiates
initiates
1
1
approves PR
approves PR
4
4
returns result
returns result
create tag and draft release
create tag and draft release
5
5
initiate
initiate
6
6
returns result
returns result
initiate
initiate
6
6
returns result
returns result
initiate
initiate
9
9
returns result
returns result
publish release
publish release
11
11
await for Prow jobs status job
await for Prow jobs...
bump security
 scanner config job
bump security...
validate release job
validate release jobText is not SVG - cannot display \ No newline at end of file diff --git a/docs/contributor/03-10-release.md b/docs/contributor/03-10-release.md index 5107ef386..487534f6f 100644 --- a/docs/contributor/03-10-release.md +++ b/docs/contributor/03-10-release.md @@ -10,7 +10,7 @@ The BTP Manager release pipeline creates proper artifacts: ### Create a Release -![Release diagram](../assets/release.svg) +![Release diagram](../assets/release.drawio.svg) To create a release, follow these steps: @@ -25,13 +25,12 @@ To create a release, follow these steps: 2. The GitHub action, defined in the [`create-release`](/.github/workflows/create-release.yaml) file, validates the release by checking if the GitHub tag already exists, if there are any old Docker images for that GitHub tag, and if merged PRs that are part of this release are labeled correctly. Additionally, it stops the release process if a feature has been added, but only the patch version number has been bumped up. 3. If you chose in step 1.vi to bump the security scanner config, the GitHub action creates a PR with a new security scanner config that includes the new GitHub tag version. 4. A code owner approves the PR. -5. The GitHub action creates a GitHub tag and draft release with the provided name; then, it creates release assets and uploads them. -6. The GitHub action asynchronously initiates unit tests and an await for Prow jobs status. -7. The tag creation triggers the `post-btp-manager-build` Prow job, defined in [`btp-manager-build.yaml`](https://github.com/kyma-project/test-infra/blob/main/prow/jobs/kyma-project/btp-manager/btp-manager-build.yaml). -8. `post-btp-manager-build` builds a Docker image tagged with the release name. -9. The GitHub action asynchronously initiates stress tests jobs and E2E tests jobs upon Prow job success status. E2E upgrade tests run only with real credentials for Service Manager. -10. The GitHub action runs E2E tests in parallel on the k3s clusters for the most recent k3s versions and with the specified credentials. The number of the most recent k3s versions to be used is defined in the **vars.LAST_K3S_VERSIONS** GitHub variable. -11. If the unit tests, stress tests, and E2E tests are completed successfully and you have chosen to publish in step 1.vii, the GitHub action publishes the release. +5. The GitHub action creates a GitHub tag and draft release with the provided name. +6. The GitHub action asynchronously initiates unit tests and Image Builder. +7. The Image Builder uploads the binary image. +8. The GitHub action asynchronously initiates stress tests jobs and E2E tests jobs upon Image Builder job success status. E2E upgrade tests run only with real credentials for Service Manager. +9. The GitHub action runs E2E tests in parallel on the k3s clusters for the most recent k3s versions and with the specified credentials. The number of the most recent k3s versions to be used is defined in the **vars.LAST_K3S_VERSIONS** GitHub variable. +10. If the unit tests, stress tests, and E2E tests are completed successfully and you have chosen to publish in step 1.vii, the GitHub action publishes the release. ### Replace an Existing Release