e809d43103e21617c90aa851c6b0abe87f0fcc67
[docs.git] / docs / release-process / release-schedule.rst
1 ================
2 Release Schedule
3 ================
4
5 OpenDaylight releases twice per year. The six-month cadence is designed to
6 synchronize OpenDaylight releases with OpenStack and OPNFV releases. Dates
7 are adjusted to match current resources and requirements from the current
8 OpenDaylight users. Dates are also adjusted when they conflict with holidays,
9 overlap with other releases or are otherwise problematic.
10 Dates are the release deadlines intended for managed projects.
11 Self-managed projects that wants to integrate the distribution have one week
12 to release once managed projects are ready.
13
14 Each milestone is usually evaluated at a TSC meeting, which dictates deadlines.
15 Nominal deadline is midnight UTC on the particular date. As an example, a date
16 of 2022-10-06 means that all deliverables are due no later than
17 2022-10-06T00:00:00Z. The corresponding TSC meeting happens either on
18 9am or 10pm Pacific time. The slack time between the deadline and the actual call
19 can be used for justified last-minute work if the need arises (though in general
20 WE SHOULD NEVER need it). If such last-minute work results in a SimRel candidate
21 build not being available, the reasons for that need to be discussed at,
22 and documented as part of, the corresponding TSC meeting.
23
24 .. list-table::
25    :widths: 20 20 20 20 20 20 40
26    :header-rows: 1
27    :stub-columns: 1
28
29    * - **Event**
30      - **2024.03 Argon Dates**
31      - **2024.03 Calcium Dates**
32      - **2023.09 Potassium Dates**
33      - **Relative Dates**
34      - **Start-Relative Dates**
35      - **Description**
36
37    * - Release Start
38      - 2024-03-14
39      - 2023-09-14
40      - 2023-03-16
41      - Start Date
42      - Start Date +0
43      - Declare Intention: Submit **Project_Plan** Jira item in TSC project.
44    * - Initial Checkpoint
45      - 2024-03-28
46      - 2023-10-05
47      - 2023-03-30
48      - Start Date +2 weeks
49      - Start Date +2 weeks
50      - Initial Checkpoint. All Managed Projects must have completed
51        **Project_Plan** Jira items in TSC project.
52    * - Release Integrated Deadline
53      - 2024-04-16
54      - 2023-10-19
55      - 2023-04-20
56      - Initial Checkpoint + 2 weeks
57      - Start Date +4 weeks
58      - Deadline for Release Integrated Projects (currently, ODLPARENT,
59        YANGTOOLS, MDSAL, CONTROLLER and INFRAUTILS) to provide the desired
60        version deliverables for downstream Snapshot Integrated Projects to
61        consume.
62    * - Version Bump
63      - 2024-04-19
64      - 2023-10-20
65      - 2023-04-21
66      - Release Integrated Deadline + 1 day
67      - Start Date +4 weeks 1 day
68      - Prepare version bump patches and merge them in (RelEng team). Spend the
69        next 2 weeks to get green build for all MSI Projects and a healthy
70        distribution.
71    * - Version Bump Checkpoint
72      - 2024-04-25
73      - 2023-11-02
74      - 2023-04-27
75      - Release Integrated Deadline + 2 weeks
76      - Start Date +6 weeks
77      - Check status of MSI Projects to see if we have green builds and a
78        healthy distribution. Revert the MRI deliverables if deemed necessary.
79    * - CSIT Checkpoint
80      - 2024-05-09
81      - 2023-11-16
82      - 2023-05-11
83      - Version Bump Checkpoint + 2 weeks
84      - Start Date +8 weeks
85      - All Managed Release CSIT should be in good shape - get all MSI Projects'
86        CSIT results as they were before the version bump. This is the final
87        opportunity to revert the MRI deliverables if deemed necessary.
88    * - Middle Checkpoint
89      - 2024-07-04
90      - 2024-01-11
91      - 2023-07-06
92      - CSIT Checkpoint + 8 weeks (sometimes +2 weeks to avoid December holidays)
93      - Start Date +16 weeks (sometimes +2 weeks to avoid December holidays)
94      - Checkpoint for status of Managed Projects - especially Snapshot
95        Integrated Projects.
96    * - Code Freeze
97      - 2024-08-01
98      - 2024-02-08
99      - 2023-08-03
100      - Middle Checkpoint + 4 weeks
101      - Start Date +20 weeks
102      - Code freeze for all Managed Projects - cut and lock release branch. Only
103        allow blocker bug fixes in release branch.
104    * - Final Checkpoint
105      - 2024-08-15
106      - 2024-02-22
107      - 2023-08-17
108      - Code Freeze + 2 weeks
109      - Start Date +22 weeks
110      - Final Checkpoint for all Managed Projects.
111    * - Formal Release
112      - 2024-09-19
113      - 2024-03-14
114      - 2023-09-21
115      - 6 months after Start Date
116      - Start Date +6 months
117      - Formal Release for Managed Projects. Self-managed projects usually are released a week later.
118    * - Service Release 1
119      - 2024-10-24
120      - 2024-04-25
121      - 2023-10-26
122      - 1.5 month after Formal Release
123      - Start Date +7.5 months
124      - Service Release 1 (SR1)
125    * - Service Release 2
126      - 2025-01-23
127      - 2024-07-25
128      - 2024-01-25
129      - 3 months after SR1
130      - Start Date +10.5 months
131      - Service Release 2 (SR2)
132    * - Service Release 3
133      - 2025-05-08
134      - 2024-10-24
135      - 2024-05-09
136      - 4 months after SR2
137      - Start Date +14 months
138      - Service Release 3 (SR3)
139    * - Service Release 4 (optional, based on documented need)
140      - N/A
141      - N/A
142      - N/A
143      - Not Applicable
144      - Not Applicable
145      - Service Release 4 (SR4) - Final Service Release
146    * - Release End of Life
147      - 2025-09-18
148      - 2025-03-25
149      - 2024-09-19
150      - 4 months after SR3
151      - Start Date +18 months
152      - End of Life - coincides with the Formal Release of the current release+2
153        versions and the start of the current release+3 versions.