[main] Doc issue in file modules/ROOT/pages/update-streams.adoc

[udf2457]

Please add instructions for how to do this as part of an ignition file.

At present the docs outline the manual process to switch streams.

Clearly there could be scenarios where it would be useful to switch at deployment time via an ignition file, and it would be good to document this.

[hrismarin]

I'm not sure I can fully understand this request.

If you intend to rebase to the next stream via Ignition config, while provisioning a machine using the stable stream image, why wouldn't you just install the system using the next steam image?

[udf2457]

@hrismarin Because many cloud providers only provide the stable image as standard.

So, given the choice of:

(a) Use the cloud provider's hosted stable image
(b) Upload, pay for storage of the next image, rinse and repeat for future releases ....

I suspect most people would pick (a) and switch streams, no ?

[dustymabe]

@udf2457 I'm not sure if we should really document this case, but maybe?

Either way the process (right now) would look very similar to https://docs.fedoraproject.org/en-US/fedora-coreos/os-extensions/ except you just rpm-ostree rebase instead of rpm-ostree install

[udf2457]

Yeah, that's what I ended up doing. I was just wondering if there was a smarter way, but I guess not.

Perhaps the more useful thing to document would be to reword this note:

Switching between streams may introduce regressions or bugs due to skipping update barriers. If you experience a regression please attempt a rollback.

To perhaps highlight what what @hrismarin said above, i.e. the "preferred" way is for users to start from the desired image ? Or if not in that note, perhaps higher up the page ? At the moment grepping that page for "image" yields nothing when perhaps that option ought to be given more prominence ?

[hrismarin]

I could add a paragraph clarifying that we can initially install each stream using the corresponding image. I can also include an example Butane config for rebasing to a different stream.