The table below lists the standard tasks that must be done with each release.
The table has a task to identify the release-specific tests to be executed.
The table assumes 3 candidate releases of SIMP (Alpha, RC1 and Final ), but should be adjusted based on the bugs found during testing.
Only 2 candidate releases may be required for a SIMP patch release.
More than 3 candidate releases may be required for a SIMP major release.
Not all the tests may need to be repeated if the changes made don’t impact the test. For example, changes to simp-extras modules won’t necessarily require full regression tests to be executed, when these modules are not exercised in the regression tests.
Stories are indicated with <number> ID, whereas subtasks to a store are indicated with <parent number> - <child number>.
The Blocker field in a story is used to indicate that this story requires the listed stories to be completed before it can be done.
When Y appears in one of the release candidate or OS fields of a story, that story will be replicated for the permutation noted.
When just release candidate permutations or just OS permutations are noted, that story will be replicated for individual release candidate/OS selected.
When both release candidate and OS permutations are listed, the story will be replicated for each OS for each release candidate.
When Y appears in one of the release candidate or OS fields of a subtask, that subtask will be replicated for the permutation noted within the story.
Use the Y/N Column Pre-Automated Ticket Creation. Once tickets are done, use codes above!
Notes column does not appear on the ticket.
| Ticket Summary (< 100 chars) | Description | Component | Blockers | Story Points | Alpha (Y/N) | RC1 (Y/N) | Final (Y/N) | El6 (Y/N) | EL7 (Y/N) | EL8 (Y/N) | OEL6 (Y/N) | OEL7 (Y/N) | OEL8 (Y/N) | RH6 (Y/N) | RH7 (Y/N) | RH8 (Y/N) | Status | Notes |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | Release Components | Identify components to be released, verify tests pass, push annotated tags, update SIMP release confluence page. https://simp.readthedocs.io/en/latest/contributors_guide/maintenance/Tagging_and_Releasing_Components.html | 3 | Y | Y | Y | - | - | - | - | - | - | - | - | - | ||||
1-1 | Identify components to release | 1 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
1-2 | Release components | 2 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
2 | Update simp-core pre-release tests with release-specific changes | Update simp-core default, ipa, and install_from_tar acceptance test suites for release-specific changes. This includes updating the nodesets for the supported OSs. | 5 | Y | N | N | - | - | - | - | - | - | - | - | - | Tests will be executed for the appropriate OSs permutations in the nodeset, but separate tickets per OS should not be created. | |||
2-1 | Update tests and nodesets | 4 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
2-2 | Review updates | 1 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
3 | Update simp-packer with release-specific changes | Update simp-packer for release-specific changes | 3 | Y | N | N | - | - | - | - | - | - | - | - | - | ||||
3-1 | Update code and documentation | 2 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
3-2 | Review changes | 1 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
4 | Update simp-core with released components | Update simp-core files (Puppetfile.pinned, metadata.json, src/assets/simp/build/simp.spec) and verify ISOs can be built and default acceptance test suite passes. Pushing to GitLab will execute the | 1 | 3 | Y | Y | Y | - | - | - | - | - | - | - | - | - | |||
4-1 | Update files, build ISOs and test | 2 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
4-2 | Review updates | 1 | - | - | - | - | - | - | - | - | - | - | - | - | |||||
5 | Create ISOs, validate and publish the ISOs and tar files | 4 | Y | Y | Y | - | - | - | - | - | - | - | - | - | Only the child should be replicated for OSs for which we build an ISO | ||||
5-1 | Build ISO | - | - | - | N | Y | Y | N | N | N | N | N | N | ||||||
5-2 | Publish artifacts to simp-project.com | - | - | - | - | - | - | - | - | - | - | - | - | ||||||
6 | Validate ISO by building packer boxes | Use simp-packer to build SIMP server packer boxes. Basic bootstrap validation is done as part of the packer build. | 5 | Y | Y | Y | - | - | - | - | - | - | - | - | - | ||||
6-1 | Build packer boxes BIOS boot | Boxes to build: FIPS enabled with encrypted disk, FIPS enabled with unencrypted disk, FIPS disabled with encrypted disk, not FIPS disabled with unencrypted disk | - | - | - | N | Y | Y | N | N | N | N | N | N | |||||
6-2 | Build packer boxes UEFI boot | Boxes to build: FIPS enabled with encrypted disk, FIPS enabled with unencrypted disk, FIPS disabled with encrypted disk, not FIPS disabled with unencrypted disk | - | - | - | N | Y | Y | N | N | N | N | N | N | |||||
7 | Verify installation from RPM | Run simp-core’s install_from_tar test | 5 | Y | Y | Y | - | - | - | - | - | - | - | - | - | Only the child should be replicated for OSs for which there is a nodeset for the install_from_tar test Depending upon changes made from Alpha to RC1 and from RC1 to Final, we may not have to execute these tests with each interim release. | |||
7-1 | Execute test | See https://github.com/simp/simp-core/blob/master/spec/acceptance/suites/README.md for description of environment variables that can be set to point to the tar file | - | - | - | N | Y | Y | N | N | N | N | N | N | |||||
8 | Create upgrade instructions | Document any steps that are needed outside of the generic upgrade instructions. | 4 | 10 | N | Y | Y | N | N | N | N | N | N | First time we deliver an EL8 ISO, we will only have upgrade instructions for EL7 Manual tests for now. Will migrate to simp-integration_test for automated upgrade test. | |||||
8-1 | Manually execute upgrade with FIPS enabled | 4 | |||||||||||||||||
8-2 | Manually execute upgrade with FIPS disabled | 1 | |||||||||||||||||
8-2 | Write upgrade instructions | 4 | |||||||||||||||||
8-3 | Review instructions | Review the instructions for clarity, grammar, spelling, formatting, etc. Verification will be done in a separate ticket | 1 | ||||||||||||||||
9 | Verify upgrade instructions | Verify upgrade instructions and make any necessary adjustments to them. | 8 | ||||||||||||||||
9-1 | Execute instructions | 2 | |||||||||||||||||
9-2 | Update instructions | 1 | |||||||||||||||||
10 | Create initial SIMP changelog | 8 | Y | N | N | - | - | - | - | - | - | - | - | - | |||||
10-1 | Create changelog | 6 | |||||||||||||||||
10-2 | Review changes | 2 | |||||||||||||||||
11 | Identify release-specific tests | Based on the initial Changelog for the release, identify integration tests that must be done with a fully configured SIMP server and (if necessary) clients. These should be tests that are not adequately tested in component acceptance tests. | 10 | 5 | Y | N | N | - | - | - | - | - | - | - | - | - | |||
11-1 | Determine release-specific manual tests | 4 | |||||||||||||||||
11-2 | Create tickets for each | 1 | |||||||||||||||||
12 | Update Changelog for bug fixes | 3 | N | Y | Y | - | - | - | - | - | - | - | - | - | |||||
12-1 | Identify bug fixes and update changelog | 2 | |||||||||||||||||
12-2 | Review changes | 1 | |||||||||||||||||
13 | PXE boot UEFI | ||||||||||||||||||
14 | PXE boot BIOS | ||||||||||||||||||
15 | Verify non-standard ISO UEFI boot options | Manually verify the choose your own partitions and minimum installation ISO boot options | |||||||||||||||||
15-1 | Verify the choose your own partitions option | ||||||||||||||||||
15-2 | Verify the minimum installation option | ||||||||||||||||||
16 | Verify non-standard ISO BIOS boot options | Manually verify the ‘choose your own partitions' and ‘minimum installation’ ISO boot options | |||||||||||||||||
16-1 | Verify the choose your own partitions option | ||||||||||||||||||
16-2 | Verify the minimum installation option | ||||||||||||||||||
7 | RPMs have been uploaded to packagecloud | in simp-core run
and then do it all again with BEAKER_fips=yes |
N🚫🚫🚫🚫🚫🚫🚫🚫
Tests - Regression/Integration Testing
The tests in this section are regression tests to ensure unmodified capabilities still function. These tests should use the packer boxes created in the New/Changed Feature tests, were applicable.
Note that most of these test should eventually be automated by simp-packer, simp-integration_test, or simp-core tests so check there and remove them from these list as they are automated elsewhere. |
Ticket Summary (<100 chars) | Description | EL6 (Y/N) | EL7 (Y/N) | EL8 (Y/N) | Status | Notes | |
---|---|---|---|---|---|---|---|
1 | Verify non-standard BIOS boot options from the ISO:
| (SIMP, FIPS and Encryption are all tested by Packer.) | |||||
2 | Verify all boot Options in UEFI mode from ISO:
| ||||||
3 | PXE Boot Testing BIOS |
Open Issues Assigned to Release
Change the query in the table below to set fixVersion to