You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/cloud-services/cloud-services-guestos-update-matrix.md
+86-86Lines changed: 86 additions & 86 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,12 +7,12 @@ author: jejackson
7
7
ms.assetid: 6306cafe-1153-44c7-8554-623b03d59a34
8
8
ms.service: cloud-services
9
9
ms.topic: article
10
-
ms.date: 06/28/2024
10
+
ms.date: 07/23/2024
11
11
ms.author: jejackson
12
12
ms.custom: compute-evergreen
13
13
---
14
14
# Azure Guest OS releases and SDK compatibility matrix
15
-
Provides you with up-to-date information about the latest Azure Guest OS releases for Cloud Services. This information helps you plan your upgrade path before a Guest OS is disabled. If you configure your roles to use *automatic* Guest OS updates as described in [Azure Guest OS Update Settings][Azure Guest OS Update Settings], it is not vital that you read this page.
15
+
Provides you with up-to-date information about the latest Azure Guest OS releases for Cloud Services. This information helps you plan your upgrade path before a Guest OS is disabled. If you configure your roles to use *automatic* Guest OS updates as described in [Azure Guest OS Update Settings][Azure Guest OS Update Settings], it isn't vital that you read this page.
16
16
17
17
> [!IMPORTANT]
18
18
> This page applies to Cloud Services web and worker roles, which run on top of a Guest OS. It does **not apply** to IaaS Virtual Machines.
@@ -35,217 +35,217 @@ Unsure about how to update your Guest OS? Check [this][cloud updates] out.
35
35
## News updates
36
36
37
37
###### **June 27, 2024**
38
-
The June Guest OS has released.
38
+
The June Guest OS released.
39
39
40
40
###### **June 1, 2024**
41
-
The May Guest OS has released.
41
+
The May Guest OS released.
42
42
43
43
###### **April 19, 2024**
44
-
The April Guest OS has released.
44
+
The April Guest OS released.
45
45
46
46
###### **April 9, 2024**
47
-
The March Guest OS has released.
47
+
The March Guest OS released.
48
48
49
49
###### **February 24, 2024**
50
-
The February Guest OS has released.
50
+
The February Guest OS released.
51
51
52
52
###### **January 22, 2024**
53
-
The January Guest OS has released.
53
+
The January Guest OS released.
54
54
55
55
###### **January 16, 2023**
56
-
The December Guest OS has released.
56
+
The December Guest OS released.
57
57
58
58
###### **December 8, 2023**
59
-
The November Guest OS has released.
59
+
The November Guest OS released.
60
60
61
61
###### **October 23, 2023**
62
-
The October Guest OS has released.
62
+
The October Guest OS released.
63
63
64
64
###### **September 26, 2023**
65
-
The September Guest OS has released.
65
+
The September Guest OS released.
66
66
67
67
###### **August 21, 2023**
68
-
The August Guest OS has released.
68
+
The August Guest OS released.
69
69
70
70
###### **July 27, 2023**
71
-
The July Guest OS has released.
71
+
The July Guest OS released.
72
72
73
73
###### **July 8, 2023**
74
-
The June Guest OS has released.
74
+
The June Guest OS released.
75
75
76
76
###### **May 19, 2023**
77
-
The May Guest OS has released.
77
+
The May Guest OS released.
78
78
79
79
###### **April 27, 2023**
80
-
The April Guest OS has released.
80
+
The April Guest OS released.
81
81
82
82
###### **March 28, 2023**
83
-
The March Guest OS has released.
83
+
The March Guest OS released.
84
84
85
85
###### **March 1, 2023**
86
-
The February Guest OS has released.
86
+
The February Guest OS released.
87
87
88
88
###### **January 31, 2023**
89
-
The January Guest OS has released.
89
+
The January Guest OS released.
90
90
91
91
###### **January 19, 2023**
92
-
The December Guest OS has released.
92
+
The December Guest OS released.
93
93
94
94
###### **December 12, 2022**
95
-
The November Guest OS has released.
95
+
The November Guest OS released.
96
96
97
97
###### **November 4, 2022**
98
-
The October Guest OS has released.
98
+
The October Guest OS released.
99
99
100
100
###### **September 29, 2022**
101
-
The September Guest OS has released.
101
+
The September Guest OS released.
102
102
103
103
###### **September 2, 2022**
104
-
The August Guest OS has released.
104
+
The August Guest OS released.
105
105
106
106
###### **August 3, 2022**
107
-
The July Guest OS has released.
107
+
The July Guest OS released.
108
108
109
109
###### **July 11, 2022**
110
-
The June Guest OS has released.
110
+
The June Guest OS released.
111
111
112
112
###### **May 26, 2022**
113
-
The May Guest OS has released.
113
+
The May Guest OS released.
114
114
115
115
###### **April 30, 2022**
116
-
The April Guest OS has released.
116
+
The April Guest OS released.
117
117
118
118
###### **March 19, 2022**
119
-
The March Guest OS has released.
119
+
The March Guest OS released.
120
120
121
121
###### **March 2, 2022**
122
-
The February Guest OS has released.
122
+
The February Guest OS released.
123
123
124
124
###### **February 11, 2022**
125
-
The January Guest OS has released.
125
+
The January Guest OS released.
126
126
127
127
###### **January 10, 2022**
128
-
The December Guest OS has released.
128
+
The December Guest OS released.
129
129
130
130
###### **November 19, 2021**
131
-
The November Guest OS has released.
131
+
The November Guest OS released.
132
132
133
133
###### **November 1, 2021**
134
-
The October Guest OS has released.
134
+
The October Guest OS released.
135
135
136
136
###### **October 8, 2021**
137
-
The September Guest OS has released.
137
+
The September Guest OS released.
138
138
139
139
###### **August 27, 2021**
140
-
The August Guest OS has released.
140
+
The August Guest OS released.
141
141
142
142
###### **August 13, 2021**
143
-
The July Guest OS has released.
143
+
The July Guest OS released.
144
144
145
145
###### **July 1, 2021**
146
-
The June Guest OS has released.
146
+
The June Guest OS released.
147
147
148
148
###### **May 26, 2021**
149
-
The May Guest OS has released.
149
+
The May Guest OS released.
150
150
151
151
###### **April 30, 2021**
152
-
The April Guest OS has released.
152
+
The April Guest OS released.
153
153
154
154
###### **March 28, 2021**
155
-
The March Guest OS has released.
155
+
The March Guest OS released.
156
156
157
157
###### **February 19, 2021**
158
-
The February Guest OS has released.
158
+
The February Guest OS released.
159
159
160
160
###### **February 5, 2021**
161
-
The January Guest OS has released.
161
+
The January Guest OS released.
162
162
163
163
###### **January 15, 2021**
164
-
The December Guest OS has released.
164
+
The December Guest OS released.
165
165
166
166
###### **December 19, 2020**
167
-
The November Guest OS has released.
167
+
The November Guest OS released.
168
168
169
169
###### **November 17, 2020**
170
-
The October Guest OS has released.
170
+
The October Guest OS released.
171
171
172
172
###### **October 10, 2020**
173
-
The September Guest OS has released.
173
+
The September Guest OS released.
174
174
175
175
###### **September 5, 2020**
176
-
The August Guest OS has released.
176
+
The August Guest OS released.
177
177
178
178
###### **August 17, 2020**
179
-
The July Guest OS has released.
179
+
The July Guest OS released.
180
180
181
181
###### **August 10, 2020**
182
-
The June Guest OS has released.
182
+
The June Guest OS released.
183
183
184
184
###### **June 2, 2020**
185
-
The May Guest OS has released.
185
+
The May Guest OS released.
186
186
187
187
###### **May 4, 2020**
188
-
The April Guest OS has released.
188
+
The April Guest OS released.
189
189
190
190
###### **April 2, 2020**
191
-
The March Guest OS has released.
191
+
The March Guest OS released.
192
192
193
193
###### **March 5, 2020**
194
-
The February Guest OS has released.
194
+
The February Guest OS released.
195
195
196
196
###### **January 24, 2020**
197
-
The January Guest OS has released.
197
+
The January Guest OS released.
198
198
199
199
###### **January 8, 2020**
200
-
The December Guest OS has released.
200
+
The December Guest OS released.
201
201
202
202
###### **December 5, 2019**
203
-
The November Guest OS has released.
203
+
The November Guest OS released.
204
204
205
205
###### **November 1, 2019**
206
-
The October Guest OS has released.
206
+
The October Guest OS released.
207
207
208
208
###### **October 7, 2019**
209
-
The September Guest OS has released.
209
+
The September Guest OS released.
210
210
211
211
###### **September 4, 2019**
212
-
The August Guest OS has released.
212
+
The August Guest OS released.
213
213
214
214
###### **July 26, 2019**
215
-
The July Guest OS has released.
215
+
The July Guest OS released.
216
216
217
217
###### **July 8, 2019**
218
-
The June Guest OS has released.
218
+
The June Guest OS released.
219
219
220
220
###### **June 6, 2019**
221
-
The May Guest OS has released.
221
+
The May Guest OS released.
222
222
223
223
###### **May 7, 2019**
224
-
The April Guest OS has released.
224
+
The April Guest OS released.
225
225
226
226
###### **March 26, 2019**
227
-
The March Guest OS has released.
227
+
The March Guest OS released.
228
228
229
229
###### **March 12, 2019**
230
-
The February Guest OS has released.
230
+
The February Guest OS released.
231
231
232
232
###### **February 5, 2019**
233
-
The January Guest OS has released.
233
+
The January Guest OS released.
234
234
235
235
###### **January 24, 2019**
236
-
Family 6 Guest OS (Windows Server 2019) has released.
236
+
Family 6 Guest OS (Windows Server 2019) released.
237
237
238
238
###### **January 7, 2019**
239
-
The December Guest OS has released.
239
+
The December Guest OS released.
240
240
241
241
###### **December 14, 2018**
242
-
The November Guest OS has released.
242
+
The November Guest OS released.
243
243
244
244
###### **November 8, 2018**
245
-
The October Guest OS has released.
245
+
The October Guest OS released.
246
246
247
247
###### **October 12, 2018**
248
-
The September Guest OS has released.
248
+
The September Guest OS released.
249
249
250
250
## Releases
251
251
@@ -491,8 +491,8 @@ The September Guest OS has released.
491
491
|~~WA-GUEST-OS-4.102_202204-01~~| April 30, 2022 | July 11, 2022 |
492
492
|~~WA-GUEST-OS-4.101_202203-01~~| March 19, 2022 | May 26, 2022 |
493
493
|~~WA-GUEST-OS-4.100_202202-01~~| March 2, 2022 | April 30, 2022 |
494
-
|~~WA-GUEST-OS-4.99_202201-02~~| February 11, 2022 | March 19, 2022 |
495
-
|~~WA-GUEST-OS-4.97_202112-01~~| January 10, 2022 | March 2, 2022 |
494
+
|~~WA-GUEST-OS-4.99_202201-02~~| February 11, 2022 | March 19, 2022 |
495
+
|~~WA-GUEST-OS-4.97_202112-01~~| January 10, 2022 | March 2, 2022 |
496
496
|~~WA-GUEST-OS-4.96_202111-01~~| November 19, 2021 | February 11, 2022 |
497
497
|~~WA-GUEST-OS-4.95_202110-01~~| November 1, 2021 | January 10, 2022 |
498
498
|~~WA-GUEST-OS-4.94_202109-01~~| October 8, 2021 | November 19, 2021 |
@@ -705,11 +705,11 @@ Even though the [retirement policy for the Azure SDK][retire policy sdk] indicat
705
705
| 1 |Version 1.0+ |
706
706
707
707
## Guest OS release information
708
-
There are three dates that are important to Guest OS releases: **release** date, **disabled** date, and **expiration** date. A Guest OS is considered available when it is in the Portal and can be selected as the target Guest OS. When a Guest OS reaches the **disabled** date, it is removed from Azure. However, any Cloud Service targeting that Guest OS will still operate as normal.
708
+
There are three dates that are important to Guest OS releases: **release** date, **disabled** date, and **expiration** date. A Guest OS is considered available when it is in the Portal and can be selected as the target Guest OS. When a Guest OS reaches the **disabled** date, Microsoft removes it from Azure. However, any Cloud Service targeting that Guest OS still operate as normal.
709
709
710
-
The window between the **disabled** date and the **expiration** date provides you with a buffer to easily transition from one Guest OS to one newer. If you're using *automatic* as your Guest OS, you'll always be on the latest version and you don't have to worry about it expiring.
710
+
The window between the **disabled** date and the **expiration** date provides you with a buffer to easily transition from one Guest OS to one newer. If you're using *automatic* as your Guest OS, you're always on the latest version and you don't have to worry about it expiring.
711
711
712
-
When the **expiration** date passes, any Cloud Service still using that Guest OS will be stopped, deleted, or forced to upgrade. You can read more about the retirement policy [here][retirepolicy].
712
+
When the **expiration** date passes, any Cloud Service still using that Guest OS stops, deletes, or force upgrades. You can read more about the retirement policy [here][retirepolicy].
713
713
714
714
## Guest OS family-version explanation
715
715
The Guest OS families are based on released versions of Microsoft Windows Server. The Guest OS is the underlying operating system that Azure Cloud Services runs on. Each Guest OS has a family, version, and release number.
@@ -721,26 +721,26 @@ The Guest OS families are based on released versions of Microsoft Windows Server
721
721
722
722
Numbers start at 0 and increment by 1 each time a new set of updates is added. Trailing zeros are only shown if important. That is, version 2.10 is a different, much later version than version 2.1.
723
723
***Guest OS release**
724
-
A rerelease of a Guest OS version. A rerelease occurs if Microsoft finds issues during testing; requiring changes. The latest release always supersedes any previous releases, public or not. The Azure portal will only allow users to pick the latest release for a given version. Deployments running on a previous release are usually not force upgraded depending on the severity of the bug.
724
+
A rerelease of a Guest OS version. A rerelease occurs if Microsoft finds issues during testing; requiring changes. The latest release always supersedes any previous releases, public or not. The Azure portal only allows users to pick the latest release for a given version. Deployments running on a previous release aren't force upgraded depending on the severity of the bug.
725
725
726
-
In the example below, 2 is the family, 12 is the version and "rel2" is the release.
726
+
In the following example, 2 is the family, 12 is the version, and "rel2" is the release.
727
727
728
728
**Guest OS release** - 2.12 rel2
729
729
730
730
**Configuration string for this release** - WA-GUEST-OS-2.12_201208-02
731
731
732
-
The configuration string for a Guest OS has this same information embedded in it, along with a date showing which MSRC patches were considered for that release. In this example, MSRC patches produced for Windows Server 2008 R2 up to and including August 2012 were considered for inclusion. Only patches specifically applying to that version of Windows Server are included. For example, if an MSRC patch applies to Microsoft Office, it will not be included because that product is not part of the Windows Server base image.
732
+
The configuration string for a Guest OS has this same information embedded in it, along with a date showing which MSRC patches were considered for that release. In this example, MSRC patches produced for Windows Server 2008 R2 up to and including August 2012 were considered for inclusion. Only patches specifically applying to that version of Windows Server are included. For example, if an MSRC patch applies to Microsoft Office, it isn't included because that product isn't part of the Windows Server base image.
733
733
734
734
## Guest OS system update process
735
-
This page includes information on upcoming Guest OS Releases. Customers have indicated that they want to know when a release occurs because their cloud service roles will reboot if they are set to "Automatic" update. Guest OS releases typically occur 2-3 weeks after the MSRC update release that occurs on the second Tuesday of every month. New releases include all the relevant MSRC patches for each Guest OS family.
735
+
This page includes information on upcoming Guest OS Releases. Some customers want to know when a release occurs because cloud service roles set to automatically update reboot on releases. Guest OS releases typically occur 2-3 weeks after the MSRC update release that occurs on the second Tuesday of every month. New releases include all the relevant MSRC patches for each Guest OS family.
736
736
737
-
Microsoft Azure is constantly releasing updates. The Guest OS is only one such update in the pipeline. A release can be affected by many factors too numerous to list here. In addition, Azure runs on literally hundreds of thousands of machines. This means that it's impossible to give an exact date and time when your role(s) will reboot. We are working on a plan to limit or time reboots.
737
+
Microsoft Azure is constantly releasing updates. The Guest OS is only one such update in the pipeline. Many factors affect a release, and they're too numerous to list here. In addition, Azure runs on literally hundreds of thousands of machines. This means that it's impossible to give an exact date and time to expect your role or roles to reboot. We're working on a plan to limit or time reboots.
738
738
739
-
When a new release of the Guest OS is published, it can take time to fully propagate across Azure. As services are updated to the new Guest OS, they are rebooted honoring update domains. Services set to use "Automatic" updates will get a release first. After the update, you’ll see the new Guest OS version listed for your service in the Azure portal. Rereleases may occur during this period. Some versions may be deployed over longer periods of time and automatic upgrade reboots may not occur for many weeks after the official release date. Once a Guest OS is available, you can then explicitly choose that version from the portal or in your configuration file.
739
+
When a new release of the Guest OS is published, it can take time to fully propagate across Azure. As services are updated to the new Guest OS, they reboot, honoring update domains. Services set to use "Automatic" updates get a release first. After the update, you’ll see the new Guest OS version listed for your service in the Azure portal. Rereleases may occur during this period. Some versions may be deployed over longer periods of time and automatic upgrade reboots may not occur for many weeks after the official release date. Once a Guest OS is available, you can then explicitly choose that version from the portal or in your configuration file.
740
740
741
-
For a great deal of valuable information on restarts and pointers to more information technical details of Guest and Host OS updates, see the MSDN blog post titled [Role Instance Restarts Due to OS Upgrades][restarts].
741
+
For a great deal of valuable information on restarts and pointers to more information on Guest and Host OS updates, see the Microsoft Developer Network (MSDN) blog post titled [Role Instance Restarts Due to OS Upgrades][restarts].
742
742
743
-
If you manually update your Guest OS, see the [Guest OS retirement policy][retirepolicy] for additional information.
743
+
For more information about manually updating your Guest OS, see the [Guest OS retirement policy][retirepolicy].
744
744
745
745
## Guest OS supportability and retirement policy
746
746
The Guest OS supportability and retirement policy is explained [here][retirepolicy].
0 commit comments