-
Notifications
You must be signed in to change notification settings - Fork 532
os: add user-docs on how to use custom torcx remotes and images #1261
base: master
Are you sure you want to change the base?
Conversation
b7b661f
to
1c6fce4
Compare
This adds a walk-through and CLC snippets on how to configure custom remotes and use addons from there.
1c6fce4
to
67850ac
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM aside from one tiny grammer nit.
|
||
If it is not possible to provision any of the configured addons for the upcoming OS, the update will not applied and the process will be re-tried later. | ||
|
||
This can happen if an addon is not anymore present on a remote, if the image matching the new OS version is not yet available, or in case of any other error when fetching from a remote. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
addon is not present anymore on a remote
|
||
## Remotes Overview | ||
|
||
A Torcx [remote][torcx-remotes-design] is a collection of addon images for torcx, served from a remote source, which can be fetched by a node for use by [torcx-generator][torcx-overview]. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Might make sense to add a the
in fetched by a node for us by _the_ [torcx generator]
## Remotes Overview | ||
|
||
A Torcx [remote][torcx-remotes-design] is a collection of addon images for torcx, served from a remote source, which can be fetched by a node for use by [torcx-generator][torcx-overview]. | ||
Images for configured addons can be retrieved automatically on first-boot provisioning (i.e. in initramfs) and when preparing for new OS updates (i.e. before marking a node as "reboot needed"). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can new remotes be added outside of first-boot/updates? If not then the can be
in configured addons can be
should probably be replaced with are
This adds a walk-through and CLC snippets on how to configure custom
remotes and use addons from there.