Table of Contents
Release Notes for SIMP
Change Link to the appropriate page
How to use this page
Go to the row of your module
If the "proposed version" is green, then it has been released and tagged
If the "proposed version" is blue, verify that the tests have all passed, bold the text
If the "proposed version" is bold, tag and release the component, and color the column green
Component Selection
BLUE | New version since last SIMP release |
YELLOW | New component since last SIMP release |
GRAY | Omitted component |
WHITE | Same version as last SIMP release |
RED | TBD: Outstanding problem |
BOLD | Ready to release |
BOLD ITALICS | Tag published but not verified as released |
GREEN | New version tagged, Forge released, RPM released |
Component | Proposed Version | Version in <Last SIMP Release> | Unit Test Status | Acceptance Test Status | GitHub Released | Forge Released | RPM Released | Changelog |
---|---|---|---|---|---|---|---|---|
component-name | 1.2.3 | 1.2.2 | PASSED <Link to Travis CI> | PASSED <Link to GitLab CI> | Y (or N) | N (Could be Y or N/A) | Y (or N) | <links if appropriate> |
Release Testing Procedure
The full release testing procedure is documented in the Official SIMP Docs.
Puppet Versions Testing
Puppet version for GitLab and TravisCI
Puppet modules will be tested in GitLab and TravisCI with the following versions:
Puppet version for simp-core (integration) and SIMP ISO testing
Release | Puppet | Ruby | Notes |
---|---|---|---|
SIMP | Version to be included in SIMP ISOs |
Release | Puppet | Ruby | Notes |
---|---|---|---|
PE 2017.2 | 4.10.* | 2.1.9 | SIMP 6.1.0, SIMP 6.2.0 also tested on this version
|
PE 2018.1.4 | 5.5.6 | 2.4.4 | |
Version to be included in SIMP ISOs |
OS Versions For Testing
SIMP acceptance tests will be executed with the following OS versions:
CentOS 7.5
CentOS 6.10
RedHat 7.5
RedHat 6.10
OracleLinux 7.5
OracleLinux 6.10
SIMP ISOs for CentOS 7.5 and CentOS 6.10 will be built and tested.
If licenses are available, SIMP ISOs for RedHat 7.5 and RedHat 6.10 will be built and tested.
Tests - New/Changed Features
The tests in this section focus on new features or major, SIMP-wide changes.
Legend:
💡 - Means this version needs to be tested
🚫 - This version does not need to be tested.
? - Testing probably sufficient from other versions.
❌ - Testing has failed.
✅ - Testing completed and Passed.
blank - This test is not OS specific
green | these test are automated |
---|
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 box | - | - | - | 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 | |||||||||||||||||
9 | Update Changelog for bug fixes | 3 | N | Y | Y | - | - | - | - | - | - | - | - | - | |||||
9-1 | Identify bug fixes and update changelog | 2 | |||||||||||||||||
9-2 | Review changes | 1 | |||||||||||||||||
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