1
1
# Migrating From Releases
2
2
3
- The Cohorts workflow for rolling out OTA updates to devices are a direct
3
+ The Cohorts workflow for rolling out OTA updates to devices is a direct
4
4
replacement of the old Releases workflow. Releases are already disabled for all
5
5
new projects, and will be disabled for all existing projects at a later stage.
6
6
@@ -10,7 +10,7 @@ we recommend transitioning to Cohorts as soon as possible.
10
10
## Differences between Releases and Cohorts
11
11
12
12
Cohorts bring two fundamental upgrades to the way OTA Updates are distributed
13
- from your devices. The most important change is that you now have to explicitly
13
+ to your devices. The most important change is that you now have to explicitly
14
14
add a device to a Cohort, instead of relying on the blueprint and tags matching
15
15
mechanism in Releases and Artifacts. The second fundamental change is the way
16
16
each update is rolled out — with Releases, each Release could be enabled and
@@ -58,7 +58,7 @@ are a couple of smaller differences between Releases and Cohorts:
58
58
59
59
- ** Adding a device to a Cohort will push a manifest update to the device right
60
60
away.** With Releases, devices would only receive an update notification when
61
- you rolled out a Release, but could still pull for the active Release between
61
+ you rolled out a Release, but could still poll for the active Release between
62
62
roll outs. With Cohorts, the active Deployment is always issued to every
63
63
device in the Cohort as soon as possible.
64
64
- ** Artifact blueprints are no longer considered.** If a Deployment contains an
@@ -85,7 +85,7 @@ anything in your firmware.
85
85
## Moving devices to Cohorts
86
86
87
87
As a device has to be part of a Cohort to receive Deployments, you can opt into
88
- the new workflow on a device-to- device basis.
88
+ the new workflow on a per device basis.
89
89
90
90
To make sure your migration from Releases to Cohorts doesn't trigger any
91
91
accidental OTA updates, we recommend testing the new concept by moving a test
@@ -124,8 +124,8 @@ workflow for some time. To move a device back to using Releases, you can remove
124
124
it from the Cohort. This causes the device to receive OTA updates using the old
125
125
Releases workflow, as if it never belonged to a Cohort. Note that moving the
126
126
device out of a Cohort does not trigger an OTA manifest update on the device,
127
- even if it starts being affected by a Release . However, the next time the device
128
- reads the OTA manifest, the Golioth Cloud will respond with whatever release
127
+ even if there is an active Release that targets it . However, the next time the device
128
+ fetches the OTA manifest, the Golioth Cloud will respond with whatever release
129
129
manifest the device should receive through the Releases workflow.
130
130
131
131
## Disabling the Releases workflow for your project
0 commit comments